retrieve_entity_by_identifier
Find entities by name, email, or other identifier with fallback to semantic search. Optionally include recent observations for each matched entity.
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. A literal entity_id (ent_) short-circuits to a direct primary-key lookup; if no entity has that id, the response carries a hint pointing to retrieve_entity_snapshot.
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). |