Documentación de Oracle Cloud Infrastructure

Creación de una herramienta de llamada de función personalizada en agentes de IA generativa

En los agentes de IA generativa, cada agente debe tener una o más herramientas. Puede crear una herramienta de agente durante o después de crear el agente. Para ambas opciones, la creación de una herramienta tiene los mismos pasos. En esta sección se muestran los pasos para crear una herramienta de llamada de función.

Creación de una herramienta de llamada de función

  1. Seleccione Crear herramienta.
  2. Seleccione Herramienta personalizada.
  3. (Opcional) Introduzca la siguiente información:
    • Nombre: nombre de la herramienta personalizada que comienza con una letra o un guion bajo, seguido de letras, números, guiones o guiones bajos. La longitud puede ser de 1 a 255 caracteres.
    • Descripción: descripción opcional.
  4. En Configuración de herramientas, seleccione Llamada de función.
  5. Introduzca la siguiente información:
    • Nombre: nombre de la función que comienza con una letra o un guion bajo, seguido de letras, números, guiones o guiones bajos. La longitud puede ser de 1 a 255 caracteres.
    • Descripción: descripción opcional.
  6. Para los parámetros de función, introduzca los parámetros que la función acepta en formato JSON.
    A continuación se muestran algunos ejemplos:
    // 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. Seleccione Crear herramienta.
  8. Revise los pasos de Configuración de una función mediante el SDK de Java.
Consejo

Realice una de las siguientes acciones:

  • Si está creando un agente, vuelva a Creating an Agent in Generative AI Agents para crear otra herramienta o un punto final.
  • Si ha agregado la herramienta a un agente existente, después de que la herramienta esté activa, en la página de detalles del agente, seleccione Iniciar chat para chatear con el agente mediante esta herramienta.
  • Si ha creado el agente sin un punto final, cuando esté listo para utilizar el agente, cree un punto final para este agente.