按智能体汇总当前会话

读取当前账户在当前工作区中按智能体分组的普通聊天会话。分组只统计 active、chat、visible 且未置顶的持久化会话,不是全部智能体或全部会话清单。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/conversations/agent-groups

调用前准备

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

PRODUCT_API_BASE_URL 包含目标环境的产品前缀。准备本人的凭据与有权限的 WORKSPACE_ID,路径 ID 和 X-Workspace-ID 必须一致。示例 ID 需替换为该环境的实际返回值。

请求

curl --get "$PRODUCT_API_BASE_URL/workspaces/$WORKSPACE_ID/conversations/agent-groups" \
  -H "X-API-Key: $PRODUCT_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

无业务查询参数或请求体;当前动作不解析 limit、offset、keyword、surface 等筛选。不要复制会话列表参数并据此认为分组范围已改变。

按 agent_workspace_id 与 agent_id 共同分组。当前动作没有分页字段,total 表示分组数量,不是各组 conversation_count 的和。

成功响应

{"code":0,"data":{"items":[{"agent_workspace_id":"workspace-example","agent_id":"agent-example","agent_summary":{"id":"agent-example","workspace_id":"workspace-example","display_name":"示例智能体","available":true},"conversation_count":3,"last_activity_at":"2026-11-12T01:02:03Z"}],"total":1}}

字段

类型

说明

data.items

array

本次全部分组;无结果为空数组。

data.items[].agent_workspace_id

string

智能体来源工作区。

data.items[].agent_id

string

智能体 ID。

data.items[].agent_summary

object

智能体展示摘要;优先当前定义,找不到时保留历史展示信息。

data.items[].agent_summary.available

boolean

当前摘要是否标记可用;不代替真实调用成功。

data.items[].agent_summary.unavailable_reason

string

可选的不可用原因。

data.items[].conversation_count

integer

满足本动作固定范围的会话数量。

data.items[].last_activity_at

string

组内最近消息时间,无消息时使用会话创建时间。

data.total

integer

分组数。

按 last_activity_at 降序;同时间按智能体来源工作区、智能体 ID 排序。智能体被归档或删除后,历史分组仍可能存在;不能据此认定还可调用。

继续读取

选定一组后,调用智能体会话列表,并保持同一 agent_workspace_id、agent_id,明确传 status=active、purpose=chat、visibility=visible、pinned=false,以匹配本分组统计范围。置顶、归档和其他用途需单独查询,不能从当前分组不存在推定没有相关会话。

错误

工作区不匹配可返回 400,身份或权限失败可返回 401/403;读取或展示依赖失败可返回 500/503。分组读取失败不改变已有会话;恢复条件后重新读取。

最后更新于