Delegação entre agentes
O que é a delegação entre agentes
A maioria das organizações acaba com mais de um agente, cada um bom em algo diferente: um que conhece o funil de vendas, outro que conhece o faturamento, outro que domina um produto técnico. Antes disso, um agente que encontrasse uma pergunta fora da sua área só podia responder com conhecimento geral ou pedir que a pessoa perguntasse em outro lugar.
Com a delegação, o primeiro agente (o agente que chama) pode levar a pergunta a um segundo agente (o agente consultado) no meio da conversa, esperar a resposta e incorporá-la à sua. A pessoa que conversa permanece numa única conversa o tempo todo.
O agente consultado responde com as suas próprias instruções, as suas próprias ferramentas e o seu próprio acesso a dados — e esse é justamente o objetivo. Você não precisa copiar o conhecimento de um agente para outro para torná-lo disponível.
O que o agente consultado pode e não pode fazer
Uma consulta é deliberadamente limitada. É uma pergunta e uma resposta, não uma transferência de controle.
| Comportamento | O que isso significa para você |
|---|---|
| É executado com a identidade da pessoa que usa o assistente | O agente consultado vê exatamente o que essa pessoa já podia ver, nada além. A delegação nunca amplia o acesso a dados de ninguém. |
| Não pode alterar nada por conta própria | Se o agente consultado propuser uma ação — criar um registro, enviar um e-mail —, essa proposta volta para a conversa original para que a pessoa confirme. Nunca é executada silenciosamente. |
| Fica guardada como a sua própria conversa | Cada consulta é registrada separadamente, então depois você consegue ver o que foi perguntado e o que voltou. Útil para auditoria e para verificar se o agente especializado está respondendo bem. |
| Custa um turno adicional | Uma consulta é um segundo agente fazendo trabalho real, então consome créditos além da conversa original. A profundidade (abaixo) é o que mantém esse custo sob controle. |
| Só acontece quando instruído | Ativar o recurso não faz os agentes começarem a consultar uns aos outros. As instruções do agente que chama precisam dizer quando uma pergunta pertence a um especialista. |
Como ativar
É preciso ativar duas configurações, e elas ficam no agente que vai responder, não no que pergunta. Ambas começam desativadas, então uma atualização nunca muda o comportamento dos seus agentes atuais.
- Vá em Iniciador de aplicativos → REDA AI → Definições de Agente e abra o agente que você quer disponibilizar para consultas: o especialista.
- Na seção Agent Collaboration, marque Agent Invocable. É isso que torna o agente visível para outros agentes.
- No mesmo registro, confirme que Allow Automated Requests também está marcado. Uma consulta chega como uma solicitação automatizada, portanto as duas são necessárias. Se apenas uma estiver ativada, o agente que chama recebe uma mensagem nomeando a configuração que falta — ele não falha em silêncio.
- Salve.
- Agora abra o agente que deve poder perguntar — o generalista — e defina Max Agent Call Depth (veja abaixo). Deixe em
1a menos que tenha um motivo para mudar. - Por fim, diga ao agente que chama quando consultar, nas instruções dele. Por exemplo: “Para perguntas técnicas detalhadas sobre o equipamento instalado, consulte o agente Especialista Técnico e resuma a resposta dele.” Sem isso, o recurso fica sem uso.
Até onde as consultas podem ir
Max Agent Call Depth é definido no agente que inicia a conversa e limita quantos níveis de consulta uma pergunta pode desencadear.
| Valor | O que acontece | Quando usar |
|---|---|---|
0 | Este agente nunca consulta ninguém. | Um agente que você quer manter estritamente autossuficiente. |
1 (padrão) | Pode consultar um agente. Esse agente responde diretamente e não pode consultar um terceiro. | Quase sempre. Um único salto cobre o caso “pergunte ao especialista” com custo e velocidade previsíveis. |
2 ou mais | As consultas podem encadear: o agente consultado pode, por sua vez, consultar outro. | Raramente. Cada nível acrescenta tempo de resposta e créditos, então aumente apenas para um caso que você realmente viu precisar. |
Em branco, o campo se comporta como 1. Um agente nunca pode consultar a si mesmo, e uma cadeia que voltaria a um agente que já faz parte dela é interrompida — então um conjunto circular de instruções não sai do controle.
O que a pessoa na conversa vê
A consulta não aparece como uma etapa separada na transcrição. A pessoa vê a resposta do agente que chama, que contém a informação, e um indicador de que uma ferramenta foi usada.
Se você quiser que as pessoas saibam qual agente foi consultado — muitas vezes vale a pena, porque explica de onde vem a autoridade da resposta —, instrua o agente que chama a dizer isso. Por exemplo: “Quando consultar outro agente, comece a sua resposta nomeando-o.” O agente passará então a abrir com algo como “Consultei o Especialista Técnico —” antes de dar a resposta.
Quando usar e quando não
Boa aplicação: você tem conhecimento especializado real que vive num agente — um produto, uma norma, um processo — e outros agentes esbarram o tempo todo em perguntas sobre ele. A delegação permite que esse conhecimento continue num só lugar, mantido uma única vez, e ainda assim acessível de todos os lugares.
Má aplicação: dois agentes que precisam da mesma informação de base. Duplicar um conjunto curto de instruções é mais simples e mais barato do que uma consulta em cada conversa. A delegação compensa quando o especialista é realmente profundo, não quando é apenas um parágrafo que o outro agente poderia ter carregado consigo.
Por que uma consulta não aconteceu
Quando uma consulta não pode prosseguir, o agente que chama é informado do motivo e segue com o que já sabe, em vez de fazer a conversa falhar. Estes são os motivos que você verá.
| O que o agente informa | O que fazer |
|---|---|
| O agente não está disponível para ser consultado | Marque Agent Invocable nesse agente. |
| O agente não está configurado para responder a solicitações de outros agentes | Marque Allow Automated Requests nesse agente. As duas configurações são necessárias. |
| Nenhum agente foi encontrado com esse ID | As instruções do agente que chama nomeiam um agente que não existe. Confira a grafia na lista de Definições de Agente. |
| O agente não está ativo | Ative o agente especializado, ou aponte as instruções para um que esteja ativo. |
| O limite de consultas foi atingido | Esperado quando uma cadeia atinge o Max Agent Call Depth. Aumente apenas se a cadeia for realmente necessária. |
| Não há capacidade de processamento suficiente nesta solicitação para consultar outro agente | Acontece em conversas muito longas ou pesadas — o agente responde com o que já tem. Nenhuma alteração de configuração é necessária; se persistir, encurte a conversa ou pergunte diretamente ao agente especialista. |
| Um agente não pode consultar a si mesmo | As instruções apontam para o próprio nome do agente. Aponte-as para o especialista. |