# 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-10-30T16:37:52.291Z

## Página

- Título: Criar um agente avançado
- URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/agentes-avancados/criar-agente
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Cadastre o agente, defina público e instruções, conecte capacidades e prepare o uso interno ou no chatbot.

## Seções

- Acesse o construtor
- Preencha o cadastro
- Configure o bloco Agente
- Adicione somente as capacidades necessárias
- Use o seletor de variáveis
- Salve, teste e libere
- Se algo não funcionar
- Próximos passos

## Conteúdo da página

# Criar um agente avançado

Monte um agente pequeno, com um objetivo claro, e amplie as capacidades depois de testar. Neste exemplo, o agente esclarece dúvidas comerciais e pode oferecer uma demonstração.

## Acesse o construtor

Acesse :ScreenEntry{href="https://my.agilize.app/config/agent-builder" label="Configurar um agente avançado" path="Configurações > Configuração Básica > IA > Agentes Avançados > Construtor Agentes Avançados"} e clique em **Novo agente**. O cadastro começa pelo formulário; o fluxo visual é aberto pelo botão **Abrir Editor de Fluxo**.

![Cadastro do agente com nome, descrição, público e acesso interno](/docs/screenshots/agentes-avancados/cadastro-agente.png)

## Preencha o cadastro

1. Em **Nome**, informe `Atendimento e agenda`.
2. Em **O que este agente faz?**, descreva o resultado: `Responde dúvidas comerciais e ajuda a agendar uma demonstração`.
3. Em **Este agente atende**, escolha o público.
4. Se houver uso interno, configure quem poderá encontrá-lo na Central de IA.
5. Abra o editor de fluxo.

| Público | Comportamento esperado |
| --- | --- |
| Clientes pelo chatbot | Atua no contexto da conversa externa. Ações seguem a autorização do fluxo, sem pedir ao cliente uma aprovação administrativa do CRM. |
| Equipe no CRM | Atua com o usuário interno. A política de confirmação de alterações pode pedir revisão antes de executar. |
| Equipe e clientes · configuração avançada | Permite ambos; revise em cada capacidade o público e as confirmações internas. |

**Disponibilizar na Central de IA** é uma configuração separada do público. Ao habilitá-la, escolha todos os usuários do projeto ou usuários/equipes selecionados. A equipe considerada é a equipe organizacional principal da pessoa. O acesso não amplia suas permissões de dados.

## Configure o bloco Agente

Abra o bloco **Agente**. Em **Como iniciar a execução**, mantenha **IA escolhe a capacidade conforme a conversa** para este exemplo.

Em **Objetivo e instruções**, escreva regras do seu atendimento. Por exemplo:

```text
Atenda com cordialidade e entenda a necessidade antes de sugerir uma demonstração.
Responda dúvidas usando as informações disponíveis.
Quando a pessoa demonstrar interesse, ofereça uma conversa com nossa equipe.
Se ela preferir atendimento humano, respeite essa preferência.
```

As capacidades já orientam seu próprio funcionamento. Não é necessário escrever no objetivo como resolver IDs, validar revisões de agenda ou executar controles internos do sistema.

## Adicione somente as capacidades necessárias

Arraste os blocos da biblioteca para o canvas e ligue uma saída do **Agente** à entrada de cada capacidade opcional:

- **Conhecimento**: informações comerciais autorizadas.
- **Agenda conectada**: uma agenda e as operações permitidas.
- **Atendimento humano**: situações em que a conversa deve voltar à equipe.

![Agente com três capacidades opcionais no canvas](/docs/screenshots/agentes-avancados/construtor-visao-geral.png)

Dê nomes que expliquem a ação, como `Agenda de demonstrações`. Use **Quando oferecer esta capacidade** para indicar situações do seu negócio. Conectar uma capacidade não obriga o agente a usá-la em todas as mensagens.

Para uma sequência obrigatória, conecte o início guiado a uma etapa executável. A saída **Depois · sequência** dos blocos pode levar a uma próxima ação. Essa próxima ação deve obter os dados de valores fixos ou do contexto; uma nova pergunta pertence a um bloco de coleta.

## Use o seletor de variáveis

Nos campos que aceitam contexto, use o botão de inserir variável. Ele mostra dados conhecidos pelo desenho atual: entradas do bot, respostas coletadas, resultados anteriores e campos de listas identificáveis na configuração.

| Origem | Exemplo de caminho |
| --- | --- |
| Entrada mapeada do bot | `vars.nome` |
| Resposta coletada | `values.email` |
| Campo do registro ativo | `record.values.descricao` |
| Resultado de capacidade | `results.consulta` |
| Entidade vinculada | `entities.lead.id` |

Se a lista só for conhecida durante a execução, o editor não consegue antecipar todos os campos. Defina um contrato de campos consistente entre as listas utilizadas e selecione o caminho compatível; confira o valor no teste.

## Salve, teste e libere

1. Salve o desenho.
2. Abra **Testar agente** e confira saudação, dúvida, interesse em agendamento e pedido de humano.
3. Resolva os avisos de configuração.
4. Marque **Agente ativo** e salve antes de selecioná-lo no bot.
5. Para uso externo, [conecte ao fluxo do bot](/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-fluxo-bot).

O editor salva a configuração do agente. Um procedimento compartilhado tem seu próprio salvamento: confira qual cadastro foi alterado antes de fechar.

## Se algo não funcionar

| Sintoma | O que conferir |
| --- | --- |
| Agente não aparece no bot | Ativo, público externo e projeto correto. |
| Não aparece na Central de IA | Uso interno habilitado, público interno compatível e usuário/equipe permitidos. |
| A ação ocorre cedo demais | Início guiado, conexões em sequência e instruções do negócio. |
| Campo necessário não aparece no seletor | Fonte conhecida pelo editor, resultado anterior e campos da lista disponíveis ao agente. |

## Próximos passos

- [Conectar uma agenda](/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-agenda).
- [Cadastrar um procedimento](/docs/configuracao/inteligencia-artificial/agentes-avancados/cadastrar-procedimento).
- [Referência de todos os nodes](/docs/configuracao/referencias/nodes-agentes-avancados).