# 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:45:20.713Z

## Página

- Título: Coletar informações
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/coletar-informacoes
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Coleta e valida respostas diretamente no agente, aproveitando o contexto já conhecido.

## Seções

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

## Conteúdo da página

# Coletar informações

Use **Coletar informações** para perguntas específicas deste agente. Quando o roteiro deve ser compartilhado, ter apresentação e resultados próprios ou ser escolhido por uma lista, use **Apresentação e coleta**.

## 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 **Coletar informações**.

![Configuração do bloco Coletar informações no construtor de Agentes Avançados](/docs/screenshots/agentes-avancados/coletar-informacoes.png)

## Campos principais

| Configuração | Como usar |
| --- | --- |
| **O que a IA deve perguntar?** | Texto claro da pergunta; pode usar variáveis disponíveis. |
| **Formato da resposta** | Texto, sim/não, uma ou várias opções, número, data, data/hora ou lista de textos. |
| **Resposta obrigatória** | Exige uma resposta válida quando a pergunta for aplicável. |
| **Quando perguntar** | Condições baseadas em informações já disponíveis. |
| **Fazer esta pergunta separadamente** | No modo flexível, aguarda o momento desta pergunta antes de aceitar a resposta. |
| **Aproveitar informações já conhecidas** | Origem de contexto que dispensa a pergunta quando o valor é válido. |
| **Configurações avançadas** | Nome curto, orientação de interpretação, identificador e propriedades dinâmicas. |
| **Guardar resultado** | Nome do resultado para etapas seguintes. |

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

Recebe uma entrada e possui **Depois · sequência**, executada quando a coleta aplicável termina. Respostas ficam em `values.<identificador>` e podem alimentar condições, entidades e integrações.

## Exemplo de uso

Pergunte nome e e-mail. Se o nome já veio de uma entrada do bot, configure sua origem como `vars.nome`. Ao concluir, crie o contato usando `values.nome` e `values.email`.

## Cuidados

Um campo marcado como obrigatório só é exigido quando suas condições se aplicam. Valor inicial é uma resposta efetiva, não um exemplo. Não use uma dependência de pergunta futura; preserve a ordem de perguntas que alimentam outras condições.

## Como testar

Teste resposta inválida, condição que oculta uma pergunta e informação válida já conhecida. Confira a continuação somente após a coleta necessária.

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