Equipe de Agentes

A funcionalidade Equipe de Agentes permite montar uma estrutura Multiagentes no Power Omni, utilizando o protocolo A2A (Agent-to-Agent). Nela, um Agente Orquestrador coordena a conversa com o usuário e aciona Agentes Especialistas sempre que precisar de um conhecimento ou de uma integração específica, reunindo as respostas em um único retorno.

Na prática, o usuário conversa com um único agente, e esse agente decide sozinho quando consultar o agente de Fabric, o de Azure DevOps, o do Financeiro ou qualquer outro especialista da equipe.

Conceitos

Termo	Descrição
Agente Orquestrador	Agente com o qual o usuário conversa. Ele interpreta a solicitação, decide quais especialistas consultar e consolida as respostas.
Agentes Especialistas	Agentes que o orquestrador pode consultar. Cada um mantém suas próprias instruções, modelo, conectores e permissões.
A2A (Agent-to-Agent)	Protocolo de comunicação entre agentes. Um agente só pode ser consultado por outro quando está habilitado para A2A
Equipe de agentes	Conjunto formado por um orquestrador e até 10 especialistas.

Principais Benefícios

• Um único ponto de conversa: o usuário não precisa saber qual agente atende cada assunto. Basta conversar com o orquestrador.

• Especialização: cada agente continua focado no seu domínio, com instruções e conectores próprios, o que gera respostas mais precisas.

• Reaproveitamento: agentes já existentes podem ser combinados em novas equipes sem precisar ser recriados.

• Governança preservada: as permissões de acesso e o registro de consumo de cada agente continuam valendo dentro da equipe.

Configurando uma Equipe de Agentes

1

Acesse o Portal de Administração

2

Navegue até Agentes

Navegue até Artefatos > Agentes.

3

Selecione a equipe de agentes

Na linha do agente que será o orquestrador, clique no botão Equipe de agentes na coluna Ações.

4

Defina o Agente Orquestrador

No painel Equipe de agentes, confirme ou selecione o Agente Orquestrador. Esse é o agente com o qual os usuários vão conversar.

5

Selecione os especialistas

Em Quais agentes ele pode consultar?, marque os especialistas desejados. Utilize o campo Buscar agente pelo nome para localizar agentes rapidamente.

6

Salve a equipe

Clique em Salvar equipe. A mensagem Equipe salva. Converse com o orquestrador para começar. será exibida.

Regras da Equipe

• É possível selecionar até 10 especialistas por orquestrador.

• Ao salvar, os especialistas selecionados são habilitados para A2A automaticamente.

• Cada usuário só poderá consultar, por meio do orquestrador, agentes aos quais já tem acesso. A equipe não concede acesso a agentes restritos.

• O consumo de tokens é registrado por agente, ou seja, cada especialista acionado contabiliza seu próprio uso.

Permitir que Outros Agentes Consultem este Agente (A2A)

No final do painel, a opção Permitir que outros agentes consultem este agente (A2A) controla se o agente em questão pode ser chamado como especialista por outros orquestradores.

• Ativada: o agente fica disponível para ser consultado via A2A.

• Desativada: o agente não pode ser consultado por outros agentes, a menos que seja selecionado como especialista em uma equipe (o que o habilita automaticamente ao salvar).

A descrição do agente é essencial

O orquestrador utiliza a descrição de cada especialista para decidir qual deles acionar. Agentes sem descrição são identificados apenas pelo nome (aparecem como "Sem descrição. O agente será identificado pelo nome."), o que reduz muito a precisão do roteamento. Antes de montar uma equipe, garanta que todos os especialistas tenham uma descrição clara e objetiva.

Como Escrever uma Boa Descrição

Uma boa descrição diz o que o agente sabe fazer, quais dados ou sistemas ele acessa e quando deve ser acionado.

Agente	Descrição fraca	Descrição recomendada
Fabric	Relatórios no Fabric	Consulta os relatórios e modelos semânticos da Power Tuning no Microsoft Fabric. Acione para perguntas sobre indicadores, evolução de clientes, faturamento e métricas comerciais.
Gestor de Demandas	Sem descrição	Consulta e gerencia work items do Azure DevOps. Acione para listar tickets em aberto, verificar status, responsáveis e prazos de demandas.
Financeiro	Agente do financeiro	Responde dúvidas sobre contas a pagar e a receber, reembolsos e políticas financeiras internas. Acione para assuntos de pagamentos, notas e prazos financeiros.

Dica

Evite especialistas com descrições parecidas na mesma equipe. Quanto mais distinto for o escopo de cada um, mais fácil será para o orquestrador escolher o agente certo.

Identificando um Agente Orquestrador

Agentes configurados como orquestradores exibem o ícone de Multiagentes (👥) ao lado do nome.

• No Portal de Administração: na listagem de Agentes, ao passar o mouse sobre o ícone, é exibida a indicação Agente Orquestrador - Multiagentes.

• No Portal do Usuário: o ícone aparece no menu lateral de Agentes e no card do agente no Hub de Agentes.

Utilizando a Equipe no Chat

Para o usuário, o uso é transparente: basta abrir uma conversa com o Agente Orquestrador e fazer a pergunta normalmente.

Quando o orquestrador identifica que precisa de um especialista, o chat exibe a indicação Chamando agente: seguida do nome do especialista acionado. Ao final, o orquestrador reúne as informações e apresenta a resposta.

Exemplos

• "Consulte no Fabric a evolução da Power Tuning em clientes" → o orquestrador aciona o agente Fabric.

• "Consulte os tickets em aberto do Azure DevOps" → o orquestrador aciona o agente Gestor de Demandas - Azure DevOps.

Permissões e Consumo

• Permissões: o orquestrador respeita as permissões de cada usuário. Se o usuário não tiver acesso a um especialista (diretamente, por grupo ou por área de trabalho), esse especialista não será consultado em nome dele.

• Consumo: cada agente acionado tem seu consumo de tokens registrado individualmente, podendo ser acompanhado no Monitoramento e em Auditorias > Consumo de Tokens.

• Orçamento: como o consumo é contabilizado por agente, os limites definidos em Orçamento também se aplicam aos especialistas.

Atenção ao custo

Uma única pergunta ao orquestrador pode acionar vários especialistas, e cada um deles consome tokens com o seu próprio modelo. Acompanhe o consumo das equipes e prefira especialistas com modelos adequados ao tipo de tarefa.