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

# Agentes

O menu **Agentes** é onde você cria, edita e configura os assistentes de IA do Power Omni.

Cada agente pode ter seu próprio nome, avatar, descrição, modelo de IA, esforço de raciocínio, instruções, conectores e permissões de acesso. Isso permite criar agentes específicos para diferentes áreas, como atendimento, financeiro, RH, jurídico, suporte técnico, busca na web ou análise de documentos.

### Tela principal de agentes

A tela principal exibe todos os agentes configurados no ambiente.

Nessa tela, é possível acompanhar as principais informações de cada agente, como modelo utilizado, orçamento, valor consumido e ações disponíveis.

<figure><img src="/files/P4bev7igUdFYdCHIqemz" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="207">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td>Nome</td><td>Nome do agente exibido para os usuários.</td></tr><tr><td>Modelo</td><td>Modelo de IA utilizado pelo agente.</td></tr><tr><td>Orçamento</td><td>Valor de orçamento configurado para o agente. Quando não houver orçamento definido, será exibido “-”.</td></tr><tr><td>Uso</td><td>Valor consumido pelo agente até o momento.</td></tr><tr><td>Ações</td><td>Opções para editar, excluir ou acessar configurações adicionais do agente.</td></tr></tbody></table>

Essa visão ajuda os administradores a acompanhar quais agentes estão ativos, quais modelos estão sendo usados e quanto cada agente já consumiu.

### Como criar ou editar um agente

Para criar um novo agente, clique em **Criar**.

Para editar um agente existente, clique no ícone de edição na linha do agente desejado.

<figure><img src="/files/HPa3YmztgA9lro43G3mC" alt=""><figcaption></figcaption></figure>

Ao abrir o formulário lateral, você poderá configurar as informações principais do agente.

#### Avatar do agente

O avatar é a imagem que representa o agente dentro do Power Omni.

<figure><img src="/files/wXxNAhp8neGKA8vPegGI" alt=""><figcaption></figcaption></figure>

Ele ajuda os usuários a identificarem visualmente cada agente, principalmente quando existem vários agentes disponíveis no ambiente.

O Power Omni permite configurar o avatar de duas formas:

No **Avatar personalizado**, você pode enviar uma imagem própria para o agente. A imagem deve ter exatamente **150x150 pixels** e estar no formato **PNG ou SVG**.

No **Avatar da biblioteca**, você pode selecionar uma imagem já disponível na biblioteca do Power Omni.

#### Nome do agente

O campo **Nome** define como o agente será exibido para os usuários.

Use nomes simples e claros, que indiquem a finalidade do agente.

#### Descrição do agente

O campo **Descrição do Agente** é opcional, mas recomendado.

Ele ajuda os usuários a entenderem para que aquele agente serve antes de iniciar uma conversa.

#### Modelo

O campo **Modelo** define qual modelo de IA será usado pelo agente.

Modelos diferentes podem ter capacidades, desempenho e custos diferentes. Escolha o modelo de acordo com o objetivo do agente.

Um agente simples de dúvidas frequentes pode usar um modelo mais leve. Já um agente que precisa analisar documentos, interpretar informações ou responder perguntas mais complexas pode usar um modelo mais avançado.

#### Esforço de raciocínio padrão

O campo **Esforço de raciocínio padrão** define o nível de raciocínio que o agente deverá usar por padrão nas respostas.

<figure><img src="/files/p90cXBESeEmMjurltsHr" alt=""><figcaption></figcaption></figure>

Essa configuração permite ajustar se o agente deve responder de forma mais direta ou se deve pensar mais antes de responder.

As opções disponíveis são: Nenhum / Baixo / Médio / Alto

Use **Nenhum** ou **Baixo** para agentes mais simples, que precisam responder de forma rápida e direta.

Use **Médio** para a maioria dos agentes, quando é necessário equilibrar qualidade da resposta e tempo de execução.

Use **Alto** para agentes que precisam analisar melhor o contexto, comparar informações, interpretar documentos ou responder perguntas mais complexas.

Quanto maior o esforço de raciocínio, maior tende a ser a profundidade da resposta. Em alguns casos, isso também pode impactar o tempo de resposta e o consumo do modelo.

#### Instruções do agente

O campo **Instruções** define o comportamento do agente.

É nesse campo que você informa o papel do agente, como ele deve responder, quais tarefas deve executar e quais limites deve respeitar.

Exemplo:

Você é um agente inteligente responsável por buscar e recuperar, na internet, as solicitações feitas pelo usuário, organizando os resultados de forma clara, objetiva e útil.

As instruções devem ser claras e diretas. Quanto melhor forem as instruções, maior a chance do agente responder da forma esperada.

#### Melhorar com IA

O botão **Melhorar com IA** ajuda a ajustar o texto das instruções.

Use essa opção quando quiser transformar uma ideia simples em uma instrução mais completa e organizada.

Depois de usar a melhoria com IA, revise o texto antes de salvar.

O botão **Expandir** abre o campo de instruções em uma área maior.

### Conectores

Os conectores permitem que o agente acesse documentos, sistemas, páginas da internet ou ferramentas externas.

Exemplos:

Use conectores de documentos quando o agente precisar consultar arquivos internos.

Use Leitor de URL quando o agente precisar analisar páginas informadas por link.

Use Busca na Web quando o agente precisar consultar informações atualizadas na internet.

Use conectores como OpenAPI, Logic App, N8N, Fabric, SharePoint ou MCP quando o agente precisar se integrar a sistemas externos.

Habilite apenas os conectores necessários para o objetivo do agente.

### Permissões

As permissões definem quais usuários ou grupos poderão visualizar e interagir com o agente.

Essa configuração ajuda a organizar o acesso por área, time ou função.

Exemplos:

Um agente de RH pode ser liberado apenas para o time de Recursos Humanos.

Um agente financeiro pode ser liberado apenas para usuários da área financeira.

Um agente de atendimento geral pode ser liberado para todos os usuários.

{% hint style="info" %} <mark style="color:$tint;">Revise as permissões antes de disponibilizar o agente para uso.</mark>
{% endhint %}

### Boas práticas

Use nomes claros para os agentes.

Adicione uma descrição curta para explicar a finalidade do agente.

Configure um avatar para facilitar a identificação visual.

Escolha o modelo de acordo com a complexidade da tarefa.

Ajuste o esforço de raciocínio conforme o tipo de resposta esperada.

Escreva instruções objetivas.

Habilite apenas os conectores necessários.

Acompanhe o campo **Uso** para entender o consumo de cada agente.

Teste o agente com perguntas reais antes de liberar para os usuários.

### Salvando o agente

Após preencher as informações, clique em **Salvar**.

Depois de salvar, recomendamos testar o agente no chat para validar nome, avatar, descrição, modelo, esforço de raciocínio, instruções, conectores e permissões.

### Precisa de ajuda?

{% hint style="info" %} <mark style="color:$primary;">Se tiver dúvidas sobre criação de agentes, escolha de modelo, esforço de raciocínio, instruções, conectores, orçamento ou consumo, entre em contato com o suporte do Power Omni.</mark>
{% endhint %}