Criar Perfil de IA

O Autonomous AI Database usa perfis de IA para facilitar e configurar o acesso a um LLM e para configurar a geração, execução e explicação de SQL com base em prompts de linguagem natural usando o Data Studio.

Antes de criar um Perfil do AI usando o Data Studio, você deve conhecer os seguintes conceitos:

Definições de RAG (Retrieval Augmented Generation, Geração aumentada de recuperação): As Definições de RAG configuram pipelines de Geração aumentada de recuperação no Oracle Autonomous Database Serverless, permitindo que perfis de IA carreguem e consultem dados não estruturados de bases de conhecimento juntamente com tabelas estruturadas. Essas definições definem como os documentos são processados em vetores para pesquisa semântica, melhorando a precisão do SELECT AI para consultas de linguagem natural.
Observação

Você não pode acessar recursos de RAG como criar e usar Índices de Vetor no Oracle AI Database 19c. Esses recursos são suportados no Oracle AI Database 26ai.
Índice de Vetor: Os índices de vetor devem ser especificados para armazenar incorporações geradas a partir de pipelines RAG ou dados de tabela, permitindo pesquisas de similaridade eficientes durante a inferência de IA. Na criação de perfil de IA via DBMS_CLOUD_AI.CREATE_PROFILE, os Índices de Vetor vinculam o perfil aos recursos de pesquisa vetorial da Oracle, garantindo que o modelo de IA recupere o contexto relevante de dados vetorizados. Você pode criar Índices de Vetor em Definições do Data Studio.
Metadados da Tabela:
Metadados de tabela, fornecidos como um object_list nos atributos do perfil (por exemplo, [{"owner": "SH", "name": "customers"}]), escopam o acesso do AI a tabelas de banco de dados específicas e impõem políticas de segurança. Isso impede que a IA consulte dados não intencionais, se alinhe aos controles do IAM e otimize a linguagem natural para a geração de SQL para esquemas definidos.

Para obter mais detalhes, consulte Selecionar IA com Geração Aumentada de Recuperação (RAG).

Os Perfis de IA suportam dois modos:

Modo RAG: Utiliza o Vector Index para pesquisa semântica em dados não estruturados.
Modo de Linguagem Natural para SQL (NL2SQL): não requer Índice de Vetor para ativar opções com foco em tabela, como o modo de lista de objetos.

A seleção de + abre o assistente Criar Perfil do AI:

Na guia Serviço do assistente de Criação de Perfil de IA, especifique os seguintes valores de campo:

Descrição da ilustração create-ai-profile-service.png
- Nome do Perfil: Informe o nome do perfil do AI. Por exemplo, IA da OCI.
- Provedor de IA: Selecione qualquer um dos seguintes provedores no campo suspenso:
  - OCI
  - IA aberta
  - Serviço Azure OpenAI
  - Cohere
  - Google
  - Antrópico
  - Hugging Face
- Modelo de IA: Selecione os modelos de IA disponíveis no menu suspenso para o qual seu perfil de IA apontará para que o banco de dados responda a perguntas de linguagem natural sobre seus dados e gere ou explique SQL, incluindo resultados aumentados de recuperação usando incorporações e índices vetoriais.
- Credencial: Estas são as credenciais armazenadas que o banco de dados usa para se conectar com segurança ao provedor de IA externo que seu perfil está configurado para usar.
Em Configurações Avançadas, você exibirá Configurações de Geração e Configurações de Serviço:
- Definições de Geração: As Definições de Geração ajudam a configurar o comportamento e os limites do modelo de IA acessado por meio do perfil nos serviços de IA do Oracle Cloud Infrastructure, permitindo a personalização de diferentes casos de uso, como chat, geração de SQL ou consultas de linguagem natural do Autonomous Database.
- Definições de Serviço: As Definições de Serviço se referem aos campos de configuração que aparecem dinamicamente com base no Provedor de IA selecionado, permitindo que os usuários insiram credenciais e parâmetros específicos do provedor, como pontos finais, regiões ou nomes de implantação.
  Note
  
  For AI Providers such as OpenAI, Cohere, Google, Anthropic, or Hugging Face, the Service Settings section is not displayed.
Os valores do campo Definições de Serviço variam de acordo com o Provedor de IA selecionado.
Ao selecionar OCI no Provedor de IA, você exibirá os seguintes campos:
- Formato de API do OCI: Especifica qual esquema de solicitação e resposta o ponto final do serviço Generative AI espera, por exemplo, COHERE, Genérico ou um formato nativo do OCI para modelos Oracle.
- Região do OCI: Este é o identificador de região do OCI em que o ponto final está em execução. Ele garante que as chamadas do seu banco de dados sejam roteadas para os modelos de IA regionais corretos. Cada região do Autonomous AI Database OCI suporta diferentes LLMs. Algumas regiões, como us-chicago-1, uk-london-1 e ap-osaka-1, oferecem muitas, enquanto outras têm menos. Mostramos apenas modelos disponíveis na região selecionada. Se o modelo do OCI AI não aparecer, você poderá alternar regiões para atualizar a lista de modelos. Para obter mais informações, consulte Regiões com IA Generativa e Modelos Básicos Pré-treinados no Serviço Generative AI.
- ID do Compartimento do OCI: Este é o OCID do compartimento do OCI que possui os pontos finais que você deseja usar. Ele faz o escopo do acesso e do faturamento para o contêiner lógico correto em sua tenancy, alinhando-se às suas políticas do IAM.
- ID do Ponto Final do OCI: Este é o OCID de um ponto final específico do AI em um cluster de IA dedicado, por exemplo, ocid1.generativeaiendpoint.oc1.us-chicago-1, Especificar esse campo informa ao Select AI para usar esse ponto final dedicado em vez de um modelo sob demanda compartilhado.
Quando você seleciona Serviço OpenAI do Azure no campo Provedor de IA, você exibe os seguintes campos:
- Nome do Recurso do Azure: Especifique o nome exclusivo da instância do recurso do Serviço OpenAI do Azure, que faz parte do URL do ponto final (por exemplo, https://your-resource-name.openai.azure.com/) para acessar o serviço.
- Nome da Implantação do Azure: Especifique o nome personalizado que você designa ao implantar um modelo de idioma específico nesse recurso do Azure OpenAI.
- Nome da Implantação de Incorporação do Azure: Especifique o nome personalizado de uma implantação separada para um modelo de incorporação (como text-embedding-ada-002 ou text-embedding-3-large) dentro do mesmo recurso, usado exclusivamente para criar representações vetoriais de texto.
Consulte Habilidade de incorporação do Azure OpenAI - Pesquisa de IA do Azure | Microsoft Learn para obter mais informações sobre os campos acima.
Em Definições de Geração, você pode exibir os campos:
- Parar Tokens: São sequências de token que instruem o modelo de IA para onde parar de gerar mais saída de texto. Quando o modelo gera qualquer um desses tokens, ele para. Isso ajuda a controlar o comprimento da resposta e a evitar texto final indesejado.
- Máximo de Tokens: Define o número máximo de tokens que o modelo de IA pode gerar em resposta a um prompt. Ele limita a duração da saída gerada para evitar respostas excessivamente longas ou caras.
- Valores com Distinção entre Maiúsculas e Minúsculas: Essa definição indica se os valores ou parâmetros de entrada devem ser tratados com distinção entre maiúsculas e minúsculas pelo processamento do AI. Se verdadeiro, deve haver correspondência exata de maiúsculas/minúsculas para valores de entrada ou parâmetro.
- Conversa: Isso geralmente indica se o perfil de IA oferece suporte ao contexto de conversação, permitindo que o modelo retenha o contexto em várias interações ou trocas de prompts, úteis para aplicações de IA no estilo de chat.
- Temperatura: Este é um parâmetro do controle deslizante que controla a aleatoriedade nas respostas do AI. Uma temperatura mais baixa (por exemplo, 0,2) torna a produção mais focada e determinística, enquanto uma temperatura mais alta (por exemplo, 0,8) produz uma geração de texto mais criativa e diversificada.
Clique em Próximo para prosseguir para a guia Definições de RAG de Criar Perfil de IA.
Definições do RAG:
Você pode exibir os seguintes campos opcionais em Configurações de RAG:

Descrição da ilustração create-ai-profile-ragsettings.png
- Índice de Vetor: Selecione o Índice de Vetor que você cria na lista de índices vetoriais disponíveis. Ele especifica qual índice de vetores do Oracle Database usar para armazenar e pesquisar as incorporações de seus documentos, para que o perfil de IA possa encontrar rapidamente o conteúdo mais relevante durante a Geração Aumentada de Recuperação.
  Consulte Criar Índice de Vetor para obter mais informações.
  
  Seu Perfil de IA requer um Índice de Vetor para funcionar.
- Modelo de Incorporação: Ele especifica qual modelo de incorporação é usado para converter seu texto em representações vetoriais armazenadas nesse índice, garantindo que o comportamento da pesquisa semântica corresponda ao modelo configurado para RAG.
  
  Os campos acima são opcionais. Você pode ignorá-los e clicar em Criar Perfil de IA para criar o Perfil de IA. Como alternativa, você pode prosseguir para a guia Metadados da Tabela.
Na guia Metadados da Tabela, você pode exibir os seguintes campos opcionais:

Descrição da ilustração create-ai-profile-tablemetadata.png
Observação

Se você tiver ignorado a seleção de um Índice de Vetor na etapa anterior, exibirá uma definição chamada Modo de Lista de Objetos.
- Modo de Lista de Objetos: Você pode selecionar qualquer uma das opções de campo disponíveis:
  - Tudo: Esta opção envia metadados de todas as tabelas nos esquemas especificados para o LLM, para que ele possa gerar SQL em qualquer uma delas.
  - Automatizado: Essa opção permite que o Select AI escolha automaticamente um subconjunto de tabelas relevantes executando a pesquisa vetorial em metadados de esquema, de modo que apenas as tabelas mais prováveis de um determinado prompt sejam usadas.
  - Tabelas Selecionadas: Esta opção limita os metadados apenas às tabelas específicas listadas no perfil do AI; portanto, a geração de SQL é restrita a essas tabelas.
    
    Você também pode exibir a Lista de Objetos, na qual pode selecionar a lista de objetos que o LLM pode usar.
    
    A seleção de Lista de Objetos também mostrará outra chave de definição adicional Impor Lista de Objetos.
  - Nenhum: Esta opção não envia metadados de tabela de uma lista de objetos; portanto, o AI não pode gerar SQL sobre tabelas ou depender de outra configuração que não use uma lista de objetos explícita.
  Observação
  
  Você não pode exibir o campo Modo de Lista de Objetos com o Oracle AI Database 19c.
- Anotações: Use essa opção para ativar Anotações que indicam se a IA pode usar metadados descritivos extras anexados a objetos (como descrições de coluna ou tags) como contexto adicional ao gerar resultados.
- Comentários: Use essa opção para controlar se os comentários da tabela e da coluna do dicionário de dados serão expostos à IA como contexto, o que pode ajudá-la a entender melhor o significado dos seus dados.
- Restrições: Use essa opção para controlar se as informações sobre chaves primárias, chaves estrangeiras e outras restrições são fornecidas à IA, ajudando-a a raciocinar sobre relacionamentos entre tabelas e a melhorar a precisão da consulta.
Clique em Criar Perfil de IA.

Você criou e configurou com sucesso seu perfil do AI no assistente de Definições do Data Studio.

Tópico principal: Definições do Data Studio

Documentação do Oracle Cloud Infrastructure

Criar Perfil de IA