Orquestração

Quando uma solução tem mais de um agente, a orquestração decide quem responde. A configuração fica em Configurações → Orquestração.

Os dois modos

Modo	Comportamento
Agente Único	Só o agente primário responde. Simples, previsível e mais barato.
Multi-Agente	A MarIA escolhe, a cada turno, um ou mais agentes com base nas descrições.

Comece sempre por Agente Único. Só mude para Multi-Agente quando existirem agentes com especialidades realmente distintas — atendimento e cobrança, por exemplo.

Agente primário

É o agente que responde por padrão e coordena os demais. Escolha o mais generalista: ele é quem recebe a mensagem quando nenhum outro é claramente mais adequado.

Máximo de Participant Runs por Turno

Limita quantos agentes podem ser acionados na mesma mensagem. Um número alto encarece cada turno e raramente melhora a resposta — veja o efeito no dashboard de consumo.

Narração do trace

Provedor, Modelo e Prompt da Narração do Trace definem como a MarIA descreve, em linguagem natural, o que aconteceu durante o turno — quais agentes participaram e quais ferramentas foram usadas. É o texto que aparece no bloco Atividade dentro do chat.

Use um modelo econômico aqui: a narração é um apoio de leitura, não a resposta ao usuário.

O que realmente decide a escolha

Não é a orquestração: é a descrição de cada agente. A MarIA compara a mensagem com as descrições e escolhe. Por isso:

• escreva descrições curtas, concretas e mutuamente exclusivas;
• evite descrições genéricas do tipo “responde dúvidas do cliente” em mais de um agente;
• se um agente nunca é escolhido, o problema quase sempre está na descrição dele — ou ele está inativo.