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.EPIS.LOG

Last updated 
AMEM.EPIS.LOG agent_id event_type content [METADATA metadata]
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. Episodic memory is an append-only log of timestamped events per agent, which you can query by event type and time range. AMEM.EPIS.LOG appends an event. HotKV sets its timestamp, in nanoseconds since the Unix epoch. The agent’s log is created on first use.

Options

Section titled “Options”
Option Effect
METADATA metadata Any string to keep with the event, such as JSON.

Return value

Section titled “Return value”
Case RESP2 RESP3
Event logged Simple string OK Same

Errors:

  • ERR wrong number of arguments for 'amem.epis.log' 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.EPIS.LOG agent-42 action "Called weather API for New York"
OK
127.0.0.1:6379> AMEM.EPIS.LOG agent-42 observation "72F and sunny" METADATA "{\"source\":\"weather-api\"}"
OK

Compatibility

Section titled “Compatibility”

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

See also

Section titled “See also”

AMEM.EPIS.QUERY, AMEM.EPIS.CLEAR, AMEM.EPIS.STATS, AI features guide