Documentazione dell'infrastruttura Oracle Cloud

Creazione di uno strumento di chiamata di funzioni personalizzato negli agenti AI generativi

Negli agenti di intelligenza artificiale generativa, ogni agente deve disporre di uno o più strumenti. È possibile creare lo strumento di un agente durante o dopo la creazione dell'agente. Per entrambe le opzioni, la creazione di uno strumento ha gli stessi passi. In questa sezione vengono illustrati i passi per creare uno strumento di chiamata funzione.

Creazione di uno strumento chiamata funzione

  1. Selezionare Crea strumento.
  2. Selezionare Strumento personalizzato.
  3. (Facoltativo) Immettere le informazioni riportate di seguito.
    • Nome: nome dello strumento personalizzato che inizia con una lettera o un carattere di sottolineatura, seguito da lettere, numeri, trattini o caratteri di sottolineatura. La lunghezza può essere compresa tra 1 e 255 caratteri.
    • Descrizione: una descrizione facoltativa.
  4. In Configurazione strumento, selezionare Chiamata funzione.
  5. Immettere le informazioni riportate di seguito.
    • Nome: nome della funzione che inizia con una lettera o un carattere di sottolineatura, seguito da lettere, numeri, trattini o caratteri di sottolineatura. La lunghezza può essere compresa tra 1 e 255 caratteri.
    • Descrizione: una descrizione facoltativa.
  6. Per i parametri funzione, immettere i parametri accettati dalla funzione in formato JSON.
    Di seguito ne vengono riportati alcuni esempi.
    // 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. Selezionare Crea strumento.
  8. Rivedere i passi descritti nella sezione Impostazione di una funzione mediante Java SDK.
Suggerimento

Eseguire una delle azioni riportate di seguito.

  • Se si sta creando un agente, tornare a Creazione di un agente in agenti AI generativi per creare un altro strumento o un endpoint.
  • Se lo strumento è stato aggiunto a un agente esistente, dopo l'attivazione dello strumento, nella pagina dei dettagli dell'agente selezionare Avvia chat per chattare con l'agente utilizzando questo strumento.
  • Se l'agente è stato creato senza endpoint, quando si è pronti per l'uso dell'agente, creare un endpoint per questo agente.