Configurar Ask Essbase

Você pode usar essas etapas para configurar, ativar e gerenciar com eficiência o Ask Essbase para consultas diretas baseadas em IA no ambiente do Oracle Essbase.

Pré-requisitos

Antes de configurar o Ask Essbase, conclua as etapas em Pré-requisitos para Recursos do AI.

  • Implantação do Marketplace: Certifique-se de que o Tipo de Armazenamento de Catálogo esteja definido como Bucket do Serviço Object Storage.

Observação:

O Ask Essbase é ativado por padrão nas implantações do Marketplace. Todos os usuários podem enviar consultas, mas somente os usuários administradores podem configurar suas definições.

Observação:

Para um desempenho ideal, use um modelo de bate-papo Meta Llama ao criar uma conexão de IA, por exemplo, "meta.llama-4-scout-17b-16e-instruct". Consulte Modelos básicos pré-treinados para exibir os modelos disponíveis.

Configurar Conexão do Banco de Dados

  1. Vá para Origens.
  2. Clique em Criar Conexão.
  3. Selecione Oracle Database como o Tipo de Conexão.
  4. Informe as credenciais da instância do Oracle AI Database 26ai nos Detalhes da Conexão.
  5. Clique em Salvar.

Criar Conexão de IA

  1. Vá para Origens.
  2. Clique em Criar Conexão.
  3. Selecione GenAI como o Tipo de Conexão.
  4. Preencha os parâmetros para concluir a seção Detalhes da credencial do vetor e do chat:
    1. OCID do Usuário: Localize esse valor na Visualização do arquivo de configuração.
    2. OCID da Tenancy: Localize esse valor na visualização do arquivo de configuração.
    3. ID do Compartimento do OCI: Vá para Identidade na console do Oracle Cloud Infrastructure e selecione Compartimentos. Você pode encontrar o ID do compartimento lá.
    4. Chave Privada: Consulte as Chaves e OCIDs Necessários para obter instruções sobre como criar sua chave privada.
    5. Impressão Digital: Localize esse valor na Visualização do arquivo de configuração.

    Observação:

    Para obter suas credenciais do OCI:
    1. Acesse a console do Oracle Cloud Infrastructure.
    2. Clique no ícone Perfil e selecione Definições do usuário.
    3. Vá para Tokens e chaves.
    4. Na lista Impressão Digital, selecione sua chave de API.
    5. Clique no menu (três pontos).
    6. Selecione Exibir arquivo de configuração para exibir a Visualização do arquivo de configuração.

    Observação:

    Se você não tiver configurado sua configuração do OCI:
    1. Acesse a console do Oracle Cloud Infrastructure.
    2. Clique no ícone Perfil e selecione Definições do usuário.
    3. Vá para Tokens e chaves.
    4. Clique em Adicionar chave de API.
    5. Escolha Colar uma chave pública.
    6. Na sua VM, abra o arquivo de chave pública e copie o conteúdo da chave pública.
    7. Retorne à página do Oracle Cloud Infrastructure e cole o conteúdo da sua chave pública.
    8. Clique em Adicionar.
    9. Depois de adicionar sua chave de API, clique no menu (três pontos) e selecione Exibir arquivo de configuração para exibir a Visualização do arquivo de configuração.

    Para obter mais detalhes, consulte Chaves e OCIDs Obrigatórios.

  5. Use os seguintes detalhes para preencher as seções Detalhes do perfil de bate-papo e Seção de vetorização e detalhes do gerador MDX:
    1. Modelo de bate-papo: Selecione meta.llama-4-maverick-17b-128e-instruct-fp8 ou qualquer modelo atual listado em Modelos fundamentais pré-treinados
    2. Região da OCI: us-chicago-1 (todas as regiões estão disponíveis)
    3. URL do serviço Generative AI: https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText
    4. Modelo de incorporação de vetores: cohere.embed-english-v3.0
    5. Timeout de transferência: 3000
    6. Descrição: (Opcional)

Vectorizar Documentação

  1. Vá para Academy.
  2. Selecione Perguntar ao Essbase.
  3. Clique no ícone Configurações e selecione a conexão GenAI Ativa que você configura.
  4. Clique em Vectorizar.
    1. Isso inicia um job em segundo plano que cria um índice de vetores, faz upload de arquivos para o armazenamento do OCI e prepara o sistema para consultas de chatbot.
    2. Você pode rastrear o andamento do job na IU Jobs ou diretamente na interface do chatbot.
    3. Você só precisa executar esse processo uma vez.

Iniciar Uso do Ask Essbase

  1. Depois que a vetorização for concluída, faça perguntas diretamente no Ask Essbase.
  2. A IA fornece respostas completas, juntamente com links para a documentação de suporte.

Desativar

  1. Selecione Configurações e, em seguida, selecione o ícone Excluir na página do formulário para desativar a opção Perguntar ao Essbase.

    Observação:

    Esta ação inicia um job em segundo plano que elimina o índice de vetores e a tabela de vetores, exclui o perfil de chat vinculado ao índice de vetores e remove todos os arquivos do ponteiro de documentação do bucket do OCI.