sync update from LAN repo (source dhk-1 @ 3e87be55)

This commit is contained in:
gozeros committed 2026-10-21 15:06:08 +08:00
1 parent ab6068a7c1
commit 42f2a26fa8
1482 files changed
+227759 -9584

No files matched your search

@@ -0,0 +1,82 @@
# b5-1 任务分析深链接接入
`goPath=b5-1` 是「任务分析」单智能体问答入口。接入方先把任务详情写入 DeerFlow,再让用户登录并跳转;页面不会再调用接入方的任务详情接口。
## 前置配置
在「业务链条管理」页面新增的 **任务分析**(业务码 `b5-1`)行中选择要使用的单智能体。没有配置智能体时,深链接不会进入问答页。
服务端为接入写入端配置环境变量:
```text
DEERFLOW_TASK_DEEPLINK_INGEST_KEY=<随机且足够长的共享密钥>
```
该密钥只用于下面的 `PUT`;浏览器读取详情仍需正常登录态。
## 写入或更新任务详情
```http
PUT /api/task-deeplink-details/b5-1/{id}
Content-Type: application/json
X-Integration-Key: <DEERFLOW_TASK_DEEPLINK_INGEST_KEY>
```
```json
{
"taskName": "重点活动舆情研判",
"taskContent": "围绕活动期间的舆情风险、重点对象和处置建议开展分析。",
"overview": "活动前后七天的综合研判任务",
"extra": {
"sourceSystem": "B5",
"priority": "high",
"regionCodes": ["110000", "120000"],
"customField": {
"owner": "张三"
}
}
}
```
- `id` 与深链接中的 `taskId` 必须完全一致;存储键为 `(type, id)`,此处 `type` 固定为 `b5-1`。
- `taskName`、`taskContent` 必填;`overview`、`extra` 可选。
- `extra` 必须是 JSON 对象,最大 64 KiB;用于接入方的扩展字段。
- 这是幂等接口,接入方不需要预先查询「是否已存」。每次直接 `PUT` 完整快照即可:
- 首次写入:创建记录;
- 任务名称、详情、简介或 `extra` 有任一变化:整体更新并递增 `version`;
- 内容完全相同:只按主键读取并返回现有记录,不更新数据库、不递增 `version` 或 `updatedAt`。
成功响应示例:
```json
{
"data": {
"type": "b5-1",
"id": "task-20261020-001",
"taskName": "重点活动舆情研判",
"taskContent": "围绕活动期间的舆情风险、重点对象和处置建议开展分析。",
"overview": "活动前后七天的综合研判任务",
"extra": {
"sourceSystem": "B5",
"priority": "high"
},
"version": 1,
"updatedAt": "2026-10-20T10:00:00+08:00"
},
"created": true,
"changed": true
}
```
`created` 表示本次是否首次创建;`changed` 表示本次是否实际写入。对同样内容的重试,响应为 `created: false`、`changed: false`。
## 用户跳转
写入成功后,引导用户访问登录页(认证参数按既有接入方式附带):
```text
/#/login?taskId=task-20261020-001&goPath=b5-1
```
登录后前端读取本系统详情接口,将任务名称和任务详情展示在左上角,标题固定为「任务分析」;`taskName`、`taskContent`、`overview` 与完整 `extra` 会作为每轮问答的隐藏任务上下文提供给配置的智能体。聊天记录按 `(taskId, b5-1)` 独立保存,不会混入其它任务深链接或通用聊天。