Documentación de Oracle Cloud Infrastructure

Uso de la palabra clave AI para introducir peticiones de datos

Utilice AI como palabra clave en una sentencia SELECT para interactuar con la base de datos mediante peticiones de datos en lenguaje natural.

La palabra clave AI en una sentencia SELECT indica al motor de ejecución SQL que utilice el LLM identificado en el perfil de AI activo para procesar el lenguaje natural y generar SQL.

Puede utilizar la palabra clave AI en una consulta con clientes de Oracle como SQL Developer, OML Notebooks y herramientas de terceros para interactuar con la base de datos en lenguaje natural.

Nota

No puede ejecutar sentencias PL/SQL, DDL ni DML mediante la palabra clave AI.

Sintaxis

La sintaxis para ejecutar el indicador AI es:
SELECT AI action natural_language_prompt

Parámetro

A continuación se muestran los parámetros disponibles para el parámetro action:
parámetro Descripción

runsql

Ejecuta el comando SQL subyacente para la petición de datos de lenguaje natural. Esta es la acción por defecto y es opcional especificar este parámetro.

showsql

Muestra la sentencia SQL para una petición de datos en lenguaje natural.

explainsql

Explica el SQL generado a partir de la petición de datos en un lenguaje natural. Esta opción envía el SQL generado al proveedor de AI para producir una explicación del lenguaje natural.

narrate

Envía el resultado de la consulta SQL ejecutada por la base de datos de nuevo al LLM para generar una descripción de lenguaje natural de ese resultado.

Cuando se especifica un índice vectorial en el perfil de AI para activar RAG, el sistema utiliza el modelo de transformador especificado (o transformador por defecto) para crear una incrustación de vector a partir de la petición de datos de búsqueda de similitud semántica en el almacén de vectores. A continuación, el sistema agrega el contenido recuperado del almacén de vectores a la petición de datos del usuario y lo envía al LLM para generar una respuesta basada en esta información.

Si no desea que los datos de tabla o los documentos de búsqueda vectorial se envíen a un LLM, un usuario con privilegios de administrador puede desactivar dicho acceso para todos los usuarios de la base de datos determinada. De hecho, desactiva la acción narrate.

chat

Transfiere la petición de datos de usuario directamente al LLM para generar una respuesta, que se proporciona al usuario. Si conversation en la función DBMS_CLOUD_AI.CREATE_PROFILE está definido en true, esta opción incluye contenido de interacciones o peticiones de datos anteriores, lo que puede incluir metadatos de esquema.

Notas de Uso

  • La palabra clave AI para Seleccionar AI no está soportada en Database Actions ni en el servicio APEX. Solo puede utilizar la función DBMS_CLOUD_AI.GENERATE.

    No utilice DBMS_CLOUD_AI.SET_PROFILE en Database Actions o el servicio APEX. En su lugar, defina el perfil de AI en el argumento profile_name de DBMS_CLOUD_AI.GENERATE.

  • La palabra clave AI solo está soportada en una sentencia SELECT.

  • No se pueden ejecutar sentencias PL/SQL, DDL ni DML mediante la palabra clave AI.

  • La secuencia es SELECT seguida de AI. Estas palabras clave no distinguen mayúsculas y minúsculas. Después de definir el perfil de AI mediante DBMS_CLOUD_AI.SET_PROFILE y la acción opcional, el texto después de SELECT AI es una petición de datos en lenguaje natural. Si no se define un perfil de AI, SELECT AI informa del siguiente error al ejecutar una sentencia SELECT AI: 

    ORA-00923: FROM keyword not found where expected
00923. 00000 -  "FROM keyword not found where expected"

  • Las reglas de uso de caracteres especiales se aplican de acuerdo con las directrices de Oracle. Por ejemplo, use comillas simples dos veces si está usando un apóstrofe en una oración.

    select ai how many customers in SF don''t own their own home

  • Los LLM están sujetos a alucinaciones y los resultados no siempre son correctos:

    • Es posible que SELECT AI no pueda ejecutar la consulta SQL generada para una petición de datos de lenguaje natural específica.

    • Es posible que SELECT AI no pueda generar una consulta SQL para una petición de datos de lenguaje natural específica.

    • Es posible que el LLM no genere una consulta SQL que produzca un resultado correcto en función de la petición de datos de lenguaje natural.

    En tal caso, SELECT AI puede responder con información para ayudarle a generar SQL válido.

  • Para obtener mejores resultados con lenguaje natural para la generación de SQL, utilice vistas o tablas de base de datos con nombres de columna contextuales o considere la posibilidad de agregar comentarios de columna que expliquen los valores almacenados en las columnas.

  • Utilice la acción explainsql, como en SELECT AI explainsql, para obtener una explicación más detallada de la sentencia SQL, en comparación con SELECT AI showsql.

  • Para acceder a las vistas DBA o USER, consulte Vistas DBMS_CLOUD_AI.