|
|
@@ -184,13 +184,18 @@ Response: 200 OK
|
|
|
"output_tokens": 380,
|
|
|
"total_tokens": 1630,
|
|
|
"steps": 3,
|
|
|
- "duration_ms": 4520,
|
|
|
- "estimated_cost_usd": 0.0082
|
|
|
+ "duration_ms": 4520
|
|
|
},
|
|
|
- "trace_id": "tr_a1b2c3"
|
|
|
+ "workspace_path": "/var/agentpaas/agents/.../workspace/run_20260606_143000"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
+> **v1.0 实现说明:** `usage.estimated_cost_usd` 和顶层 `trace_id` 字段曾
|
|
|
+> 在设计草案里出现, 但 `agentpaas/src/agentpaas/api/v1/agents.py` 当前
|
|
|
+> 的响应构造没有填充它们。前者依赖 `lambdagent.cost_grade` 的接入,
|
|
|
+> 后者需要 OpenTelemetry trace 注入到 response 包装层——都列入 v1.1
|
|
|
+> backlog (审计 docs/AUDIT_2026-06-05.md #75)。
|
|
|
+
|
|
|
#### 3.3.2 异步执行
|
|
|
|
|
|
```
|
|
|
@@ -223,7 +228,7 @@ POST /api/v1/jobs/{job_id}/cancel // 取消任务
|
|
|
#### 3.3.3 流式执行 (SSE)
|
|
|
|
|
|
```
|
|
|
-POST /api/v1/agents/{agent_id}/stream
|
|
|
+POST /api/v1/agents/{agent_id}/run/stream
|
|
|
Accept: text/event-stream
|
|
|
|
|
|
SSE 事件流:
|
|
|
@@ -243,10 +248,15 @@ event: done
|
|
|
data: {"run_id": "run_7d9e4f", "usage": {...}}
|
|
|
```
|
|
|
|
|
|
-#### 3.3.4 WebSocket 交互
|
|
|
+#### 3.3.4 WebSocket 交互 (planned — 未在 v1.0 实现)
|
|
|
+
|
|
|
+> **v1.0 状态:** 此端点为设计文档, 代码侧暂未实现。v1.0 的实时交互
|
|
|
+> 通过 §3.3.3 的 SSE 流式端点完成, SSE 已经覆盖了大多数 WS 想解决的
|
|
|
+> 场景。在确定真实需求 (双向 / 多轮持续会话) 之前, WS 实现暂不立项。
|
|
|
+> 审计参见 docs/AUDIT_2026-06-05.md #74。
|
|
|
|
|
|
```
|
|
|
-WS /api/v1/agents/{agent_id}/ws
|
|
|
+WS /api/v1/agents/{agent_id}/ws (planned)
|
|
|
|
|
|
→ Client: {"type": "message", "input": "查询订单 #12345"}
|
|
|
← Server: {"type": "thinking", "content": "正在分析..."}
|