团队对象与请求准备¶
团队管理、成员、会话和消息分别使用自己的标识与版本。团队成员是智能体,不是工作区用户或角色成员。
调用前准备¶
从同一个环境取得产品API基地址、个人访问令牌及工作区ID。示例使用 BASE_URL、MOI_KEY、WORKSPACE_ID,BASE_URL已包含该环境产品前缀。TEAM_ID来自创建/列表;CONTEXT_ID来自团队会话;AGENT_WORKSPACE_ID和AGENT_ID来自智能体定义。
创建使用 agent_team.create;读取使用 agent_team.read;资料、成员、会话及消息提交使用 agent_team.update;删除使用 agent_team.delete。实际请求仍须经过当前身份、Role和正式权限边界;owner_user_id不是本地放行依据。
成员引用¶
字段 |
类型 |
说明 |
|---|---|---|
|
string |
智能体定义工作区,保留系统/本工作区差异。 |
|
string |
该定义工作区内的智能体ID。 |
同一团队只允许本工作区或系统工作区的适用智能体。组合须唯一,不能只按 agent_id 去重。成员读取另外含 team_id、created_at;data直接为数组,不分页。
团队对象¶
字段 |
类型 |
说明 |
|---|---|---|
|
string |
团队ID。 |
|
string |
团队所属工作区。 |
|
string |
保存的归属用户;不替代请求授权。 |
|
string |
名称。 |
|
string |
说明;空时省略。 |
|
string |
active、deleting或deleted。 |
|
integer |
团队资料/状态版本;用于更新和删除。 |
|
integer |
成员目录版本;用于添加和移除成员。 |
|
string |
RFC3339时间。 |
创建空团队时两个版本从1开始;每个实际初始成员加入会推进membership_version。不要把带初始成员的创建结果固定假设为membership_version=1。成员变更不等同于资料version变更;资料更新还可能因并发成员变更发生冲突。
会话对象¶
字段 |
类型 |
说明 |
|---|---|---|
|
string |
所属工作区和团队。 |
|
string |
团队会话ID;用于改名、发送和读取消息。 |
|
string |
会话名称,可为空。 |
|
integer |
该会话的版本,重命名使用此值。 |
|
string |
已建立的提供商会话标识,空时省略。 |
|
string |
创建来源连接,空时省略。 |
|
string |
创建来源的外部用户,空时省略。 |
|
string |
MOI创建者,空时省略。 |
|
string |
最近更新来源连接,空时省略。 |
|
string |
最近更新来源的外部用户,空时省略。 |
|
string |
最近更新的MOI用户,空时省略。 |
|
string |
当前活动任务,空时省略。 |
|
string |
待处理占用标识,空时省略;不当作消息ID。 |
|
string |
最近回答者的定义工作区及ID,空时省略。 |
|
string |
RFC3339时间。 |
last_completed_task_id在当前HTTP对象中不导出。会话创建不启动模型,改名不清理占用;没有据当前13路由发明会话DELETE或取消命令。
列表与消息¶
团队、会话、消息列表返回 data.items/total/limit/offset。total是当前筛选范围的总数;普通翻页在offset + items.length达到total或当前items为空时停止。成员列表的data则直接为数组。
消息字段 |
类型 |
说明 |
|---|---|---|
|
string |
输入消息优先使用原message_id,输出可为快照标识。 |
|
string |
对应团队context_id。 |
|
string |
所属任务。 |
|
string |
真实执行智能体身份。 |
|
string |
user或agent。 |
|
array(部件数组) |
公开内容投影。 |
|
string |
输出任务状态,空时省略。 |
|
boolean |
快照提交标记;agent输出在completed时为true。 |
|
string |
RFC3339时间。 |
消息部件¶
文本示例使用 {"kind":"text","text":"整理资料"}。ToolPart还定义可选file/data/metadata;file使用uri、mimeType和name。文件可访问性、附件归属及其他部件联合分支另需核验,不能仅凭开放JSON字段承诺可读取任意URI。
提交metadata不得填moi.runtime.managed_turn、ingress_receipt_id或external_conversation_id;这些键由运行期管理。选择信息由服务端写入agent_team_selection,客户端不据元数据获得额外权限。
提交回执¶
字段 |
类型 |
说明 |
|---|---|---|
|
string |
已受理任务标识,需查询终态。 |
|
object |
|
|
string |
explicit、single_member、continuity、default、clarify或delegate。 |
|
integer |
选择时的成员版本。 |
|
object |
选择时保存的策略及模型/能力摘要,内容随选择路径变化。 |