# 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:11.964Z

## Página

- Título: Agente
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/agente
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Define objetivo, instruções, início da execução e capacidades disponíveis.

## Seções

- Onde configurar
- Campos principais
- Entradas, saídas e execução
- Exemplo de uso
- Cuidados
- Como testar

## Conteúdo da página

# Agente

O bloco **Agente** é o ponto inicial do construtor. Ele apresenta as capacidades disponíveis para a IA e define como a conversa deve começar. Use um único bloco Agente por desenho.

## Onde configurar

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"}, abra o editor visual e selecione **Agente**.

![Configuração do bloco Agente no construtor de Agentes Avançados](/docs/screenshots/agentes-avancados/agente.png)

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **Nome do bloco** | Identificação curta no canvas. |
| **Como iniciar a execução** | Escolha capacidades opcionais ou início obrigatório. |
| **Objetivo e instruções** | Descreva objetivo, tom e regras do negócio. O editor ampliado permite trabalhar com textos maiores. |
| **Continuar o pedido após confirmar uma ação interna** | No uso interno autônomo, permite continuar o pedido após a confirmação. |
| **Etapas por resposta** | Limite de 2 a 8 etapas; a execução pode parar antes por conclusão ou espera. |

## Entradas, saídas e execução

Não recebe entrada. Cada saída criada por **+ Capacidade** pode apontar para uma capacidade diferente.

No modo autônomo, as conexões oferecem ações possíveis. No modo guiado, a primeira conexão é o **Início obrigatório** e as demais continuam opcionais. Esse início precisa ser executável e obter suas entradas de valores fixos ou do contexto.

## Exemplo de uso

Para um assistente comercial, conecte Conhecimento, Agenda conectada e Atendimento humano. Escreva nas instruções que a demonstração deve ser oferecida após entender o interesse. Uma saudação não exige consultar a agenda.

## Cuidados

Não transforme toda capacidade em obrigação no prompt. Use sequências para as etapas obrigatórias e reserve as instruções para as regras do atendimento. Confira os públicos no cadastro do agente e em suas capacidades.

## Como testar

Teste saudação, dúvida e pedido explícito de uma ação. Confira se apenas as capacidades relevantes são usadas.

Veja [Testar o agente](/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente) e [todos os nodes](/docs/configuracao/referencias/nodes-agentes-avancados).