Documentación de Oracle Cloud Infrastructure

Creación de una herramienta de llamada de punto final de API en agentes de IA generativa

En los agentes de IA generativa, cada agente debe tener una o más herramientas. Puede crear la herramienta de un agente durante la creación del agente o después de esta. 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 punto final de API.

Antes de comenzar, revise las directrices de la herramienta de llamadas de punto final de API para agentes de IA generativa y complete las tareas que sean necesarias. Por ejemplo, puede que tenga que crear un secreto de OCI Vault y agregar políticas para acceder a los secretos del almacén.

Creación de una herramienta de llamada de punto final de API

  1. Seleccione Crear herramienta y después Herramienta personalizada.
  2. Introduzca un nombre y un descripción para esta herramienta.
  3. En Configuración de herramienta, seleccione Llamada a punto final de API (ejecución de agente).
  4. (Opcional) Seleccione un ejemplo, si corresponde.

    Si selecciona un ejemplo, el ejemplo se copia en el cuadro Esquema de API para la importación en línea. Continúe con el paso 6.

  5. En Esquema de API de importación, seleccione una de las siguientes opciones para proporcionar el esquema de API para esta herramienta. Un esquema de API describe las operaciones y los métodos de punto final de API.
    • En línea: para un esquema pequeño, puede introducir una cadena que contenga las operaciones y los métodos de punto final de API.
    • Seleccionar de Object Storage: para un esquema o esquema grande que tenga actualizaciones frecuentes, seleccione un compartimento y un cubo. A continuación, seleccione el archivo que contiene el esquema de API.
  6. Para Tipo de autenticación, seleccione una de las siguientes opciones y complete la configuración de la herramienta según sea necesario.
    • Ninguno: para llamar a puntos finales de API públicos o privados que no requieren autenticación. Cuando se selecciona, no se agrega ninguna cabecera de autenticación a una solicitud de llamada.
    • Clave de API: una clave de API es un token que proporciona un cliente al realizar llamadas de API. La clave de API se debe almacenar en un secreto de OCI Vault.
      • Ubicación de clave: especifique la ubicación de la clave de API en una solicitud de llamada.
        • Seleccione Cabecera para enviar la clave en la cabecera de solicitud.
        • Seleccione Parámetro de consulta para transferir la clave como parámetro de consulta en la solicitud.
      • Nombre de clave: introduzca el nombre de una clave de cabecera (por ejemplo, Authorization) o el nombre de clave de un parámetro de consulta (por ejemplo, appid).
      • Seleccionar secreto de almacén: en el compartimento adecuado, seleccione el secreto de OCI Vault que tenga la clave de API.
    • Básico: autenticación básica HTTP mediante un nombre de usuario y una contraseña. Las credenciales se deben especificar con el formato <your-username>:<your-password> y se deben almacenar en un secreto de OCI Vault.
      • Seleccionar secreto de almacén: en el compartimento adecuado, seleccione el secreto de OCI Vault que tenga las credenciales en el formato necesario.
    • Bearer: autenticación OAuth 2.0 mediante un token de portador. El token se debe almacenar en un secreto de OCI Vault.
      • Seleccionar secreto de almacén: en el compartimento adecuado, seleccione el secreto de OCI Vault que tenga el token.
    • IDCS: autenticación OAuth 2.0 mediante el ID de cliente y el secreto de cliente obtenidos de una aplicación confidencial de Oracle Identity Cloud Service (IDCS). El secreto de cliente se debe almacenar en un secreto de OCI Vault.
      • Dominio de identidad: en el compartimento adecuado, seleccione el dominio de identidad en el que desea crear esta herramienta.
      • ID de cliente: introduzca el ID de cliente de la aplicación confidencial.
      • Secreto de cliente: en el compartimento adecuado, seleccione el secreto de OCI Vault que tenga el secreto de cliente para la aplicación confidencial.
      • URL de ámbito: introduzca la URL de ámbito que define un juego específico de recursos y operaciones a los que se puede acceder.
    • Entidad de recurso de OCI: solo para llamar a las API del servicio de OCI, como Object Storage, Compute y Networking (VCN y subred).
  7. En el compartimento adecuado, seleccione la VCN y la subred que desea utilizar.
  8. Seleccione Crear herramienta.
Consejo

Realice una de las siguientes acciones:

  • Si está creando un agente, vuelva a Creación de un agente en agentes de IA generativa para crear otra herramienta o un punto final de agente.
  • 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 de agente, cuando esté listo para utilizar el agente, cree un punto final para este agente.
Nota

Para permitir que un revisor humano supervise y edite una respuesta antes de enviarla al usuario, seleccione la función opcional Activar humano en el bucle en el punto final del agente.