Busca de Pessoas
Produza uma shortlist auditável sem fingir que a skill concede acesso a dados do LinkedIn.
Escolha o modo de dados
Use o modo mais forte já disponível: CSV/perfis/exportação fornecidos; busca pública na web; uma sessão autenticada autorizada; ou um provedor conectado como HarvestAPI ou Apify. Se nenhuma fonte de descoberta estiver disponível, retorne um plano de busca normalizado, filtros prontos para uso e um modelo de entrada. Nunca invente perfis.
Fluxo de trabalho
- Traduza a requisição para o esquema canônico.
- Separe requisitos obrigatórios de preferências de ranqueamento. Trate critérios vagos como preferências, a menos que explicitamente obrigatórios.
- Informe o modo selecionado e seus limites de cobertura.
- Mapeie filtros canônicos para campos do provedor e divulgue todo filtro aplicado, aproximado, descartado ou não suportado.
- Execute o canário mais barato e útil antes de uma busca paga/completa. Pare em resultados inválidos, silenciosamente vazios ou fora do alvo.
- Desduplique por URL de perfil estável, depois por nome normalizado mais empresa atual.
- Ranqueie contra o briefing original, preserve URLs de evidência e distinga fatos baseados em fontes de inferências.
- Retorne a shortlist, a receita de busca, ressalvas e o refinamento de maior valor.
Limites
- Uma skill é orquestração, não uma licença de dados. Nunca implique acesso integrado ao LinkedIn.
- Nunca exponha, incorpore ou persista credenciais de provedores.
- Deixe claro o modo de custo antes de busca paga; prefira visualizações e expansão por etapas.
- Nunca interprete zero resultados como ausência de pessoas correspondentes até verificar a validade da requisição e o suporte a filtros.
- Não envie solicitações de conexão ou mensagens sem autorização separada.
Para comportamento do adaptador e contratos de resultados, leia references/provider-contract.md.
Executor determinístico
Use scripts/people_search.py para execução somente de plano, importação/ranqueamento de CSV e execução de canário de provedor. As credenciais do provedor devem entrar através da variável de ambiente nomeada no escopo do processo; nunca passe um token como argumento.