# AMEM.SEM.RECALL

> Recall the facts in an agent's semantic memory closest to a query embedding.

URL: https://docs.hotkv.com/commands/amem-sem-recall/

```
AMEM.SEM.RECALL agent_id k value [value ...]
```

- Group: Agent memory
- Complexity: O(log N) where N is the number of facts
- HotKV Cloud: Performance and Scale plans
- On-Premise: requires the agent-memory license feature

Agent memory gives AI agents four kinds of memory. Semantic memory holds an agent's long-term facts, each with an embedding your application computes, and recalls them by cosine similarity to a query embedding. `AMEM.SEM.RECALL` returns up to `k` facts most similar to the
query embedding, most similar first. Note that `k` comes before the vector.
Expired facts are skipped, so you can get fewer than `k` results.

## Return value

| Case | RESP2 | RESP3 |
| --- | --- | --- |
| Always | Array of results. Each result is a flat array: `"key"`, the key, `"content"`, the content, `"similarity"`, the cosine similarity as a string (all bulk strings). Empty for an unknown agent or a vector of the wrong size. | Same |

Errors:

- `ERR invalid k` if `k` is not a positive integer.
- `ERR invalid vector component` if a vector value is not a finite number.
- `ERR empty embedding vector` if no vector values are given.
- `ERR wrong number of arguments for 'amem.sem.recall' command` if the argument count is wrong.
- `NOLICENSE agent-memory requires a HotKV license. Contact sales@hotkv.com` if your license does not include the `agent-memory` feature.

## Examples

```
127.0.0.1:6379> AMEM.SEM.RECALL notes 1 0.1 0.2 0.31
1) 1) "key"
   2) "fact-1"
   3) "content"
   4) "Paris is the capital of France."
   5) "similarity"
   6) "0.99990195"
```

The exact similarity digits depend on the stored vectors.

## Compatibility

HotKV-only command. Redis and Valkey have no equivalent.

## See also

[AMEM.SEM.CREATE](https://docs.hotkv.com/commands/amem-sem-create/index.md), [AMEM.SEM.STORE](https://docs.hotkv.com/commands/amem-sem-store/index.md), [AMEM.SEM.FORGET](https://docs.hotkv.com/commands/amem-sem-forget/index.md), [AMEM.SEM.LIST](https://docs.hotkv.com/commands/amem-sem-list/index.md), [AMEM.SEARCH](https://docs.hotkv.com/commands/amem-search/index.md), [AI features guide](https://docs.hotkv.com/ai-features/index.md)