Documentação do Oracle Cloud Infrastructure

Criando uma Ferramenta de Chamada de Função Personalizada em Agentes de IA Generativa

Em Agentes de IA Generativa, cada agente deve ter uma ou mais ferramentas. Você pode criar a ferramenta de um agente durante ou após a criação do agente. Para ambas as opções, a criação de uma ferramenta tem as mesmas etapas. Esta seção mostra as etapas para criar uma ferramenta de chamada de função.

Criando uma ferramenta de chamada de função

  1. Selecione Criar ferramenta.
  2. Selecione Ferramenta personalizada.
  3. (Opcional) Especifique as informações a seguir:
    • Nome: Um nome para a ferramenta personalizada que começa com uma letra ou sublinhado, seguido por letras, números, hifens ou sublinhados. O comprimento pode ser de 1 a 255 caracteres.
    • Description: Uma descrição opcional.
  4. Em Configuração da ferramenta, selecione Chamada de função
  5. Digite as seguintes informações:
    • Nome: Um nome para a função que começa com uma letra ou sublinhado, seguido por letras, números, hifens ou sublinhados. O comprimento pode ser de 1 a 255 caracteres.
    • Description: Uma descrição opcional.
  6. Para os Parâmetros de função, informe os parâmetros que a função aceita em um formato JSON.
    Seguem alguns exemplos:
    // 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. Selecione Criar ferramenta.
  8. Verifique as etapas em Configurando uma função usando o Java SDK.
Dica

Execute uma das seguintes ações:

  • Se você estiver criando um agente, volte para Criando um Agente em Agentes do Serviço Generative AI para criar outra ferramenta ou um ponto final.
  • Se você tiver adicionado a ferramenta a um agente existente, depois que a ferramenta estiver ativa, na página de detalhes do agente, selecione Iniciar chat para conversar com o agente usando essa ferramenta.
  • Se você criou o agente sem um ponto final, quando estiver pronto para usar o agente, crie um ponto final para esse agente.