save_memory
Save important information to workspace memory. Memories persist across all conversations in the workspace and can be retrieved later usingget_memories.
Use Cases
- Store user preferences and decisions
- Remember important facts or patterns
- Save context that should persist across conversations
- Track agent-specific information
Parameters
Optional identifier for the agent saving this memory. Useful for tracking which agent created the memory.
Response
Example Request
Example Response
Behavior
- Memories are automatically indexed in ChromaDB for semantic search
- Each memory is associated with the API key that created it
- Memories are scoped to the project associated with the API key
- Content is trimmed of leading/trailing whitespace before saving
Error Handling
Best Practices
- Be specific: Include enough context for the memory to be useful later
- Keep it concise: Focus on key information, not full conversation history
- Use agent metadata: Include
agent_idandagent_namewhen relevant - Save proactively: Store important information as soon as you learn it
