Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

AMEM.SUMMARY.GET

Last updated 
AMEM.SUMMARY.GET agent_id
Group
Agent memory
Complexity
O(1)
Arity
2 (exactly, counting the command name)
Flags
read-only, fast
Keys
first 1, last 1, step 1
HotKV Cloud
Performance and Scale
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.GET returns the current summary.

Return value

Section titled “Return value”
Case RESP2 RESP3
Summary exists Array of three elements: the summary (bulk string), the version (integer), the last update time in Unix seconds (integer) Same
No summary for this agent Nil bulk string Null

Errors:

  • ERR wrong number of arguments for 'amem.summary.get' 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

Section titled “Examples”
127.0.0.1:6379> AMEM.SUMMARY.GET agent-42
1) "User booked flights to Paris for May 3-10."
2) (integer) 2
3) (integer) 1790985600
127.0.0.1:6379> AMEM.SUMMARY.GET unknown-agent
(nil)

Compatibility

Section titled “Compatibility”

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

See also

Section titled “See also”

AMEM.SUMMARY.SET, AMEM.SUMMARY.APPEND, AMEM.SUMMARY.DROP, AMEM.SUMMARY.LIST, AI features guide