# 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:44:01.643Z

## Página

- Título: Alterar entidade
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/alterar-entidade
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Atualiza um lead, contato ou empresa identificado no contexto ou por consulta.

## Seções

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

## Conteúdo da página

# Alterar entidade

Use **Alterar entidade** para atualizar um registro existente, preservando a identificação correta do alvo. Para leads, os campos incluem etapa, funil, ticket, origem e outras informações liberadas para o bloco.

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

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

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **Entidade** | Lead, contato ou empresa. |
| **Identificar a entidade** | Variável do contexto ou conversa e consulta ao CRM. |
| **Entidade a atualizar** | Caminho do registro quando a origem é o contexto, por exemplo `entities.lead.id`. |
| **Campos do CRM** | Somente os campos que esta operação deve alterar. |
| **Associar entidade à conversa** | Vincule o resultado à sala quando fizer parte do atendimento. |
| **Etiquetas e vínculos** | Escolha adicionar ou substituir, conforme a finalidade. |
| **Confirmação no uso interno** | Revise o comportamento para usuários internos. |
| **Guardar resultado** | Torna o resultado acessível às próximas etapas. |

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

Recebe uma entrada e possui **Depois · sequência**. As entradas são configuradas como valores fixos, informação do contexto ou dados obtidos na conversa.

## Exemplo de uso

Depois de confirmar uma demonstração, atualize a oportunidade vinculada à conversa para a etapa `Demonstração agendada`. Use o picker para a etapa ou uma referência compatível da lista. Mantenha nome e outros campos fora da operação se não precisam mudar.

## Cuidados

Não use um nome de pessoa como se fosse o identificador de uma entidade. No uso interno com busca pelo diálogo, habilite uma consulta ao CRM adequada e esclareça homônimos. Confira especialmente substituição de tags e mudanças de funil/etapa.

## Como testar

Teste entidade existente, entidade ausente, mudança somente dos campos pretendidos e política de confirmação interna. Verifique a etapa no CRM e a continuação do fluxo.

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