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.WORK.SET

Last updated 
AMEM.WORK.SET session_id key value [TTL seconds]
Group
Agent memory
Complexity
O(1)
Arity
-4 (at least 4 words, counting the command name)
Flags
write
Keys
first 1, last 1, step 1
HotKV Cloud
Performance and Scale
On-Premise
requires the agent-memory license feature

Agent memory gives AI agents four kinds of memory. Working memory is a scratchpad of key and value pairs for a task in progress, grouped by session. AMEM.WORK.SET stores value under key in the session, replacing any previous value. The session is created on first use.

Options

Section titled “Options”
Option Effect
TTL seconds After this many seconds AMEM.WORK.GET no longer returns the value. Omitted or 0 means no expiry.

Return value

Section titled “Return value”
Case RESP2 RESP3
Value stored Simple string OK Same

Errors:

  • ERR invalid TTL if seconds is not a non-negative integer. Nothing is stored.
  • ERR wrong number of arguments for 'amem.work.set' 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

Section titled “Examples”
127.0.0.1:6379> AMEM.WORK.SET task-123 current_step "analyzing data"
OK
127.0.0.1:6379> AMEM.WORK.SET task-123 lock "worker-7" TTL 30
OK

Compatibility

Section titled “Compatibility”

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

See also

Section titled “See also”

AMEM.WORK.GET, AMEM.WORK.DEL, AMEM.WORK.CLEAR, AMEM.WORK.LIST, AI features guide