Diretrizes da Ferramenta do Agente em Generative AI Agents

Em Generative AI Agents, uma ferramenta Agent em um agente permite anexar o ponto final do agente ativo de outro agente para configurar esse subagente como uma ferramenta.

Para fins de documentação, um agente colaborador é o subagente configurado como uma ferramenta Agente. Um agente que tem um ou mais agentes colaboradores em sua configuração é o agente supervisor.

Você pode usar agentes colaboradores e um agente supervisor para implementar uma estrutura que orquestre consultas por meio do agente supervisor para seus agentes colaboradores que lidam com tarefas especializadas.

Visão Geral de Supervisor e Agentes Colaboradores

Compreender as propriedades e responsabilidades de um agente supervisor e seus agentes colaboradores.

  • O agente supervisor e um agente colaborador podem pertencer a diferentes tenancies.

  • Um agente colaborador pode ser um agente com qualquer tipo de ferramenta (como ferramenta RAG) ou combinação de tipos de ferramenta (como ferramentas de chamada de RAG e Função), desde que o agente esteja associado a um ponto final de agente ativo.

  • O agente configurado como uma ferramenta Agente pode operar de forma independente e ser integrado a um agente supervisor.
  • Ferramentas adicionais (como RAG e SQL) podem ser incluídas no agente do supervisor com agentes colaboradores.

  • O agente supervisor é responsável por:

    • Gerenciamento de sessão e roteamento de consulta

    • Agregando respostas de agentes ou ferramentas do colaborador

    • Mantendo um histórico de bate-papo global

  • Um agente colaborador é responsável por:

    • Tratando consultas relevantes para sua especialização (por exemplo, RH)
    • Manter um histórico de bate-papo localizado vinculado à sessão global.
  • Métricas e faturamento são tratados separadamente para o agente supervisor, agentes colaboradores e ferramentas.

Um possível cenário de fluxo de dados envolvendo respostas de vários agentes colaboradores pode ser descrito da seguinte forma:

  1. Um usuário envia uma consulta ao agente supervisor em uma sessão de chat. A consulta abrange mais de uma especialização.
  2. O agente supervisor divide a consulta e delega as subconsultas aos agentes colaboradores relevantes com base na lógica de roteamento.
  3. Cada agente colaborador processa sua subconsulta usando seu contexto de sessão. Os agentes colaboradores retornam suas respostas ao agente supervisor.
  4. O agente supervisor agrega e formata as respostas em uma saída consolidada e envia a saída ao usuário.

Workflow

O workflow para implementar agentes colaboradores e um agente supervisor é:

  1. Compreender e adicionar as políticas do OCI Identity and Access Management (IAM) necessárias. Consulte Políticas do Serviço IAM.
  2. Crie os agentes colaboradores usando qualquer ferramenta. Se precisar de ajuda, consulte Criando um Agente.
  3. Certifique-se de que cada agente colaborador tenha um ponto final de agente associado que esteja ativo e ativado para a sessão. Se precisar de ajuda, consulte Obtendo Detalhes de um Ponto Final.
  4. Crie o agente supervisor. Use o tipo de Ferramenta do agente para adicionar os agentes do colaborador. Se precisar de ajuda, consulte Criando uma Ferramenta de Agente.
  5. Certifique-se de que o ponto final do agente do supervisor esteja ativado para sessão. Se precisar de ajuda, consulte Obtendo Detalhes de um Ponto Final.

Políticas de IAM

Certifique-se de conceder aos usuários acesso a todos os recursos do Generative AI Agents, conforme descrito em Adicionando Políticas Antes de Usar o Serviço.

Verifique também as seções a seguir.

Grupo Dinâmico e Política

Você precisa adicionar um grupo dinâmico com permissão para gerenciar genai-agent-family.

  1. Crie um grupo dinâmico e adicione a seguinte regra de correspondência.

    ALL {resource.type='genaiagent'}

    Se precisar de ajuda, consulte Criando um Grupo Dinâmico.

  2. Conceda permissão ao grupo dinâmico.

    • Grave a seguinte política, que pode ser usada com o domínio de identidades Padrão:

      allow dynamic-group <dynamic-group-name> 
      to manage genai-agent-family in tenancy
      
    • Use a seguinte política com um domínio de identidades não Padrão, fornecendo o nome do domínio do IDCS (Oracle Identity Cloud Service) e o nome do grupo dinâmico:

      allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
      to manage genai-agent-family in tenancy
      

    Consulte Sobre Tipos de Recursos de Agentes de IA Generativa para atribuir permissões com base em tipos de recursos individuais em vez do tipo de recurso agregado.

Acesso entre Tenancies

Para usar um ponto final de agente proveniente de outra tenancy, determinadas políticas devem ser configuradas na tenancy de destino e na tenancy em que você está criando a ferramenta Agente. Reúna as seguintes informações:

  • O nome e o OCID da tenancy de destino. A tenancy de destino é a tenancy que tem o ponto final do agente ativo que você deseja usar.
  • O nome da tenancy e o OCID em que você está criando uma ferramenta do Agente.
  • O nome do grupo dinâmico e o OCID.

Crie as seguintes instruções de política entre tenancies. Se aplicável, use o formato '<idcs-domain-name>/<dynamic-group-name>' na sintaxe para uso em um domínio de identidades que não seja Padrão.

Na tenancy em que você está criando uma ferramenta Agente:

<target-tenancy> é a tenancy que tem o ponto final do agente ativo que você deseja usar.

Define tenancy <target-tenancy> as <target-tenancy-ocid>
Endorse dynamic-group <dynamic-group-name> to manage genai-agent-family in tenancy <target-tenancy>
Na tenancy de destino:

<this-tenancy> é a tenancy na qual você está criando uma ferramenta do Agente.

Define tenancy <this-tenancy> as <this-tenancy-ocid>
Define dynamic-group <dynamic-group-name> as <dynamic-group-ocid>
Admit dynamic-group <dynamic-group-name> of tenancy <this-tenancy> to manage genai-agent-family in tenancy

Se você precisar de ajuda, consulte Políticas de Acesso entre Tenancies na documentação do OCI IAM com Domínios de Identidade.

Pontos Finais com Sessão Ativada

Uma ferramenta de Agente suporta apenas um agente com um ponto final de agente que tenha a sessão ativada.

Quando a sessão é ativada em um ponto final do agente para manter o contexto de uma sessão de chat, os Agentes do Serviço Generative AI criam um ID de sessão e persistem na sessão do agente para a conversa interativa. Durante a sessão, o contexto e a continuidade são mantidos para fornecer respostas coerentes e significativas ao longo da conversa.

Para um agente colaborador que deve ser configurado em um agente supervisor, certifique-se de que o agente tenha apenas um ponto final de agente baseado em sessão. O agente do supervisor também deve ser associado somente a um ponto final do agente que tenha a sessão ativada.

Por padrão, quando você usa a Console para criar um agente e optar por criar automaticamente o ponto final do agente ao mesmo tempo, a sessão é ativada no ponto final do agente que é criado com o agente. Para verificar, você pode exibir os detalhes do ponto final no agente.

Se você criar um ponto final de agente manualmente, certifique-se de que a opção Ativar sessão esteja selecionada se o ponto final for configurado com uma ferramenta de Agente.

Informações Obrigatórias

Antes de criar uma ferramenta Agente, reúna as seguintes informações:

  • O nome do agente a ser adicionado como uma ferramenta.
  • O nome do ponto final do agente ativo baseado em sessão para esse agente. Crie um ponto final de agente se o agente não tiver um ponto final ativo que você possa usar. Se precisar de ajuda, consulte Criando um Ponto Final.
  • Se o ponto final do agente estiver em uma tenancy diferente da tenancy em que você está criando a ferramenta Agente, obtenha o OCID do ponto final do agente. Se precisar de ajuda, consulte Obtendo Detalhes de um Ponto Final.