Documentación de Oracle Cloud Infrastructure

Creación de una herramienta SQL 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 SQL.

Antes de crear una herramienta SQL, revise las Directrices de la herramienta SQL para agentes de IA generativa y complete las tareas necesarias.

Creación de una herramienta SQL

  1. Seleccione Crear herramienta y, a continuación, seleccione SQL.
  2. Introduzca un nombre y una descripción para esta herramienta SQL.
    Una descripción del esquema de base de datos en esta herramienta ayuda al agente a comprender mejor cómo generar sentencias de consulta SQL.
  3. En Importar configuración de esquema de base de datos, seleccione una de las siguientes opciones para proporcionar el esquema de base de datos que se utilizará para esta herramienta. Un esquema es un juego de sentencias SQL que debe incluir tablas, columnas, tipos de dato y relaciones para definir la organización de objetos en la base de datos.
    • En línea: introduzca una cadena que contenga las sentencias SQL. La cadena debe comenzar con una palabra clave SQL válida, como CREATE y ALTER, o con un paréntesis de apertura (.
    • Seleccionar de Object Storage: seleccione un compartimento y un cubo. A continuación, seleccione el archivo .sql que contiene las sentencias SQL.
  4. Para Personalización de modelos, seleccione una de las siguientes opciones.
    • Pequeño: seleccione esta opción para consultas simples como "Obtener ventas totales para enero de 2025". Un modelo pequeño proporciona tiempos de respuesta más rápidos.
    • Grande: seleccione esta opción para consultas más complejas, como "Mostrar la media de ventas de los 5 productos con mejor rendimiento en Q1 2023 agrupados por región". Un modelo grande proporciona más precisión, pero a costa de una mayor latencia.
  5. Para Dialecto, seleccione una de las siguientes opciones.
    • SQLite: seleccione esta opción para generar consultas SQL que se alineen con las reglas de sintaxis SQLite. Por ejemplo: SELECT * FROM users LIMIT 5;
    • Oracle SQL: seleccione esta opción para generar consultas que se alineen con las reglas de sintaxis de Oracle SQL. Por ejemplo: SELECT * FROM users FETCH FIRST 5 ROWS ONLY;

      Esta opción garantiza que el SQL generado sea totalmente compatible con la sintaxis y el entorno de ejecución de una instancia de Oracle Database.

  6. (Opcional) En Ejemplos de aprendizaje en contexto, seleccione una de las siguientes opciones para proporcionar ejemplos de consultas de lenguaje natural que los usuarios pueden solicitar en el contexto del esquema proporcionado y las consultas SQL esperadas que se van a generar.
    • En línea: introduzca una cadena que contenga preguntas de ejemplo en lenguaje natural y las consultas SQL esperadas.

      Por ejemplo:

      Question: Show all employees who were born in CA.
Oracle SQL: SELECT * FROM Employees WHERE BIRTHSTATE = 'CA';
    • Seleccionar de Object Storage: seleccione un compartimento y un cubo. A continuación, seleccione el archivo .txt que contiene ejemplos de preguntas y respuestas en el contexto del esquema de base de datos.
    • Ninguno: no hay ejemplos que proporcionar.
  7. (Opcional) En Conexión a la herramienta de base de datos, seleccione un compartimento y, a continuación, seleccione una conexión en el menú.

    Una conexión solo es necesaria si desea activar la ejecución SQL o la autocorrección durante una sesión de chat.

    Para asegurarse de que la conexión seleccionada funciona, seleccione Probar conexión.

    Nota

    La prueba de conexión solo valida que la configuración de la conexión a la base de datos en el servicio Database Tools funcione correctamente y que se pueda acceder a la base de datos. La prueba no valida el acceso del agente a la base de datos. Utilice políticas para asegurarse de que los agentes de IA generativa puedan acceder a la base de datos.
    Consejo

    Si no desea utilizar una conexión en esta herramienta después de seleccionar una, seleccione x al final del menú para eliminar la conexión.
  8. (Opcional) En Activar ejecución SQL, seleccione activar o desactivar la ejecución SQL.

    Cuando la ejecución de SQL está activada, el agente genera la sentencia de consulta SQL, ejecuta la consulta y envía la respuesta al usuario durante la sesión de chat. Solo se generan y ejecutan consultas SELECT, incluidas la unión, varias condiciones y la agregación. Si la ejecución falla, el agente devuelve un error de ejecución de base de datos con el código ORA (por ejemplo, ORA-00933) junto con la consulta SQL generada.

    Consejo

    Para almacenar resultados de más de 100 filas en un cubo de Object Storage, seleccione Activar almacenamiento de resultados de salida grandes en el punto final del agente.
  9. (Opcional) En Activar corrección SQL, seleccione esta opción para activar o desactivar la autocorrección.

    Active la autocorrección para corregir la consulta si se devuelve un error durante la ejecución. Considere no activar la autocorrección para una ejecución más rápida en consultas más simples.

  10. (Opcional) En Instrucciones personalizadas, introduzca texto que solicite al agente que se comporte de una forma más específica.

    Por ejemplo:

    Always use aggregators such as COUNT, SUM, AVG, MIN, MAX in Oracle SQL queries that contain GROUP BY.

  11. (Opcional) En Descripción de tablas y columnas, seleccione una de las siguientes opciones para proporcionar descripciones más detalladas de las tablas y columnas utilizadas en la base de datos.
    • En línea: introduzca una cadena.

      Por ejemplo:

      birthYear      Year employee was born
birthMonth     Month employee was born
    • Seleccionar de Object Storage: seleccione un compartimento y un cubo. A continuación, seleccione el archivo .txt que contiene texto descriptivo para las tablas y columnas de la base de datos.
    • Ninguno: no hay ninguna descripción que proporcionar.
  12. Seleccione Crear herramienta.
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.
Nota

Para permitir que un revisor humano supervise y edite una consulta generada antes de enviarla al usuario, seleccione la función opcional Activar Human in the loop en el punto final del agente.