Documentação do Oracle Cloud Infrastructure

Usar Palavra-chave AI para Inserir Prompts

Use AI como a 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

A seguir estã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 de linguagem natural desse resultado.

Quando um índice de vetor é especificado no perfil AI para ativar a RAG, o sistema usa o modelo de transformador especificado (ou transformador padrão) para criar uma incorporação de vetor do prompt para pesquisa de similaridade semântica no armazenamento de vetor. 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 de vetores sejam enviados a 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

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

Observações sobre 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 do AI no argumento profile_name de DBMS_CLOUD_AI.GENERATE.

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

  • Não é possível executar instruções PL/SQL, instruções DDL ou instruções DML usando a palavra-chave AI.

  • A sequência é SELECT seguido por AI. Essas palavras-chave não diferenciam maiúsculas de minúsculas. Depois de definir seu perfil de IA usando DBMS_CLOUD_AI.SET_PROFILE e a ação opcional, o texto após SELECT AI é um prompt de linguagem natural. Se um perfil do AI não for 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 uso 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 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, SELECT AI pode responder com informações para ajudá-lo a gerar SQL válido.

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

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

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