公开Web应用对象¶
这些对象用于访客调用,发布管理对象与部署站点配置另有协议。示例中的ID、token和结果是固定说明值。
链接与session¶
resolve 返回 agent_name;仅短码输入 k 的响应另含 agent_id。session 创建和刷新返回 session_token、expires_in,后者单位为秒,固定604800。
创建会话¶
创建返回完整 AgentConversationView,其中继续调用使用 id。列表与改名返回的摘要则使用 conversation_id,两者不能互换字段名。
字段 |
类型 |
说明 |
|---|---|---|
|
string |
创建成功的会话ID。 |
|
string |
发布工作区。 |
|
string |
智能体定义工作区,系统智能体可为system。 |
|
string |
目标智能体。 |
|
object |
目标智能体的展示摘要。 |
|
string |
会话标题,空时省略。 |
|
boolean |
标题是否经用户修改。 |
|
string |
会话状态,创建为active。 |
|
string |
本组为webapp。 |
|
string |
会话可见性。 |
|
string |
父会话和来源消息,空时省略。 |
|
boolean |
会话置顶状态。 |
|
string |
当前头消息,空时省略。 |
|
string |
活动和最近任务,空时省略。 |
|
string |
最近任务状态,空时省略。 |
|
string |
最近消息时间,未设置时省略。 |
|
string |
RFC3339时间。 |
agent_summary 包含 id、display_name、available,以及可能省略的 workspace_id、avatar_ref、status、unavailable_reason。它是展示事实,不是独立授权结果。
列表、消息与事件¶
会话列表为 items/total/limit/offset;每条摘要仅包含 conversation_id/title/updated_at。改名也返回这三个字段。公开列表只列active,不使用管理接口的status筛选。
消息列表同为 items/total/limit/offset,消息15个顶层字段见同一投影说明。
事件列表返回 items/total/after_seq。每条事件包含 id/workspace_id/task_id/seq/kind/visible/created_at,以及可能省略的 a2a_state/payload。payload经过可公开内容投影和脱敏,不是完整内部事件对象。after_seq回显输入,total为本次投影条数;下一次按实际最大seq继续,不把空页当任务终态。
文件与反馈¶
对象 |
字段 |
用途 |
|---|---|---|
暂存上传文件 |
|
组装规范附件及逐文件凭据;不等于模型已使用文件。 |
会话归档 |
|
确认status=archived,不是物理删除。 |
反馈回执 |
|
确认已记录,不代表重新生成或任务结果。 |
文件 volume_id、size 为integer,其余上传字段为string;size单位为字节。任务产物下载和预览直接返回字节/流。
MCP应用¶
资源响应包含 uri 和 contents。调用响应包含 content、is_error 和可选 structured_content;is_error=false必须显式读取,HTTP成功不保证工具成功。
调用至少选择 tool_id 或 tool_name。存在 tool_name 时按任务中app-visible工具名匹配;不存在时按ID匹配,不能凭同连接上任意工具名调用。结果不会自动成为模型上下文或持久事件,客户端后续携带上下文须遵循规范data部件。