Skip to content

Overview

Messages represent the conversation history within a workspace. Each message is associated with a role and optional metadata.

Message Roles

RoleDescription
userMessages from the user
assistantAI-generated responses
systemSystem prompts and instructions
agentAgent-generated content (with agent_name)

Features

  • Persistence: Full conversation history preserved
  • Pagination: Retrieve messages in pages (default: 50)
  • Ordering: Chronological order (oldest first)
  • Clearing: Bulk delete all messages in workspace

Use Cases

  • Review conversation history
  • Export chat logs for analysis
  • Clear context for fresh research direction