Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Introdução às Transferências entre Múltiplos Agentes

Aula 12 de 18 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Por que orquestrar múltiplos agentes?
  2. Como funcionam as transferências
  3. Arquitetura típica
  4. Modos de execução
  5. Eventos de saída
  6. Pontos-chave

Por que orquestrar múltiplos agentes?

Até agora, trabalhou com agentes individuais: um agente, as suas instruções, as suas ferramentas. Este modelo atinge rapidamente os seus limites quando uma tarefa exige competências heterogéneas. Tome o exemplo de um pedido de investigação de mercado: precisa de pesquisar dados, analisá-los numericamente e, em seguida, produzir um relatório legível. Poderia tentar entregar tudo a um único agente, com instruções que incham a cada nova exigência até se tornarem num bloco de texto contraditório que o modelo aplica cada vez menos eficazmente. A API Mistral oferece uma alternativa: cadeias de agentes especializados que passam o testemunho.

Este é o conceito de transferência (handoff): um agente transfere o controlo da conversa para outro agente melhor equipado para a subtarefa atual. A conversa em si não muda; apenas muda a mão que segura as rédeas.

Como funcionam as transferências

O mecanismo espelha exatamente o que uma organização humana faz quando enfrenta um pedido composto. Um agente roteador recebe o pedido inicial, tal como uma telefonista que atende uma chamada. Analisa o pedido, identifica qual o agente especialista melhor posicionado para o tratar e, em seguida, transfere a conversa para esse especialista. O especialista trata da sua subtarefa e, se detetar uma necessidade fora do seu âmbito, pode transferir para um terceiro agente. A resposta final flui de volta para o utilizador, que vê apenas um único interlocutor.

Daqui decorrem quatro benefícios, que se reforçam mutuamente. Primeiro, a especialização: cada agente tem um âmbito limitado e instruções precisas. O agente de pesquisa na web não trata de cálculos e vice-versa. Isto melhora a qualidade da resposta, pois nenhuma instrução contradiz outra. Segundo, a manutenibilidade: alterar o comportamento de um especialista não impacta os outros. Pode trocar o seu modelo, instruções ou ferramentas sem tocar no resto do sistema. Terceiro, a escalabilidade segue diretamente — adicionar uma capacidade significa criar um novo agente especialista e registá-lo como alvo de transferência. O roteador seleciona-o então quando o pedido corresponde. Finalmente, a rastreabilidade: cada transferência gera um evento agent.handoff nas saídas, permitindo-lhe reconstruir a posteriori qual o agente que tratou cada parte do pedido, sem precisar de instrumentar nada por sua conta.

Arquitetura típica

User
    │
    ▼
Router Agent (orchestrator)
    ├── Web Search Agent (web_search)
    ├── Calculator Agent (code_interpreter)
    ├── Writer Agent (specific instructions)
    └── Document Agent (document_library)

O roteador decide dinamicamente para qual agente transferir com base no pedido. Não está limitado a uma única transferência: pode também orquestrar fluxos sequenciais, como pesquisar, depois calcular e depois escrever, enriquecendo cada passo o contexto para o seguinte.

Vamos acompanhar um pedido real: “Encontre a taxa de juro atual do BCE e calcule o efeito composto ao longo de 10 anos para um investimento de 100 000 €”. O agente Financeiro, atuando como roteador, recebe o pedido e vê que este contém duas necessidades distintas. Transfere primeiro para o agente de Pesquisa na Web, que obtém a taxa atual do BCE — um dado que nenhum modelo pode conhecer de memória. Uma segunda transferência passa o controlo ao agente Calculadora, que aplica a fórmula de juros compostos à taxa acabada de encontrar. O utilizador recebe um único resultado, acompanhado das fontes da pesquisa e dos detalhes do cálculo.

Modos de execução

A API Mistral oferece dois modos para as transferências, e a escolha faz-se no arranque da conversa. O modo servidor é o padrão.

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Complex query",
    handoff_execution="server"
)

A Mistral trata então automaticamente de tudo: transferências, execução dos agentes e síntese da resposta. Recebe apenas o resultado final, o que é conveniente e suficiente enquanto não precisar de interpor nada entre os passos.

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Complex query",
    handoff_execution="client"
)

No modo cliente, recebe eventos de transferência e decide o que fazer em cada passo. Escolha este modo quando um humano tiver de aprovar uma transferência sensível, quando precisar de registar cada transferência para fins de auditoria, ou quando a sua lógica de negócio exigir um roteamento que o modelo não consegue inferir. A lição dedicada a estes dois modos detalhará as compensações envolvidas.

Eventos de saída

Quando ocorre uma transferência, surgem três tipos de eventos nas saídas:

  • agent.handoff — O Agente A transfere para o Agente B (contém os IDs de ambos os agentes)
  • tool.execution — O Agente B executa as suas ferramentas
  • message.output — Resposta do Agente B
for entry in response.outputs:
    if entry.type == "agent.handoff":
        print(f"Transfer: {entry.previous_agent_id} → {entry.next_agent_id}")
    elif entry.type == "tool.execution":
        print(f"Tool executed: {entry.tool_name}")
    elif entry.type == "message.output":
        print(f"Response: {entry.content}")

Escreva este ciclo durante os seus primeiros testes, mesmo antes de o sistema estar completo. Um sistema multiagente que responde corretamente, mas cujo percurso não consegue rastrear, torna-se impossível de corrigir no dia em que responder mal: não saberá se o roteador encaminhou mal, se o especialista teve um mau desempenho ou se a transferência se perdeu pelo caminho. Três instruções print bem colocadas poupam-no a esta cegueira.

Pontos-chave

  • As transferências permitem que um agente transfira o controlo para outro agente especializado
  • Arquitetura típica: agente roteador → agentes especialistas
  • Modo servidor = totalmente automático; modo cliente = controlo manual das transferências
  • Cada transferência gera um evento rastreável nas saídas
  • Não há limite para a profundidade da cadeia entre agentes