Documentação do Oracle Cloud Infrastructure

Criando um Ponto Final em Agentes de IA Generativa

Antes de criar vários pontos finais para um agente, consulte Limites e Limitações para Agentes de IA Generativa para obter o número de pontos finais permitidos para um agente.
  1. Na página da lista Agentes, selecione o nome do agente para o qual você deseja criar um ponto final.
    Se precisar de ajuda para localizar a página da lista, consulte Listando Agentes
  2. Em Recursos, selecione Pontos Finais.
  3. Selecione Criar ponto final.
  4. Informe os seguintes valores:
    • Nome: um nome que começa com uma letra ou sublinhado, seguido de letras, números, hifens ou sublinhados. O tamanho pode ser de 1 a 255 caracteres.
    • Descrição: Uma descrição opcional
  5. Ativar sessão: Ative esse recurso para manter o contexto da sessão de chat. Você não poderá alterar essa opção mais tarde.
  6. Se você ativar a sessão, especifique o tempo limite ocioso em segundos. O timeout de inatividade padrão é de 3600 segundos (1 hora). Isso significa que, após a falta de atividade entre o usuário e o agente por 1 hora, a sessão é encerrada automaticamente e as conversas a seguir não retêm o contexto da conversa anterior. Você pode defini-lo como mínimo de 1 hora e máximo de 7 dias.
  7. Ativar armazenamento de resultados de saída grandes: Ative esse recurso para armazenar respostas grandes do agente no Object Storage. Esse recurso se aplica somente à ferramenta SQL.
    Observação

    Quando a execução de SQL é ativada em uma ferramenta SQL e você ativa esse recurso, os Agentes de IA Generativa armazenam a saída em um arquivo .csv somente se o comando SQL retornar mais de 100 linhas. Os Agentes de IA Generativa não armazenam resultados SQL de menos de 100 linhas.
  8. Se você ativar o armazenamento de resultados de saída grandes, especifique os seguintes detalhes do serviço Object Storage para armazenar a saída:
    • bucket
    • Prefixo do objeto, se você tiver pastas
    • Período de retenção em minutos. Insira um número de até 1.440 que seja igual a 24 horas. O valor padrão é 360 minutos, ou seja, 6 horas.
  9. Selecione se deseja ativar os guardrails a seguir.
    • Moderação de conteúdo para entrada (prompt do usuário), saída (resposta gerada) ou ambos:
      • Desativar: Não aplique moderação de conteúdo.
      • Bloquear: Ajuda a identificar e aplicar moderação de conteúdo.
      • Informar: Não aplique moderação de conteúdo, mas informe ao usuário se o agente detectar conteúdo que precise de moderação.
    • Proteção de injeção de prompt (PI):
      • Desativar: Não aplique proteção de PI.
      • Bloquear: Ajuda a identificar e proteger contra injeção de prompt.
      • Informar: Não aplique a proteção de PI, mas informe o usuário se o agente detectar conteúdo que precise de proteção de PI.
    • Proteção de informações pessoalmente identificáveis (PII) para entrada (prompt do usuário), saída (resposta gerada) ou ambos:
      • Desativar: Não aplique a proteção de PII.
      • Bloquear: Ajuda a identificar e proteger PII.
      • Informar: Não aplique a proteção de PII, mas informe o usuário se o agente detectar conteúdo que precise de proteção de PII.
  10. Selecione se deseja ativar as opções a seguir para o ponto final.
    • Ativar rastreamento: Se o histórico de conversas deve ser rastreado e exibido, incluindo o prompt original e a resposta gerada, durante a conversa de chat. Se você não ativar esse recurso agora, sempre poderá adicioná-lo posteriormente editando o ponto final.
    • Ativar citação: Se serão exibidos detalhes sobre a origem das informações de cada resposta de chat. Se você não ativar esse recurso agora, sempre poderá adicioná-lo posteriormente editando o ponto final.
    • Ativar multi-idioma: se apoiará o bate-papo nos seguintes idiomas: árabe, inglês, francês, alemão, italiano, japonês, português e espanhol. Quando desativado, o inglês é o idioma padrão.
    • Ativar humano no loop: Se a entrada humana é necessária, como confirmar a resposta gerada de um agente antes que a resposta possa ser usada.

    Se você não ativar esses recursos agora, sempre poderá adicioná-los posteriormente editando o ponto final.

  11. (Opcional) Selecione Mostrar opções avançadas e adicione uma ou mais tags ao ponto final. Se você tiver permissões para criar um recurso, terá permissão para atualizar suas tags. Se precisar de ajuda, consulte Tags e Conceitos de Namespace de Tag.
  12. Selecione Criar.