Search entities
search_entitiesRead-onlyIdempotent
Find entities by name or description, or filter them by type and attributes.
With ``query``: returns ranked candidates, each with ``method`` (how it
was found), ``score`` (0-1), ``legacy``, ``relaciones`` (counts by
state) and ``contexto`` (up to 4 relations, current first, to tell
similarly named entities apart). Methods, most to least reliable:
exacta, alias, parcial (whole word or same words), semantica (name
similarity) and memoria (entity mentioned in the closest episodes).
semantica and memoria results appear only for multi-word queries and
are candidates, not confirmed matches. A single word with no lexical
match returns []. If nothing is found, the item may still exist in
memory without being an entity (see retrieve_memories).
Without ``query``: returns all entities matching entity_type and/or the
given attribute values, with no result limit. With no query and no
filters it returns every entity.
Args:
query: A name, part of a name, or a short description.
entity_type: Filter by type (only without query). 'unclassified'
means entities whose type is not known.
attributes: Exact attribute key-value pairs to match (only without
query).
limit: Maximum results for a query search (1-50).
via_memoria: With query, set False to skip episode-based matches and
search names only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| attributes | No | ||
| entity_type | No | ||
| via_memoria | No |