# 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:42:01.347Z

## Página

- Título: Cadastrar um procedimento de coleta
- URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/agentes-avancados/cadastrar-procedimento
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Crie um roteiro reutilizável de perguntas, validações e saídas por condição, com um exemplo de qualificação comercial.

## Seções

- Exemplo: qualificação para uma demonstração
- Abra o cadastro
- 1. Escreva a apresentação
- 2. Cadastre a primeira pergunta
- 3. Adicione a pergunta de interesse
- 4. Encerre antecipadamente quando a resposta não atender
- 5. Defina o resultado padrão
- 6. Salve e conecte ao agente

## Conteúdo da página

# Cadastrar um procedimento de coleta

Um procedimento reúne apresentação, perguntas e decisões em um cadastro reutilizável. Ele pode ser usado em vários agentes. Os dados que variam entre serviços, campanhas ou processos podem vir de uma lista do CRM ou de parâmetros, sem copiar todo o roteiro.

O procedimento conduz a conversa dentro do agente de IA. Suas saídas podem executar outras capacidades e, depois, retornar ao fluxo do bot.

## Exemplo: qualificação para uma demonstração

Vamos montar um roteiro simples:

1. Apresentar o propósito das perguntas.
2. Perguntar como a pessoa prefere ser chamada.
3. Perguntar se deseja conhecer a solução em uma demonstração.
4. Se responder **Não**, encerrar a coleta por **Sem interesse agora**.
5. Se responder **Sim**, concluir por **Quer uma demonstração**.

É um exemplo de serviço comercial; a mesma estrutura serve para suporte, cadastro, solicitações, matrículas ou outros processos.

## Abra o cadastro

Acesse :ScreenEntry{href="https://my.agilize.app/config/agent-procedures" label="Cadastrar procedimentos de coleta" path="Configurações > Configuração Básica > IA > Agentes Avançados > Procedimentos"} e crie um procedimento chamado `Qualificação para demonstração`.

![Cadastro do procedimento com roteiro à esquerda e edição da apresentação à direita](/docs/screenshots/agentes-avancados/procedimento-roteiro.png)

O **Roteiro** organiza as etapas. Clique em uma etapa para editá-la na área ao lado. A **Prévia** ajuda a conferir a leitura das perguntas e dos resultados antes de usar o procedimento no agente.

## 1. Escreva a apresentação

Na etapa **Apresentação**, use:

```text
Vou fazer duas perguntas rápidas para entender como podemos ajudar.
```

A mensagem inicial é opcional. Em **Condução da conversa**, escolha:

| Modo | Como funciona |
| --- | --- |
| **Roteirizada · seguir perguntas em ordem** | Preserva o texto das perguntas, substituindo as variáveis configuradas, e segue a sequência. |
| **Flexível · aproveitar o que a pessoa informar** | Aproveita respostas válidas já informadas e permite condução mais natural, mantendo condições e validações. |

Para este exemplo, use **Roteirizada**. Nos dois modos, a IA pode interpretar respostas abertas; ela não pode ignorar as condições definidas para o processo.

## 2. Cadastre a primeira pergunta

Clique em **+ Pergunta** e preencha:

| Campo | Valor do exemplo |
| --- | --- |
| **O que a IA deve perguntar?** | Como você prefere ser chamado? |
| **Formato da resposta** | Texto livre |
| **Resposta obrigatória** | Marcada |
| **Nome curto da informação** | Nome |
| **Identificador da resposta** | `nome` |

O identificador pode ser gerado automaticamente. Depois de utilizá-lo em condições ou integrações, mantenha-o estável. A resposta fica disponível em `values.nome`.

## 3. Adicione a pergunta de interesse

Crie outra pergunta:

| Campo | Valor do exemplo |
| --- | --- |
| **O que a IA deve perguntar?** | Você quer conhecer a solução em uma demonstração? |
| **Formato da resposta** | Sim ou não |
| **Resposta obrigatória** | Marcada |
| **Nome curto da informação** | Interesse na demonstração |
| **Identificador da resposta** | `interesse` |

![Edição de uma pergunta com resposta Sim ou não](/docs/screenshots/agentes-avancados/procedimento-pergunta.png)

Perguntas com escolhas podem gerar opções estruturadas conforme o canal. Para escolhas personalizadas, use **Escolher uma opção** e cadastre os rótulos em linguagem clara. Os códigos das respostas são usados nas condições; não compare apenas o texto visual se houver códigos diferentes.

## 4. Encerre antecipadamente quando a resposta não atender

Em **Saídas do procedimento**, clique em **+ Saída por condição**. Você também pode selecionar a pergunta e usar **+ Encerrar por condição** em **Depois da resposta**. Configure:

1. **Nome da saída**: `Sem interesse agora`.
2. **Quando avaliar**: após a pergunta sobre interesse.
3. Em **Se**, selecione a resposta **Interesse na demonstração** pelo seletor.
4. Em **Condição**, escolha **For igual a**.
5. Em **Valor**, escolha **Não**.
6. Em **Motivo registrado**, informe `Pessoa não deseja uma demonstração neste momento`.
7. Confira o identificador `sem_interesse` e a prioridade em **Identificador e prioridade**.

![Regra de encerramento avaliada após a resposta de interesse](/docs/screenshots/agentes-avancados/procedimento-saida-antecipada.png)

A decisão é avaliada no ponto configurado. Quando corresponde, a coleta termina sem exigir perguntas seguintes. Use respostas já disponíveis até aquele ponto: uma regra antecipada não pode depender de uma pergunta que ainda será feita.

Para uma regra avaliada apenas depois de todas as perguntas, mantenha **Ao concluir toda a coleta**. Se houver várias saídas compatíveis, revise a prioridade e os casos de sobreposição.

## 5. Defina o resultado padrão

Em **Saídas do procedimento > Quando nenhuma regra corresponder**, use o resultado `Quer uma demonstração`, com identificador `qualificado`.

O resultado padrão é usado quando a coleta aplicável foi concluída e nenhuma decisão configurada correspondeu. Ele não significa aprovação universal: seu nome e seu uso devem refletir o processo que você desenhou.

## 6. Salve e conecte ao agente

1. Marque **Ativo** e salve o procedimento.
2. No construtor do agente, adicione **Apresentação e coleta**.
3. Escolha um procedimento fixo e selecione `Qualificação para demonstração`.
4. Atualize ou revise as saídas do bloco.
5. Conecte **Quer uma demonstração** à próxima etapa desejada.
6. Conecte **Sem interesse agora** a uma mensagem/resultado apropriado; para devolver ao bot, use **Retornar ao bot** ou uma saída por regra configurada.

As saídas do procedimento são conectores internos do construtor. Para criar uma saída no fluxo de bot, o desenho também precisa de um bloco de retorno ao bot com uma chave própria.

Você pode editar o procedimento a partir do próprio construtor. O rodapé mostra os agentes vinculados; alterações no cadastro compartilhado afetam os próximos usos pelos agentes que o reutilizam. Confira os vínculos antes de salvar. Para uma variação independente, use **Criar cópia**.

## Aproveite o que já veio do bot

Em uma pergunta, abra **Aproveitar informações já conhecidas**. Em **Informação já conhecida**, selecione a entrada correspondente, por exemplo `vars.nome`.

Se a informação estiver presente e for válida, a pergunta é dispensada. Para obter `vars.nome` a partir de uma variável do bot, configure o mapeamento no [node Agente operacional](/docs/configuracao/referencias/nodes-fluxos-do-bot/agente-operacional).

Use **Valor inicial opcional** somente quando aquele valor já puder ser considerado uma resposta. Ele não funciona como sugestão visual para a pessoa.

## Personalize sem duplicar o roteiro

Em **Parâmetros e dados disponíveis**, você pode declarar parâmetros e mostrar campos de uma lista para facilitar a escolha de variáveis. Exemplos:

| Necessidade | Configuração possível |
| --- | --- |
| Mudar a apresentação por serviço | Incluir `{{ record.values.descricao }}` na mensagem. |
| Variar o mínimo de uma pergunta numérica | Usar um parâmetro numérico em um limite mínimo dinâmico. |
| Variar alternativas por registro | Usar um campo do contexto com uma lista de textos em **Opções disponíveis**. |
| Perguntar só em certos casos | Usar condições em **Quando perguntar**. |
| Manter uma pergunta separada no modo flexível | Marcar **Fazer esta pergunta separadamente**. |
| Escolher o roteiro por registro | Usar um campo de referência a procedimento na lista e a origem **Do registro da lista** no bloco. |

Declare os parâmetros necessários e mapeie-os no bloco **Apresentação e coleta**. Os tipos devem corresponder: um limite numérico não deve vir de um texto como `dez`.

## Teste antes de reutilizar

Confira pelo menos:

- nome ausente e nome já recebido do bot;
- resposta Sim e resposta Não;
- resposta ambígua, pedindo esclarecimento;
- encerramento antecipado sem criar a oportunidade indevidamente;
- resultado padrão e próxima etapa correta;
- mesma estrutura com outro registro ou conjunto de parâmetros;
- pedido de atendimento humano durante a coleta.

Veja [Testar o agente](/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente), [Listas do CRM](/docs/configuracao/crm-dados/listas-do-crm) e a [referência de Apresentação e coleta](/docs/configuracao/referencias/nodes-agentes-avancados/apresentacao-e-coleta).