# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-22T05:54:14.956Z

## Página

- Título: Configurar assistentes de IA
- URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/configurar-assistentes-de-ia
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como combinar agente, skill e role para controlar comportamento, fontes de dados, público, contexto e propostas.

## Seções

- Antes de começar
- Acesse a configuração
- Entenda agente, skill e role
- Configure a skill
- Configure a role
- Monte o agente
- Teste antes de liberar
- Evite estes erros

## Conteúdo da página

# Configurar assistentes de IA

Um assistente é formado por três partes: o **agente** define identidade e público; a **skill** define como ele trabalha; e a **role** define quais fontes ele pode consultar e com quais limites.

---
title: "Composição de um assistente"
caption: "A habilidade pede; a role limita; o agente reúne tudo e define quem pode usar."
definition: |
  flowchart LR
    A[Skill: objetivo e instruções] --> D[Agente]
    B[Role: fontes e limites] --> D
    C[Público e áreas relacionadas] --> D
    D --> E[Assistente disponível]
    E --> F[Leituras autorizadas]
    E --> G[Propostas para revisão]
---

## Antes de começar

- É necessário ser administrador do projeto.
- Defina qual resultado o assistente deve entregar e quem realmente precisa usá-lo.
- Comece com o menor conjunto de fontes capaz de atender ao objetivo.
- Valide o assistente manualmente antes de usá-lo em uma rotina agendada.

## Acesse a configuração

Acesse :ScreenEntry{href="https://my.agilize.app/ai/settings" label="Configurar assistentes de IA" path="Configurações > IA > Configuração dos agentes"}.

![Formulário de configuração de um novo assistente de IA](/docs/screenshots/config-ia-assistentes.png)

## Entenda agente, skill e role

| Parte | Define | Exemplo |
| --- | --- | --- |
| Agente | Nome, ícone, skill, role, escopo, público, subagentes, áreas relacionadas e respostas rápidas. | `Analista comercial` disponível para gestores. |
| Skill | Objetivo, instruções, dados necessários e tipos de proposta que podem ser apresentados. | Analisar oportunidades e recomendar próximas ações. |
| Role | Fontes realmente permitidas, intensidade do trabalho e volume máximo por consulta. | CRM e BI, até 16 consultas com 25 registros cada. |

A skill não libera uma fonte sozinha. A role também precisa autorizar o recurso solicitado. Tudo que não estiver permitido permanece bloqueado.

## Configure a skill

1. Abra a seção **Skills** e crie um cadastro.
2. Dê um nome orientado ao resultado e uma descrição curta.
3. Nas instruções, descreva objetivo, critérios, limites e formato da resposta.
4. Marque apenas os dados necessários.
5. Escolha quais tipos de proposta podem ser apresentados.
6. Ative e salve.

As propostas ficam aguardando revisão e aplicação manual. Entre as áreas disponíveis estão textos e e-mails, marketing, fluxos de chatbot, automações de CRM, webhooks e recomendações genéricas.

## Configure a role

1. Abra **Roles** e crie um cadastro.
2. Escolha as fontes que a role pode consultar.
3. Defina a intensidade máxima, de 8 a 40 consultas por execução.
4. Defina o volume máximo por consulta, de 10 a 200 registros.
5. Ative e salve.

Limites maiores podem ampliar custo, duração e volume analisado. Comece com **Equilibrada** e aumente somente quando um caso validado exigir.

## Monte o agente

1. Abra **Agentes** e clique em criar.
2. Informe nome, ícone e descrição.
3. Selecione a skill principal e a role de acesso.
4. Escolha o escopo dos registros:
   - **Somente dados do executor** inclui a pessoa que iniciou a execução nas consultas;
   - **Todos os dados já autorizados** usa o escopo de projeto, empresa e equipes que essa pessoa já possui.
5. Se necessário, restrinja o público por pessoas ou equipes organizacionais.
6. Adicione subagentes apenas quando houver uma divisão clara de especialidades.
7. Escolha as áreas em que o agente deve ser recomendado primeiro.
8. Cadastre até seis respostas rápidas para pedidos recorrentes.
9. Defina se o agente é exclusivo para administradores e deixe-o disponível.
10. Salve e execute testes com usuários representativos.

Se pessoas e equipes autorizadas ficarem vazias, qualquer usuário que já tenha acesso ao recurso de IA poderá usar o agente. Para equipes, a verificação considera a equipe organizacional principal do usuário.

## Teste antes de liberar

Valide pelo menos estes cenários:

- usuário permitido e usuário fora do público;
- registro próprio e registro fora do escopo;
- resposta com dados existentes e pedido com informação ausente;
- tentativa de consultar uma fonte não autorizada;
- proposta que exige revisão antes da aplicação;
- consumo de créditos em uma solicitação curta e em outra mais ampla.

## Evite estes erros

| Erro | Risco | Correção |
| --- | --- | --- |
| Skill ampla e role ampla sem objetivo definido | Respostas genéricas e consultas desnecessárias. | Restrinja objetivo, fontes e formato esperado. |
| Usar acesso amplo para compensar falta de configuração | Exposição desnecessária de dados autorizados. | Comece pelo escopo do executor e amplie com justificativa. |
| Liberar para toda a empresa no primeiro teste | Resultado inconsistente em perfis diferentes. | Teste primeiro com pessoas ou uma equipe controlada. |
| Criar respostas rápidas vagas | Pedidos sem período, critério ou saída clara. | Escreva a mensagem completa que será enviada ao agente. |
| Ativar rotina antes do teste manual | Erros recorrentes e consumo de créditos. | Valide o mesmo prompt na Central de IA antes de agendar. |

## Guias relacionados

- [Usar os assistentes de IA](/docs/usuarios/inteligencia-artificial/usar-assistentes-de-ia)
- [Rotinas de IA](/docs/configuracao/inteligencia-artificial/rotinas-de-ia)
- [Créditos e quotas de IA](/docs/configuracao/inteligencia-artificial/creditos-e-quotas-de-ia)