Ofereça a busca de pessoas como ferramenta de agente
Permita que um agente encontre as pessoas que ocupam um cargo em uma empresa-alvo e leia seus perfis, como uma ferramenta de busca com filtros tipados, e não uma sessão de navegação.
- Chave de API gratuita
- Sem cartão de crédito
- Rode sua amostra
Uma seleção de equipes que executam esse trabalho na Forager · e outras equipes que usam a Forager
Usa POST /person_role_search/, POST /person_detail_lookup/ · Referência da API de busca de pessoas
Quanto custa: cobrado por requisição: preços por crédito.
- Busca de pessoas
- Enriquecimento de pessoas
- API
- Embutido em uma plataforma
- Agentes de IA e ferramentas para devs
Como os dados fluem
POST /person_role_search/ - person id
- per_8f3a1c
- title
- VP de Revenue Operations
- empregador
- Example Inc.
- campos do perfil
- /in/priya-fixture
- nome
- Priya Fixture
- celular
- +44 20 7946 0958
Passos
- Exponha uma ferramenta
find_peopleque mapeia a requisição do agente para filtros dePOST /person_role_search/: cargo, senioridade, departamento, localização e empresa - Verifique primeiro o endpoint _totals para a ferramenta informar quantas correspondências existem antes de paginar
- Retorne cada correspondência como um registro tipado com
person_id, nome, cargo e empregador - Deixe o agente chamar
POST /person_detail_lookup/para a pessoa ou as duas pessoas que ele escolher, não para todo o conjunto de resultados
import json, os, requests BASE = "https://api-v2.forager.ai/api/{account_id}/datastorage" HEADERS = {"X-API-KEY": os.environ["FORAGER_KEY"]} body = json.load(open("request.json")) # request fields: see the API reference # 1. Expose a find_people tool that maps the agent's request to POST # /person_role_search/ filters: title, seniority, department, location and # company r1 = requests.post(f"{BASE}/person_role_search/", headers=HEADERS, json=body) # 2. Check the _totals endpoint first so the tool can report how many # matches exist before it pages # 3. Return each match as a typed record with person_id, name, title and # employer # 4. Let the agent call POST /person_detail_lookup/ for the one or two # people it chooses, not the whole result set r2 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body)
# 1. POST /person_role_search/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_role_search/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json # 2. POST /person_detail_lookup/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_detail_lookup/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json
Execute você mesmo: Referência da API de busca de pessoas
- Chave de API gratuita
- Sem cartão de crédito
- Rode sua amostra
Entradas e saídas
| Dados de entrada | Saídas |
|---|---|
| domínio ou nome da empresa | person_id |
| filtros de cargo ou senioridade | full name |
| localização | title |
employer | |
profile fields |
Dúvidas sobre esta receita
Como meu agente pode buscar pessoas por cargo em uma empresa?
Exponha uma ferramenta find_people que mapeia a requisição do agente para os filtros de POST /person_role_search/: cargo, senioridade, departamento, localização e empresa. Deixe o agente chamar POST /person_detail_lookup/ para a ou as duas pessoas que ele escolher, não para todo o conjunto de resultados.
Quanto custa oferecer a busca de pessoas como ferramenta de agente?
Busca de pessoas: 1 crédito por requisição; busca de pessoas: detalhes do cargo: 1 crédito por requisição, cobrados com ou sem retorno de dados. Enriquecimento de pessoas: 1 crédito por requisição, cobrado com ou sem retorno de dados. Os 8.250 créditos mensais do plano Growth cobrem 8.250 requisições de busca, ou uma combinação. Os planos self-service são Starter, Growth, Pro e Scale. Veja planos e preços
O que preciso para executar este exemplo prático e o que recebo de volta?
Você envia o domínio ou o nome da empresa, a localização e filtros de cargo ou senioridade. Você recebe empregador, nome completo, person_id e campos do perfil, em JSON. Você também precisa de uma chave de API da Forager, que vem com uma conta gratuita.
Qual API de busca de pessoas retorna resultados tipados que um agente consegue usar?
Este exemplo prático usa Busca de pessoas e Enriquecimento de pessoas da Forager. Busca de pessoas: encontre as pessoas que ocupam um cargo em empresas-alvo, com filtros por cargo, senioridade, departamento e localização. Deixe um agente encontrar as pessoas que ocupam um cargo em uma empresa-alvo e ler os perfis, como uma ferramenta de busca com filtros tipados em vez de uma sessão de navegação.
Existe um jeito gratuito de testar a Forager neste fluxo de trabalho?
Sim. Crie uma conta gratuita em app.forager.ai: ela vem com US$ 5 em créditos gratuitos e uma chave de API, e não é preciso cartão de crédito para se cadastrar. Teste com registros que você já conhece ou agende uma demo e envie uma lista: nós a processamos e mostramos o que encontramos.
Quando devo executar este fluxo de trabalho?
Um agente recebe o pedido de encontrar o responsável por segurança em uma lista de empresas e iniciar uma conversa com cada um. O agente encontra a pessoa certa em uma única chamada de ferramenta, e a plataforma paga pelos perfis que abre, não pela busca.
Quais produtos da Forager este exemplo prático usa?
Busca de pessoas e enriquecimento de pessoas. Busca de pessoas: encontre as pessoas que ocupam um cargo em empresas-alvo, com filtros de cargo, senioridade, departamento e localização. Enriquecimento de pessoas: perfil profissional completo de uma pessoa a partir de uma URL do LinkedIn, e-mail ou telefone: experiência, formação, habilidades e canais de contato.
Como sei que os dados estão corretos?
O teste que vale é o seu: envie uma lista de perfis que importam para você. Nós rodamos e mostramos o que encontramos, número por número, para você mesmo medir a taxa de acerto e a taxa de conexão.
Como encontrar tomadores de decisão em uma ferramenta de agente?
Exponha uma ferramenta find_people que mapeie a requisição do agente para os filtros de POST /person_role_search/: cargo, senioridade, departamento, localização e empresa. Consulte antes o endpoint _totals para que a ferramenta informe quantas correspondências existem antes de paginar.
Quais ferramentas podem executar este fluxo de trabalho?
Integração nativa no Clay, criada por parceiros na Deepline e no Cargo e chamada pela API a partir do seu próprio código, do Make e do n8n. Ou chame os endpoints das etapas acima a partir do seu código com uma única chave de API.
Quantas etapas tem este fluxo de trabalho?
4 etapas: exponha uma ferramenta find_people que mapeie a requisição do agente para os filtros de POST /person_role_search/: cargo, senioridade, departamento, localização e empresa, consulte antes o endpoint _totals para que a ferramenta informe quantas correspondências existem antes de paginar, retorne cada correspondência como um registro tipado com person_id, nome, cargo e empregador e deixe o agente chamar POST /person_detail_lookup/ para a pessoa ou as duas que ele escolher, não para todo o conjunto de resultados.
Existe contrato ou compromisso mínimo?
Sem contrato para começar: uma conta gratuita vem com US$ 5 em créditos. Para continuar usando a Forager, escolha um plano mensal ou anual. Os planos mensais podem ser cancelados a qualquer momento e os créditos não usados são acumulados; os planos anuais liberam todos os créditos de uma vez e custam 10% menos. Volumes maiores são combinados com nossa equipe.
As respostas escritas não estão disponíveis agora. As páginas acima ainda ajudam, ou agende uma demo e pergunte ao time.
- US$ 5 em créditos grátis
- Sem cartão de crédito
- Rode sua amostra
Uma seleção de equipes que executam esse trabalho na Forager · e outras equipes que usam a ForagerUma seleção de equipes que usam a Forager
-
Clay - Construtores de workflows de GTM
Caso de uso selecionado: números de celular, e-mails e dados de pessoas da Forager dentro de tabelas do Clay.
-
Juicebox
- Sourcing de candidatos com IA
Caso de uso selecionado: dados da Forager por trás da busca PeopleGPT e dos agentes de sourcing.
-
Nooks - Discadores power e paralelos
Caso de uso selecionado: números de celular dentro do próprio discador (dialer).
-
Emergent Labs
- Criadores de agentes
Plataforma de criação de apps com IA em que agentes projetam, programam e fazem o deploy de apps full-stack.
-
Deepline
- Enriquecimento em cascata (waterfall)
Caso de uso selecionado: consultas da Forager como ferramentas tipadas dentro de waterfalls de enriquecimento.
19 ferramentas tipadas da Forager disponíveis na Deepline1
-
HubSpot
- Complementos de CRM
Caso de uso selecionado: enriquecer registros de contatos e empresas com dados de pessoas, empresas e vagas de emprego.
-
BetterContact - Enriquecimento em cascata (waterfall)
Caso de uso selecionado: uma etapa da Forager na cascata (waterfall) para números de celular.
-
Salto
- Uso interno
Plataforma de alterações de configuração com governança em sistemas empresariais.
Fontes
1 Deepline: deepline.com/integrations/forager (página pública, consultada em 2026-10-21).
Mais exemplos práticos para criadores de agentes
-
Dê a agentes de código ferramentas tipadas de dados de pessoas e empresas
-
Ofereça dados de pessoas e empresas como integração nativa em um construtor de apps com IA
-
Forager em waterfall na ferramenta de contatos do agente
-
Fundamente a pesquisa de contas de um agente com enriquecimento de empresas
-
Detecte contatos do CRM que mudaram de emprego e receba alertas sobre champions que trocaram de empresa
-
Reforce uma base de sales intelligence com uma fonte adicional de celulares