Criando um Agente em Generative AI Agents

Crie um agente com uma ou mais ferramentas e configure um ponto final do agente no serviço Generative AI Agents.

Importante

Antes de começar, certifique-se de ter permissão para gerenciar o serviço. Para selecionar o modelo que o agente usa, consulte Acesso do Usuário à Seleção de Modelo em Agentes.

Navegando na Console

Na barra de navegação da Console, selecione uma região com Generative AI Agents, por exemplo, US Midwest (Chicago) ou UK South (London). Consulte Regiões com Agentes de IA Generativa para ver as regiões nas quais os Agentes de IA Generativa estão hospedados.
Na página de lista Agentes, selecione Criar agente. Se precisar de ajuda para localizar a página da lista, consulte Listando Agentes.

Inserindo Informações Básicas

Digite as seguintes informações:
- 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.
- Compartimento: Selecione o compartimento no qual você deseja armazenar o agente.
- Description: Uma descrição opcional.
- Mensagem de boas-vindas: Uma mensagem opcional que cumprimenta os usuários quando iniciam o chat com o agente. Se você deixar este campo em branco, o agente iniciará a conversa com a mensagem de boas-vindas padrão exibida como um texto de dica na caixa de texto.
- Instruções de roteamento: um prompt opcional sobre o roteamento das ferramentas que podem influenciar ou afetar o comportamento do agente. Por exemplo, se um agente tiver várias ferramentas, um prompt poderá ser "Sempre chamar a ferramenta SQL primeiro".
Seleção de Modelo: Selecione entre as seguintes opções:
- Roteando o tipo de LLM
  - Padrão: Um modelo usado pelo serviço Generative AI Agents
  - Modelo de IA generativa: Um modelo hospedado no serviço Generative AI
  - Ponto final de IA generativa: Um modelo hospedado em um ponto final de cluster de IA dedicado no serviço Generative AI
Dica

Para obter orientação e uma lista de modelos e regiões suportados, consulte a página Seleção de Modelo em Agentes de IA Generativa.
Se você selecionou Modelo de IA generativa, selecione um modelo. Com base na região na qual você está criando o agente, a lista de modelos é preenchida.
Se você selecionou Ponto final de IA generativa, selecione o compartimento e o ponto final do serviço Generative AI.
(Opcional) Atualize os hiperparâmetros padrão.
Os hiperparâmetros e seus valores padrão diferem por tipo de modelo.
(Opcional) Selecione Mostrar opções de tag e adicione uma ou mais tags ao agente. 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.

Adicionar ferramenta

Importante

Esta etapa não cria as ferramentas. As ferramentas são criadas depois que você cria o agente.

Configure a criação de uma das ferramentas a seguir.
- Ferramenta RAG
- Ferramenta SQL
- Ferramenta de chamada de função
- Ferramenta de chamada de ponto final de API
- Ferramenta de agente (agente como ferramenta)
(Opcional) Repita a etapa anterior para configurar a criação de outra ferramenta.

Consulte Limites e Limitações para Agentes do Serviço Generative AI para obter o número de ferramentas permitidas para um agente.

Configurando um Ponto Final do Agente

Importante

Esta etapa configura um ponto final com recursos de ponto final comuns. Para ativar e desativar outros recursos não incluídos nesta etapa, como suporte a vários idiomas, edite o ponto final.

(Opcional) Selecione Criar automaticamente um ponto final para este agente para criar um ponto final quando o agente for criado.
Se você optou por criar um ponto final, selecione se deseja ativar os seguintes recursos opcionais para o ponto final:
- 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.
- 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.

Revisando os Detalhes

Analise os detalhes. Se precisar alterar qualquer uma das opções, selecione Anterior, atualize as informações e navegue de volta para a etapa de revisão.
Selecione Criar agente.
Leia o Acordo de Licença e a AUP do Lhama 3 e marque a caixa de seleção para concordar com o Acordo de Licença e a Política de Uso Aceitável do Lhama 3 e, em seguida, selecione Enviar.