# 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:38:28.487Z

## Página

- Título: Criar entidade
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/criar-entidade
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Cria lead, contato ou empresa com valores fixos, dados do contexto ou informações da conversa.

## Seções

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

## Conteúdo da página

# Criar entidade

Use **Criar entidade** para registrar o resultado útil de um atendimento no CRM. Escolha explicitamente o tipo de registro e as informações que a capacidade pode preencher.

## 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 **Criar entidade**.

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

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **Entidade** | Lead, contato ou empresa. |
| **Encontrar duplicidade** | Não verificar, buscar por telefone ou por e-mail. |
| **Associar entidade à conversa** | Cria o vínculo com a sala de origem quando o processo prevê isso. |
| **Adicionar campo adicional do CRM** | Seleciona um campo personalizado disponível para aquela entidade. |
| **Campos do CRM** | Escolha campo, origem do valor, tipo e obrigatoriedade. |
| **Como aplicar etiquetas e vínculos** | Revise substituição/adição de tags e relacionamentos. |
| **Confirmação no uso interno** | Em agentes internos, segue a política do agente ou uma escolha específica. |
| **Guardar resultado** | Nome para uso por outras etapas. |

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

Recebe uma entrada e possui **Depois · sequência**. Valores podem vir da conversa, do contexto ou de uma configuração fixa. A entidade criada/identificada pode ser reutilizada pelas etapas seguintes.

## Exemplo de uso

Após concluir uma qualificação, crie um lead com nome da coleta, funil fixo e tags vindas do registro da lista. Marque **Associar entidade à conversa** para que a sala fique vinculada ao lead.

## Cuidados

**Não verificar duplicidade** permite criar sem essa busca prévia. Para lead, configure o funil e revise sua etapa; a etapa precisa pertencer ao funil. Use referências reais do picker e marque dados obrigatórios de forma coerente. O telefone segue a validação/normalização do CRM.

## Como testar

Teste cadastro novo, duplicidade pelo critério escolhido, referência inválida e vínculo da conversa. Confira os campos no CRM, não somente a mensagem final da IA.

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