# 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:23.887Z

## Página

- Título: Consultar CRM
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/consultar-crm
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Permite ao usuário interno localizar registros e referências do CRM pelo diálogo.

## Seções

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

## Conteúdo da página

# Consultar CRM

**Consultar CRM** está disponível para a equipe interna e respeita as permissões de quem conversa. É útil para localizar um registro antes de criar uma atividade, alterar uma oportunidade ou selecionar referências pelo nome.

## 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 **Consultar CRM**.

![Configuração do bloco Consultar CRM no construtor de Agentes Avançados](/docs/screenshots/agentes-avancados/consultar-crm.png)

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **O que este agente pode consultar** | Selecione recursos necessários: oportunidades, contatos, empresas, atividades, funis, etapas, tags, origens, usuários, equipes, agendas e quadros, conforme a lista exibida. |
| **Quando oferecer esta capacidade** | Explique o contexto de trabalho que deve levar à busca. |
| **Nome do resultado** | Nome opcional para guardar o retorno no contexto. |

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

Recebe uma entrada e possui **Depois · sequência**. A pessoa pode informar nome, telefone ou e-mail, conforme o recurso pesquisado. Referências encontradas podem alimentar outras capacidades.

## Exemplo de uso

Para “crie uma tarefa de retorno para a oportunidade Empresa Aurora”, o agente consulta a oportunidade e identifica o registro antes de executar **Gerenciar atividades**.

## Cuidados

Consulta de CRM não é uma fonte pública para clientes externos. Ela não libera acesso a outro projeto nem supera permissões pessoais. Quando houver mais de uma correspondência, a IA precisa esclarecer a escolha; não deve inventar IDs.

## Como testar

Teste nome único, homônimo, pesquisa sem resultado e usuário com acesso limitado. Confira se a operação seguinte usa o registro realmente escolhido.

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