创建智能体团队¶
创建可显式维护成员的智能体团队。
POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
请求¶
curl --request POST \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID" \
--header "Content-Type: application/json" \
--data '{"name":"资料整理团队","description":"整理与核对资料","members":[{"agent_workspace_id":"workspace-example","agent_id":"agent-example"}]}'
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
路径 |
string |
是 |
当前工作区ID,与产品身份和请求头保持同环境一致。 |
|
请求体 |
string |
是 |
团队名称。 |
|
请求体 |
string |
否 |
团队说明。 |
|
请求体 |
array(成员引用数组) |
否 |
成员引用;每个组合必须唯一。 |
保存响应的 id、version 和 membership_version。初始成员使用智能体定义工作区与智能体 ID 的组合;省略/null/空 members 可创建空团队,但空团队不能提交运行。创建名称去除首尾空白后须非空且不超过128字节。
成功响应¶
{
"code": 0,
"data": {
"id": "team-example",
"workspace_id": "workspace-example",
"owner_user_id": "user-example",
"name": "资料整理团队",
"status": "active",
"version": 1,
"membership_version": 2,
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z",
"description": "整理与核对资料"
}
}
错误响应¶
错误与并发处理区分参数、版本、成员/会话状态及准入失败。
最后更新于