Memory
Shared memory for your agents. Search and reads are free.
Tools6
memory__remember1 credit / memorySave one concise, durable fact or preference. New memories are private by default; set scope='shared' only when the organization should read it. Set metadata.category (what kind of memory this is) and, when a related memory exists, related_ids from a prior memory__search — linked, categorized memories are far more useful in the memory graph. One memory holds at most 4,000 characters; save a longer note as several memories. Each saved memory is billed; reads are free.Save one concise, durable fact or preference. New memories are private by default; set scope='shared' only when the organization should read it. Set metadata.category (what kind of memory this is) and, when a related memory exists, related_ids from a prior memory__search — linked, categorized memories are far more useful in the memory graph. One memory holds at most 4,000 characters; save a longer note as several memories. Each saved memory is billed; reads are free.
memory__ingest1 credit / memoryExtract durable memories from recent conversation messages. Each message is saved as one memory, verbatim, so each holds at most 4,000 characters. Extracted memories are private by default; set scope='shared' only when the organization should read them. Each saved memory is billed; reads are free.Extract durable memories from recent conversation messages. Each message is saved as one memory, verbatim, so each holds at most 4,000 characters. Extracted memories are private by default; set scope='shared' only when the organization should read them. Each saved memory is billed; reads are free.
memory__update1 credit / memoryReplace the text of an existing memory (at most 4,000 characters) after identifying it by id. Every other field is optional and omit-to-keep-current: pass pinned, scope, metadata.category, metadata.client_tags or related_ids only to change them. Changing the text is billed; changing only other fields is free.Replace the text of an existing memory (at most 4,000 characters) after identifying it by id. Every other field is optional and omit-to-keep-current: pass pinned, scope, metadata.category, metadata.client_tags or related_ids only to change them. Changing the text is billed; changing only other fields is free.
memory__searchFreeSearch saved long-term memories for facts relevant to the current question or task.Search saved long-term memories for facts relevant to the current question or task.
memory__getFreeRead one memory in full by id. Use when memory__search or memory__list returned a memory marked truncated and you need the rest of its text.Read one memory in full by id. Use when memory__search or memory__list returned a memory marked truncated and you need the rest of its text.
memory__listFreeList memories newest first. Use when the user asks what is remembered, or pass next_cursor back as cursor to walk the whole set (scope narrows it).List memories newest first. Use when the user asks what is remembered, or pass next_cursor back as cursor to walk the whole set (scope narrows it).
