> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/administracao-e-configuracao/artefatos/agentes/equipe-de-agentes.md).

# 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

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

### 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

{% stepper %}
{% step %}

#### Acesse o Portal de Administração

{% endstep %}

{% step %}

#### Navegue até Agentes

Navegue até **Artefatos > Agentes**.
{% endstep %}

{% step %}

#### Selecione a equipe de agentes

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

{% step %}

#### 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.
{% endstep %}

{% step %}

#### Selecione os especialistas

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

{% step %}

#### Salve a equipe

Clique em **Salvar equipe**. A mensagem **Equipe salva. Converse com o orquestrador para começar.** será exibida.
{% endstep %}
{% endstepper %}

### 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).

{% hint style="warning" %}

## <mark style="color:$warning;">A descrição do agente é essencial</mark>

<mark style="color:$warning;">O orquestrador utiliza a</mark> <mark style="color:$warning;"></mark><mark style="color:$warning;">**descrição**</mark> <mark style="color:$warning;"></mark><mark style="color:$warning;">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.</mark>
{% endhint %}

### 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**.

<table><thead><tr><th width="158">Agente</th><th width="196">Descrição fraca</th><th>Descrição recomendada</th></tr></thead><tbody><tr><td><strong>Fabric</strong></td><td>Relatórios no Fabric</td><td>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.</td></tr><tr><td><strong>Gestor de Demandas</strong></td><td>Sem descrição</td><td>Consulta e gerencia work items do Azure DevOps. Acione para listar tickets em aberto, verificar status, responsáveis e prazos de demandas.</td></tr><tr><td><strong>Financeiro</strong></td><td>Agente do financeiro</td><td>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.</td></tr></tbody></table>

{% hint style="info" %}

## <mark style="color:blue;">Dica</mark>

<mark style="color:blue;">**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.**</mark>
{% endhint %}

### 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.

{% hint style="danger" %}

## <mark style="color:$danger;">Atenção ao custo</mark>

<mark style="color:$danger;">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.</mark>
{% endhint %}