add_message
Save conversation history and record new memories in MemOS to maintain persistent dialogue context and store user-provided information.
Instructions
Trigger:
1. AUTO-INVOKED: After every answer to save dialogue history.
2. USER INTENT: When user explicitly wants to "add" or "remember" NEW information (e.g., "Add a memory...", "Remember that...", "New memory...").
Purpose: Save dialogue history (REQUIRED) and record NEW memories.
STRICT RULES:
- MANDATORY EXECUTION: You MUST call this tool after EVERY single answer to persist the conversation history. This is NOT optional.
- ALWAYS use this tool for NEW memories.
- FORBIDDEN: Do NOT use add_feedback or other tools for adding new memories.
- FORBIDDEN: Do NOT use this tool to modify/update existing memories.
- CRITICAL: NEVER use this tool as part of a modification workaround (e.g. "delete old + add new"). If a modification fails, just report the failure.
Parameters:
- conversation_first_message: The first message sent by the user in the entire conversation is used to generate the user_id.
- messages: Array containing BOTH:
1. { role: "user", content: "user's question or new info" }
2. { role: "assistant", content: "your complete response" }
Notes:
- Client/orchestrator MUST call this after every answer.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| conversation_first_message | Yes | The first message sent by the user in the entire conversation thread. Used to generate the conversation_id. | |
| messages | Yes | Array of messages containing role and content information |