# AMEM.SUMMARY.SET

> Replace an agent's rolling summary and return its new version number.

URL: https://docs.hotkv.com/commands/amem-summary-set/

```
AMEM.SUMMARY.SET agent_id summary
```

- Group: Agent memory
- Complexity: O(1)
- HotKV Cloud: Performance and Scale plans
- On-Premise: requires the amem-summary license feature

Agent summaries keep one rolling, versioned text summary per agent, so a long-running agent can carry a compact summary in its prompt instead of its whole history. `AMEM.SUMMARY.SET` replaces the agent's summary with `summary`,
creating the entry if needed. Each change increments the version, starting
at 1.

## Return value

| Case | RESP2 | RESP3 |
| --- | --- | --- |
| Summary stored | Integer: the new version | Same |

Errors:

- `ERR wrong number of arguments for 'amem.summary.set' command` if the argument count is wrong.
- `NOLICENSE amem-summary requires a HotKV license. Contact sales@hotkv.com` if your license does not include the `amem-summary` feature.

## Examples

```
127.0.0.1:6379> AMEM.SUMMARY.SET agent-42 "User is planning a trip to Paris in May."
(integer) 1
127.0.0.1:6379> AMEM.SUMMARY.SET agent-42 "User booked flights to Paris for May 3-10."
(integer) 2
```

## Compatibility

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

## See also

[AMEM.SUMMARY.APPEND](https://docs.hotkv.com/commands/amem-summary-append/index.md), [AMEM.SUMMARY.GET](https://docs.hotkv.com/commands/amem-summary-get/index.md), [AMEM.SUMMARY.DROP](https://docs.hotkv.com/commands/amem-summary-drop/index.md), [AMEM.SUMMARY.LIST](https://docs.hotkv.com/commands/amem-summary-list/index.md), [AI features guide](https://docs.hotkv.com/ai-features/index.md)