Problemas de Herramienta SQL
Solucione problemas comunes mientras trabaja con la herramienta SQL en agentes de IA generativa.
Asegúrese de revisar también los problemas conocidos para agentes de IA generativa, las directrices de la herramienta SQL para agentes de IA generativa y de completar las tareas necesarias para utilizar una función específica en un agente con una herramienta SQL.
La herramienta SQL no se puede crear
La creación de una herramienta SQL en la consola parece ser correcta, ya que los agentes de IA generativa no muestran ningún mensaje de error inicial. Sin embargo, el agente se ha creado correctamente, pero la herramienta SQL del agente no se puede crear. En la solicitud de trabajo CREATE_TOOL, se muestra un mensaje de error similar al siguiente:
Create Tool for ocid1.genaiagenttool.oc1.us-chicago-1.<string> failed due to sql errors: Statement:null[Error:net.sf.jsqlparser.parser.ParseException: Encountered unexpected <something>; at line <number>, column <number>. <more details> La causa más común es un esquema de base de datos no válido.
Suprima la herramienta SQL con fallos y agregue una nueva herramienta.
- En la lista Herramientas del agente, busque la herramienta SQL con fallos. Si necesita ayuda para encontrar la lista, consulte Lista de las herramientas SQL en agentes de IA generativa.
- En el menú de la creación de la herramienta que ha fallado, seleccione Suprimir.
- Seleccione Crear herramienta para agregar una nueva herramienta SQL.
Para obtener una descripción de esquema válida, consulte Esquema de base de datos.
También puede copiar el DDL de las tablas de esquema, como se describe en el siguiente procedimiento opcional.
(Opcional) Utilice estos pasos para obtener un esquema válido de la base de datos.
- En la consola, conéctese a una base de datos y abra la hoja de trabajo de SQL.
- En el navegador, busque el esquema y las tablas desde los que desea copiar el DDL.
- Haga clic con el derecho en una tabla y seleccione DDL rápido. A continuación, seleccione Guardar en Archivo. Repetir para Cada Tabla.
- En un nuevo archivo de texto, cree el esquema de base de datos copiando y agregando el texto de cada archivo descargado. Modifique el DDL en el archivo DDL completo según sea necesario.
- En Generative AI Agents, busque su agente. Agregue una herramienta SQL copiando y pegando el contenido del archivo DDL completo en el campo En línea para importar el esquema de base de datos.
Falta el archivo de salida de ejecución SQL
Una herramienta SQL está activada para ejecutar las consultas SQL generadas y almacenar el resultado de salida en Object Storage si hay más de 100 filas en la salida. Parece que el chat en el punto final del agente se ha realizado correctamente, pero el archivo de resultados de salida no se guarda en Object Storage. Se muestra un mensaje de error similar al siguiente:
Unable to create PreAuthenticated Request url for the result location.En las siguientes secciones, se describen las posibles causas.
Falta el cubo o no es válido
Seleccione un cubo de Object Storage válido en el compartimento preferido.
- En la página de detalles del agente, en Recursos, seleccione Puntos finales.
- Seleccione el punto final activado para la ejecución de SQL.
- En el panel Editar punto final, asegúrese de que está seleccionada la opción Activar almacenamiento de resultados de salida grandes.
- En la sección Detalles de salida, seleccione el compartimento y el cubo en los que desea guardar los resultados de salida que tengan más de 100 filas.
- Seleccione Guardar cambios.
Faltan políticas
Revise las políticas de IAM para asegurarse de que ha configurado los permisos correctos para acceder a Object Storage.
Agregue las políticas como se describe para Object Storage, la ejecución de SQL y el almacenamiento de salida.