Documentação do Oracle Cloud Infrastructure

Usar palavra-chave AI para inserir prompts

Use AI como palavra-chave em uma instrução SELECT para interagir com o banco de dados usando prompts de linguagem natural.

A palavra-chave AI em uma instrução SELECT instrui o mecanismo de execução SQL a usar o LLM identificado no perfil de IA ativo para processar linguagem natural e gerar SQL.

Você pode usar a palavra-chave AI em uma consulta com clientes Oracle, como SQL Developer, Notebooks OML e ferramentas de terceiros, para interagir com o banco de dados em linguagem natural.

Observação

Você não pode executar instruções PL/SQL, instruções DDL ou instruções DML usando a palavra-chave AI.

Sintaxe

A sintaxe para executar o prompt AI é:
SELECT AI action natural_language_prompt

Parâmetros

Estes são os parâmetros disponíveis para o parâmetro action:
Parâmetro Descrição

runsql

Executa o comando SQL subjacente para o prompt de linguagem natural. Essa é a ação padrão e é opcional especificar esse parâmetro.

showsql

Exibe a instrução SQL de um prompt de linguagem natural.

explainsql

Explica o SQL gerado do prompt em uma linguagem natural. Essa opção envia o SQL gerado ao provedor de IA para produzir uma explicação de linguagem natural.

narrate

Envia o resultado da consulta SQL executada pelo banco de dados de volta ao LLM para gerar uma descrição em linguagem natural desse resultado.

Quando um índice de vetores é especificado no perfil AI para ativar o RAG, o sistema usa o modelo de transformador especificado (ou transformador padrão) para criar uma incorporação de vetores a partir do prompt de pesquisa de similaridade semântica no armazenamento de vetores. Em seguida, o sistema adiciona o conteúdo recuperado do armazenamento de vetores ao prompt do usuário e o envia ao LLM para gerar uma resposta com base nessas informações.

Se você não quiser que os dados da tabela ou os documentos de pesquisa vetorial sejam enviados para um LLM, um usuário com privilégios de administrador poderá desativar esse acesso para todos os usuários do banco de dados fornecido. Isso, na verdade, desativa a ação narrate.

chat

Informa o prompt do usuário diretamente para o LLM para gerar uma resposta, que é fornecida ao usuário. Se conversation na função DBMS_CLOUD_AI.CREATE_PROFILE for definida como true, essa opção incluirá conteúdo de interações ou prompts anteriores, potencialmente incluindo metadados de esquema.

Observações de Uso

  • A palavra-chave AI para Selecionar AI não é suportada no Database Actions ou no APEX Service. Você só pode usar a função DBMS_CLOUD_AI.GENERATE.

    Não use DBMS_CLOUD_AI.SET_PROFILE no Database Actions ou no APEX Service. Em vez disso, defina o perfil AI no argumento profile_name da DBMS_CLOUD_AI.GENERATE.

  • A palavra-chave AI só é suportada em uma instrução SELECT.

  • Você não pode executar instruções PL/SQL, instruções DDL ou instruções DML usando a palavra-chave AI.

  • A sequência é SELECT seguida por AI. Essas palavras-chave não diferenciam maiúsculas de minúsculas. Depois de definir seu perfil do AI usando DBMS_CLOUD_AI.SET_PROFILE e ação opcional, o texto após SELECT AI é um prompt de linguagem natural. Se um perfil do AI não estiver definido, SELECT AI reportará o seguinte erro ao executar uma instrução SELECT AI: 

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

  • Regras de utilização de caracteres especiais se aplicam de acordo com as diretrizes da Oracle. Por exemplo, use aspas simples duas vezes se estiver usando um apóstrofo em uma frase.

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

  • Os LLMs estão sujeitos a alucinações e os resultados nem sempre estão corretos:

    • É possível que SELECT AI não consiga executar a consulta SQL gerada para um prompt de linguagem natural específico.

    • É possível que o SELECT AI não consiga gerar uma consulta SQL para um prompt de linguagem natural específico.

    • É possível que o LLM não gere uma consulta SQL que produza um resultado correto, dado seu prompt de linguagem natural.

    Nesse cenário, o SELECT AI pode responder com informações para ajudá-lo a gerar SQL válido.

  • Para obter melhores resultados com linguagem natural para geração de SQL, use views de banco de dados ou tabelas com nomes de coluna contextuais ou considere adicionar comentários de coluna explicando valores armazenados nas colunas.

  • Use a ação explainsql, como no SELECT AI explainsql, para obter uma explicação mais detalhada da instrução SQL, em comparação com SELECT AI showsql.

  • Para acessar as views DBA ou USER, consulte DBMS_CLOUD_AI Views.