OpenMax
免费试用

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

回包

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)

回包

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

回包

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

回包