add

harness-api.md

@@ -2,6 +2,157 @@
 
 以下是对应 `/harness` 路由前缀的 SE 智能体 HTTP 接口文档。
 
+## 根据用户意图选子智能体
+
+### 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 接口地址 | `/harness/choose/subagent` |
+| 请求方式 | `POST` |
+| Content-Type | `application/json` |
+| 响应类型 | `text/event-stream` (SSE) |
+| 接口描述 | 根据用户意图选择子智能体 |
+
+### 请求参数 (Request Body)
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| sessionId | Long | 是 | 会话ID |
+| username | String | 是 | 用户名 |
+| input | String | 是 | 用户输入内容 |
+
+#### 请求示例
+
+```json
+{
+  "sessionId": 1001,
+  "username": "zhangsan",
+  "input": "帮我查看代码中的空指针异常"
+}
+```
+
+### 响应参数 (Response Body)
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | int | 状态码 (200=成功, 500=失败) |
+| msg | String | 消息内容 |
+| data | Object | 响应数据对象 |
+| data.sessionId | String | 会话ID |
+| data.username | String | 用户名 |
+| data.input | String | 用户输入 |
+| data.output | String | 主智能体的输出 |
+| data.subAgentId | String | 子智能体ID |
+
+#### 成功响应示例
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": {
+    "sessionId": "1001",
+    "username": "zhangsan",
+    "input": "帮我查看代码中的空指针异常",
+    "output": "正在为您分配合适的子智能体...",
+    "subAgentId": "code-review-agent"
+  }
+}
+```
+
+#### 失败响应示例
+
+```json
+{
+  "code": 500,
+  "msg": "参数[sessionId]不能为空",
+  "data": null
+}
+```
+
+---
+
+## 保存子智能体回复
+
+### 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 接口地址 | `/harness/subagent/output` |
+| 请求方式 | `POST` |
+| Content-Type | `application/json` |
+| 响应类型 | `text/event-stream` (SSE) |
+| 接口描述 | 保存来自paw的子智能体回复内容 |
+
+### 请求参数 (Request Body)
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| sessionId | Long | 是 | 会话ID |
+| username | String | 是 | 用户名 |
+| subagentOutput | String | 是 | 子智能体回复内容 |
+
+#### 请求示例
+
+```json
+{
+  "sessionId": 1001,
+  "username": "zhangsan",
+  "subagentOutput": "在第42行发现潜在的空指针异常，建议添加空值检查..."
+}
+```
+
+### 响应参数 (Response Body)
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| code | int | 状态码 (200=成功, 500=失败) |
+| msg | String | 消息内容 |
+| data | Long | 保存的消息ID |
+
+#### 成功响应示例
+
+```json
+{
+  "code": 200,
+  "msg": "操作成功",
+  "data": 12345
+}
+```
+
+#### 失败响应示例
+
+```json
+{
+  "code": 500,
+  "msg": "参数[username]不能为空",
+  "data": null
+}
+```
+
+---
+
+## 通用说明
+
+### 状态码说明
+
+| 状态码 | 说明 |
+|--------|------|
+| 200 | 操作成功 |
+| 500 | 操作失败 |
+
+### 错误码说明
+
+| 错误信息 | 说明 |
+|----------|------|
+| 参数[sessionId]不能为空 | sessionId为必填参数 |
+| 参数[username]不能为空 | username为必填参数 |
+| 参数[input]不能为空 | input为必填参数 |
+| 参数[subagentOutput]不能为空 | subagentOutput为必填参数 |
+| 操作失败 | 服务器内部错误 |
+
+
 ## 开启一个会话窗口
 
 - 请求地址：{gateway}/harness/session