retrieve_entity_by_identifier
Retrieve entities by identifier (name, email, etc.) with optional type filtering, using keyword search or semantic fallback.
Instructions
Retrieve entity by identifier (name, email, etc.) across entity types or specific type. Falls back to semantic search when keyword match returns no results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| identifier | Yes | Identifier to search for (name, email, tax_id, etc.) - will be normalized | |
| entity_type | No | Optional: Limit search to specific entity type (e.g., 'company', 'person') | |
| by | No | Restrict snapshot-field matching to a single field (e.g. 'email', 'domain', 'company'). When omitted, checks a default identity-bearing set (name, full_name, title, email, domain, company). | |
| limit | No | Max matching entities (default 100). | |
| include_observations | No | When true, include recent observations per matched entity (ordered by observed_at desc). | |
| observations_limit | No | Max observations per entity when include_observations is true (default 20, max 200). |