# 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:36:27.140Z

## Página

- Título: Apresentação e coleta
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/apresentacao-e-coleta
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Executa um procedimento compartilhado fixo ou indicado por um registro da lista.

## Seções

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

## Conteúdo da página

# Apresentação e coleta

Este bloco aplica um procedimento cadastrado separadamente, com apresentação, perguntas, regras e saídas. É indicado para reutilizar o mesmo roteiro em agentes diferentes e variar os dados por registro.

## 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 **Apresentação e coleta**.

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

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **Procedimento** | Escolha a origem fixa ou o procedimento indicado pelo registro da lista. |
| **Procedimento fixo** | Selecione um procedimento ativo. |
| **Lista e campo de procedimento** | Para origem no registro, escolha o campo de referência a procedimento disponibilizado ao agente. |
| **Parâmetros** | Associe os parâmetros declarados a valores fixos ou informações do contexto. |
| **Saídas** | Confira os identificadores e rótulos dos resultados compatíveis com os roteiros utilizados. |
| **Guardar resultado** | Organiza o resumo da execução no contexto. |

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

Recebe uma entrada. Cada resultado declarado no procedimento gera uma saída própria neste bloco. Essas saídas continuam dentro do construtor do agente; para sair ao bot, conecte a um bloco de retorno.

Uma decisão antecipada pode encerrar a coleta antes das perguntas seguintes e continuar pela saída correspondente.

## Exemplo de uso

Use o procedimento `Qualificação para demonstração`. A saída `qualificado` pode continuar o processo, e `sem_interesse` pode devolver o atendimento ao bot. Se uma lista define roteiros diferentes, eles precisam ter saídas compatíveis com o bloco e os parâmetros obrigatórios mapeados.

## Cuidados

A origem por registro exige que o registro da lista já esteja ativo. Um procedimento compartilhado afeta os agentes que o reutilizam; revise os vínculos antes de editar. Alterar as saídas exige revisar os conectores no agente.

## Como testar

Execute um caso completo e um encerramento antecipado. Reaproveite um dado já conhecido e teste outro roteiro da mesma lista. O [guia de cadastro do procedimento](/docs/configuracao/inteligencia-artificial/agentes-avancados/cadastrar-procedimento) traz um exemplo passo a passo.

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