Choose the capability
Use direct APIs when the application must control filters, scoring, deduplication, or CRM mapping. Use a Skill when the process is reusable and the agent should follow a consistent research method.
Recommended workflow
1. Define the target profile
Specify the organization, role, geography, industry, company size, or creator profile that qualifies. Avoid collecting unrelated personal data.2. Discover organizations or people
Start with broad search criteria, then narrow the result set. Keep source identifiers and URLs so records can be traced and deduplicated.3. Enrich only shortlisted records
Enrichment may be billable and may return personal or professional contact information. Apply data-minimization rules:- Request only fields needed for the workflow.
- Avoid enriching every discovery result by default.
- Record the source and retrieval time.
- Respect applicable privacy, consent, and outreach requirements.
4. Score with explicit criteria
Keep qualification logic inspectable. Separate:- Source data.
- Derived scores.
- Model-generated interpretation.
- Missing or uncertain fields.
5. Prepare an outreach brief
A research result may include company context, relevant triggers, suggested messaging, and source links. Drafting is not the same as sending.6. Gate external actions
Before creating a contact, adding a person to a sequence, sending a message, or changing an external system:- Verify the connected account and required permission.
- Show the intended action and target.
- Obtain confirmation where policy requires it.
- Execute the narrowest operation once.
- Verify the external result.
Minimal documentation set
- Capabilities by Goal
- Capabilities by Interface
- The exact company, people, enrichment, or creator API pages
- Authentication
- Security