Création d'un outil d'appel de fonction personnalisé dans les agents d'IA générative

Dans les agents d'IA générative, chaque agent doit avoir un ou plusieurs outils. Vous pouvez créer l'outil d'un agent pendant ou après sa création. Pour les deux options, la création d'un outil a les mêmes étapes. Cette section présente les étapes de création d'un outil d'appel de fonction.

Navigation vers les outils

Si vous êtes en train de créer un agent, ignorez cette section. La présente section décrit les étapes à suivre pour accéder à la page de détails d'un agent dans laquelle les outils sont répertoriés.

Dans la page de liste Agents, sélectionnez l'agent auquel vous voulez ajouter un outil.
Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des agents.
Sous Ressources, sélectionnez Outils.

Créer un outil d'appel de fonction

Sélectionnez Créer un outil.
Sélectionnez Outil personnalisé.
(Facultatif) Entrez les informations suivantes :
- Nom : Nom de l'outil personnalisé qui commence par une lettre ou un trait de soulignement, suivi de lettres, de chiffres, de tirets ou de traits de soulignement. La longueur peut être comprise entre 1 et 255 caractères.
- Description : Description facultative.
Sous Configuration de l'outil, sélectionnez Appel de fonction
Entrez les informations suivantes :
- Nom : Nom de la fonction qui commence par une lettre ou un trait de soulignement, suivi de lettres, de chiffres, de tirets ou de traits de soulignement. La longueur peut être comprise entre 1 et 255 caractères.
- Description : Description facultative.

Pour les paramètres de fonction, entrez les paramètres acceptés par la fonction dans un format JSON.

Voici quelques exemples :

// Get Compute Instance Details
{
            "name": "get_compute_instance_details",
            "description": "Fetch details of an OCI Compute instance given an instance OCID.",
            "parameters": {
                "type": "object",
                "properties": {
                    "instance_ocid": {
                        "type": "string",
                        "description": "The OCID of the compute instance."
                    },
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment containing the instance."
                    }
                },
                "required": ["instance_ocid"],
                "additionalProperties": false
            }
        }


// Create an Object Storage Bucket
{
            "name": "create_object_storage_bucket",
            "description": "Creates a new bucket in OCI Object Storage within a specified compartment.",
            "parameters": {
                "type": "object",
                "properties": {
                    "bucket_name": {
                        "type": "string",
                        "description": "The name of the bucket to create."
                    },
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment where the bucket will be created."
                    },
                    "storage_tier": {
                        "type": "string",
                        "enum": ["Standard", "Archive"],
                        "description": "The storage tier for the bucket."
                    }
                },
                "required": ["bucket_name", "compartment_ocid"],
                "additionalProperties": false
            }
        }


// Check Database Service Status
{
            "name": "check_database_status",
            "description": "Checks the operational status of an OCI Autonomous Database instance.",
            "parameters": {
                "type": "object",
                "properties": {
                    "db_ocid": {
                        "type": "string",
                        "description": "The OCID of the database instance."
                    }
                },
                "required": ["db_ocid"],
                "additionalProperties": false
            }
        }

// List Available Load Balancers
{
            "name": "list_load_balancers",
            "description": "Lists all load balancers in the given compartment in OCI.",
            "parameters": {
                "type": "object",
                "properties": {
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment containing the load balancers."
                    }
                },
                "required": ["compartment_ocid"],
                "additionalProperties": false
            }
        }

Sélectionnez Créer un outil.
Consultez les étapes sous Configuration d'une fonction à l'aide de la trousse SDK Java.

Conseil

Effectuez une des actions suivantes :

Si vous créez un agent, retournez à Création d'un agent dans des agents d'IA générative pour créer un autre outil ou un point d'extrémité.
Si vous avez ajouté l'outil à un agent existant, une fois l'outil actif, dans la page de détails de l'agent, sélectionnez Lancer le clavardage pour clavarder avec l'agent à l'aide de cet outil.
Si vous avez créé l'agent sans point d'extrémité, lorsque vous êtes prêt à l'utiliser, créez un point d'extrémité pour cet agent.

Documentation sur Oracle Cloud Infrastructure

Création d'un outil d'appel de fonction personnalisé dans les agents d'IA générative

Navigation vers les outils

Créer un outil d'appel de fonction