docs: 更新 Agent 协议文档与部署配置

- 更新 Agent API 端点文档
- 更新 SSE 事件与输入输出文档
- 新增 deploy/.env.prod.example 配置模板
This commit is contained in:
qzl
2026-03-16 16:11:40 +08:00
parent 4b92772535
commit ed86bfe9ae
5 changed files with 384 additions and 978 deletions
+5 -4
View File
@@ -307,7 +307,7 @@ interface TaskAcceptedResponse {
taskId: string;
threadId: string;
runId: string;
created: string; // ISO-8601 timestamp
created: boolean; // 是否新建会话
}
```
@@ -359,7 +359,7 @@ interface HistoryMessageTool {
seq: number;
role: "tool";
content: string;
uiSchema: UiSchemaRenderer | null; // 由 tool_agent_output.ui_hints 编译
ui_schema: UiSchemaRenderer | null; // 由 tool_agent_output.ui_hints 编译
timestamp: string;
}
@@ -369,7 +369,7 @@ interface HistoryMessageAssistant {
seq: number;
role: "assistant";
content: string;
uiSchema: UiSchemaRenderer | null; // 由 worker_agent_output.ui_hints 编译
ui_schema: UiSchemaRenderer | null; // 由 worker_agent_output.ui_hints 编译
timestamp: string;
}
@@ -418,7 +418,7 @@ interface UiSchemaRenderer {
"seq": 2,
"role": "assistant",
"content": "好的,我来帮您创建日程。",
"uiSchema": {
"ui_schema": {
"version": "2.0",
"locale": "zh-CN",
"status": "success",
@@ -447,3 +447,4 @@ interface UiSchemaRenderer {
- binary content 的 url 必须是有效的 signed URL,由 `/api/v1/agent/attachments` 端点生成
- backend 验证通过后,会将 binary url 转换为内部存储路径
- tools 为空数组时,prompt 中不会包含工具说明
- `RunAgentInput` 同时接受 camelCase 与 snake_case 别名输入(推荐统一使用 camelCase)