Documentation Oracle Cloud Infrastructure

Création d'un outil d'appel de fonction personnalisé dans des agents Generative AI

Dans les agents d'IA générative, chaque agent doit disposer d'un ou de 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.

Créer un outil d'appel de fonction

  1. Sélectionnez Créer un outil.
  2. Sélectionnez Outil personnalisé.
  3. (Facultatif) Entrez les informations suivantes :
    • Nom : nom de l'outil personnalisé qui commence par une lettre ou un trait de soulignement, suivi de lettres, chiffres, tirets ou traits de soulignement. La longueur peut être comprise entre 1 et 255 caractères.
    • Description : description facultative.
  4. Sous Configuration de l'outil, sélectionnez Appel de fonction.
  5. 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 traits d'union ou de traits de soulignement. La longueur peut être comprise entre 1 et 255 caractères.
    • Description : description facultative.
  6. Pour les paramètres de fonction, entrez les paramètres que la fonction accepte au 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
            }
        }
  7. Sélectionnez Créer un outil.
  8. Passez en revue les étapes de Configuration d'une fonction à l'aide du kit SDK Java.
Conseil

Effectuez l'une des actions suivantes :

  • Si vous créez un agent, revenez à Création d'un agent dans des agents Generative AI pour créer un autre outil ou une adresse.
  • Si vous avez ajouté l'outil à un agent existant, une fois l'outil actif, sur la page de détails de l'agent, sélectionnez Lancer la discussion pour discuter avec l'agent à l'aide de cet outil.
  • Si vous avez créé l'agent sans adresse, lorsque vous êtes prêt à l'utiliser, créez une adresse pour cet agent.