# 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:46:52.604Z

## Página

- Título: Localizar registro
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/localizar-registro
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Encontra um registro ativo de lista por um campo habilitado para busca.

## Seções

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

## Conteúdo da página

# Localizar registro

Use **Localizar registro** quando a identificação acontecer durante a conversa com a IA. Para identificar centenas de códigos antes da IA, use o node do bot **Carregar registro da lista**.

## 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 **Localizar registro**.

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

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **Obter lista de** | Lista escolhida no bloco ou referência de lista no contexto. |
| **Lista do CRM** / **Lista no contexto** | Identifique a fonte de registros. |
| **Campo de busca** | Campo habilitado com **Usar na busca**. Se a lista é dinâmica, informe seu identificador. |
| **Receber código exato** | Ativado: busca o código completo. Desativado: extrai termos do texto informado. |
| **Entradas da ferramenta** | Origem do texto ou código a pesquisar. |
| **Guardar resultado** | Disponibiliza o resultado para etapas posteriores. |

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

Recebe uma entrada e possui **Depois · sequência**. Com um único resultado, o registro torna-se o contexto ativo. Em ambiguidade, oferece escolhas; uma busca ampla demais solicita refinamento. Ausência de resultado não deve ser tratada como sucesso.

## Exemplo de uso

A pessoa informa `DEMO`. O bloco busca esse código na lista de serviços e disponibiliza os campos permitidos em `record.values`. O procedimento seguinte usa a descrição e as regras daquele registro.

## Cuidados

Há um único registro ativo por execução. O agente não deve trocar arbitrariamente o contexto no meio de uma coleta. Busca é filtrada pela lista, projeto e situação ativa; campos de referência não substituem um campo textual pesquisável.

## Como testar

Teste código válido, desconhecido e duplicado. Confira a escolha explícita quando houver mais de uma correspondência e a ausência de troca de registro durante uma coleta.

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