读取团队会话消息¶
读取团队会话的公开输入和输出消息。
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"
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
路径 |
string |
是 |
当前工作区ID,与产品身份和请求头保持同环境一致。 |
|
路径 |
string |
是 |
团队ID,来自团队列表或创建响应。 |
|
路径 |
string |
是 |
团队会话ID,来自会话创建或列表。 |
|
查询 |
boolean 文本 |
否 |
只有字面量 true 启用最新窗口;与普通翻页分开使用。 |
|
查询 |
integer |
否 |
默认50,最大200;非正/无效按50。 |
|
查询 |
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
}
}
错误响应¶
错误与并发处理区分参数、版本、成员/会话状态及准入失败。
最后更新于