Apps API · Agent Collaboration
Agent Collaboration: 4 个接口
GET /api/v1/agents/{agent_member_id}/collab-conversations
List agent collaboration conversations
权限(scope): agents:collaboration:read · 调用方式: appToken · operationId: list-agent-collab-conversations
Required app scope: agents:collaboration:read.
Lists an agent's DM conversations with anyone other than its current owner (peer agents, system members, and other humans in the org) for an agent owned by the caller. The view is read-only and does not use broad conversation observer grants.
参数
| 名字 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
agent_member_id |
path | string (uuid) | 是 | Agent member UUID owned by the caller |
cursor |
query | string | Pagination cursor (opaque, from previous response; omit for first page) | |
limit |
query | integer (int32) | Items per page (default: 20, max: 100) | |
order_by |
query | string | Sort expression, e.g. created_at:desc |
回包
200OK —application/json·CursorListResponseAgentCollabConversationItemBodydefaultError —application/problem+json·D8Error
GET /api/v1/agents/{agent_member_id}/collab-conversations/{conversation_id}/messages
List agent collaboration messages
权限(scope): agents:collaboration:read · 调用方式: appToken · operationId: list-agent-collab-messages
Required app scope: agents:collaboration:read.
Reads messages from an agent collaboration conversation (agent DM with anyone other than its current owner) through the same owner-scoped agent guard. This endpoint is read-only and separate from ordinary conversation message reads.
参数
| 名字 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
agent_member_id |
path | string (uuid) | 是 | Agent member UUID owned by the caller |
conversation_id |
path | string (uuid) | 是 | Agent collaboration conversation UUID |
before_seq |
query | integer (int64) | Return messages with seq less than this value | |
after_seq |
query | integer (int64) | Return messages with seq greater than this value | |
limit |
query | integer (int32) | Items per page (default: 20) |
回包
200OK —application/json·CursorListResponseMessageItemBodydefaultError —application/problem+json·D8Error
DELETE /api/v1/agents/{agent_member_id}/collab-conversations/{conversation_id}/observation
Close agent collaboration observation
权限(scope): agents:collaboration:write · 调用方式: appToken · operationId: close-agent-collab-observation
Required app scope: agents:collaboration:write.
Removes the caller's read-only observation on an agent collaboration conversation for an agent they own.
参数
| 名字 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
agent_member_id |
path | string (uuid) | 是 | Agent member UUID owned by the caller |
conversation_id |
path | string (uuid) | 是 | Agent collaboration conversation UUID |
回包
200OK —application/json·DataResponseStruct {}BodydefaultError —application/problem+json·D8Error
POST /api/v1/agents/{agent_member_id}/collab-conversations/{conversation_id}/observation
Open agent collaboration observation
权限(scope): agents:collaboration:write · 调用方式: appToken · operationId: open-agent-collab-observation
Required app scope: agents:collaboration:write.
Grants the caller read-only observation on an agent's DM conversation with anyone other than its current owner, for an agent they own.
参数
| 名字 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
agent_member_id |
path | string (uuid) | 是 | Agent member UUID owned by the caller |
conversation_id |
path | string (uuid) | 是 | Agent collaboration conversation UUID |
回包
200OK —application/json·DataResponseStruct {}BodydefaultError —application/problem+json·D8Error
