读取团队会话消息

读取团队会话的公开输入和输出消息。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams/{team_id}/sessions/{context_id}/messages

调用前准备

BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

准备同环境产品身份与对象标识。

请求

curl --request GET \
  "$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions/$CONTEXT_ID/messages?limit=50&offset=0" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"

下一页示例:

curl --request GET \
  "$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions/$CONTEXT_ID/messages?limit=50&offset=50" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"

最新窗口示例:

curl --request GET \
  "$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions/$CONTEXT_ID/messages?latest=true&limit=50" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"

参数

位置

类型

必填

说明

workspace_id

路径

string

是

当前工作区ID,与产品身份和请求头保持同环境一致。

team_id

路径

string

是

团队ID,来自团队列表或创建响应。

context_id

路径

string

是

团队会话ID,来自会话创建或列表。

latest

查询

boolean 文本

否

只有字面量 true 启用最新窗口;与普通翻页分开使用。

limit

查询

integer

否

默认50,最大200;非正/无效按50。

offset

查询

integer

否

默认0;负数按0。

普通模式读取至 offset + items.length >= total 或本页 items 为空时停止。并发写入可能改变偏移分页;不要用total当稳定快照。

普通模式按创建时间及快照顺序升序,按limit/offset翻页。latest=true选择最新窗口,忽略请求offset,结果恢复时间升序,并返回窗口实际offset。total统计消息投影所依据的输入/输出快照,不是任务数。

成功响应

{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "message-example",
        "conversation_id": "context-example",
        "task_id": "task-example",
        "agent_workspace_id": "workspace-example",
        "agent_id": "agent-example",
        "role": "user",
        "parts": [
          {
            "kind": "text",
            "text": "整理资料"
          }
        ],
        "committed": false,
        "created_at": "2026-11-12T01:00:00Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

字段

类型

说明

code

integer

成功为0。

data

object

对应返回对象。

HTTP200;返回对应对象,写后使用对应读取动作确认。

错误响应

错误与并发处理区分参数、版本、成员/会话状态及准入失败。

最后更新于