sync update from LAN repo (source dhk-1 @ 3e87be55)
This commit is contained in:
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)` 独立保存,不会混入其它任务深链接或通用聊天。
|
||||
|
||||
Reference in new issue
Block a user