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

This commit is contained in:
gozeros committed 2026-11-05 10:56:34 +08:00
1 parent da6521b6cb
commit 264e2200d6
995 files changed
+148105 -13399

No files matched your search

@@ -4,29 +4,25 @@
## 前置配置
在「业务链条管理」页面新增的 **任务分析**(业务码 `b5-1`)行中选择要使用的单智能体。没有配置智能体时,深链接不会进入问答页。
在「业务链条管理」页面新增的 **任务分析**(业务码 `b5-1`)行中选择要使用的默认单智能体。深链接也可以用 `?agentId=` 直接指定本次问答使用的智能体(优先于配置行);两者都没有时,深链接不会进入问答页。
服务端为接入写入端配置环境变量:
```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": "活动前后七天的综合研判任务",
"type": "yuqing",
"extra": {
"sourceSystem": "B5",
"priority": "high",
@@ -38,8 +34,9 @@ X-Integration-Key: <DEERFLOW_TASK_DEEPLINK_INGEST_KEY>
}
```
- `id` 与深链接中的 `taskId` 必须完全一致;存储键为 `(type, id)`,此处 `type` 固定为 `b5-1`。
- `taskName`、`taskContent` 必填;`overview`、`extra` 可选。
- `id` 与深链接中的 `taskId` 必须完全一致;存储键为 `(type, id, 业务类型)`,此处路径 `type` 固定为 `b5-1`。
- `taskName`、`taskContent` 必填;`overview`、`type`、`extra` 可选。
- `type` 是业务类型(≤64 字符),与深链接 `?type=` 对应:**同一个 id 可以存多个不同类型的详情快照**,各自独立版本号;不传 `type` 时写入无类型分区(与深链不传 `?type=` 的读取口径一致)。
- `extra` 必须是 JSON 对象,最大 64 KiB;用于接入方的扩展字段。
- 这是幂等接口,接入方不需要预先查询「是否已存」。每次直接 `PUT` 完整快照即可:
- 首次写入:创建记录;
@@ -53,6 +50,7 @@ X-Integration-Key: <DEERFLOW_TASK_DEEPLINK_INGEST_KEY>
"data": {
"type": "b5-1",
"id": "task-20261020-001",
"taskType": "yuqing",
"taskName": "重点活动舆情研判",
"taskContent": "围绕活动期间的舆情风险、重点对象和处置建议开展分析。",
"overview": "活动前后七天的综合研判任务",
@@ -68,7 +66,7 @@ X-Integration-Key: <DEERFLOW_TASK_DEEPLINK_INGEST_KEY>
}
```
`created` 表示本次是否首次创建;`changed` 表示本次是否实际写入。对同样内容的重试,响应为 `created: false`、`changed: false`。
`created` 表示本次是否首次创建;`changed` 表示本次是否实际写入。对同样内容的重试,响应为 `created: false`、`changed: false`。响应中的 `taskType` 回显写入时的业务类型(注意与固定为 `"b5-1"` 的 `type` 字段区分)。
## 用户跳转
@@ -78,5 +76,19 @@ X-Integration-Key: <DEERFLOW_TASK_DEEPLINK_INGEST_KEY>
/#/login?taskId=task-20261020-001&goPath=b5-1
```
登录后前端读取本系统详情接口,将任务名称和任务详情展示在左上角,标题固定为「任务分析」;`taskName`、`taskContent`、`overview` 与完整 `extra` 会作为每轮问答的隐藏任务上下文提供给配置的智能体。聊天记录按 `(taskId, b5-1)` 独立保存,不会混入其它任务深链接或通用聊天。
可选参数:
| 参数 | 说明 |
| --- | --- |
| `agentId` | 直接指定本次问答使用的智能体 id,优先于「业务链条管理」b5-1 行的配置。 |
| `type` | 业务类型(≤64 字符,超长截断)。**详情快照与聊天记录都按 `(taskId, type)` 独立分区**:同一任务传入不同 `type` 时读取各自的详情、维护各自的对话历史,互不可见。 |
| `theme` | 页面主题色。**不传时默认深蓝色**;传入则按传入值解析明暗(`dark`/`dark-blue`/`深色`/`深蓝` → 深色,其余如 `lightblue` → 浅色)。主题只在任务分析页面与本次深链会话内生效,不影响用户在系统其它页面的外观偏好。 |
示例:
```text
/#/login?taskId=task-20261020-001&goPath=b5-1&agentId=analyst-01&type=yuqing
```
登录后前端按 `(taskId, type)` 读取本系统详情接口(对应 `GET /api/task-deeplink-details/b5-1/{id}?type=…`,需登录态),将任务名称和任务详情展示在左上角,标题固定为「任务分析」;`taskName`、`taskContent`、`overview` 与完整 `extra` 会作为每轮问答的隐藏任务上下文提供给智能体。聊天记录同样按 `(taskId, type)` 独立保存,不会混入其它任务深链、其它类型或通用聊天;未传 `type` 时归入该任务的无类型分区(与历史链接的行为一致)。