sync update from LAN repo (source dhk-1 @ 3b1ec5b4)
This commit is contained in:
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` 时归入该任务的无类型分区(与历史链接的行为一致)。
|
||||
|
||||
Reference in new issue
Block a user