peanut/happy-life-star

Fork 0

Files

T

peanut dfbf68989b docs: refine AI scene routing spec

2026-05-22 22:33:14 +08:00

25 KiB

Raw Blame History

AI 场景路由配置中心设计

日期：2026-05-22

背景

当前后台 web-admin 已有 AI 配置管理功能，后端使用 t_ai_config 保存 Coze 相关配置。该表同时承载服务商凭证、接口 URL、Bot/Workflow ID、业务场景、请求参数、测试保存等多种职责。随着短片小说生成、剧本生成迁移到自建 Dify 平台，且后续可能继续接入更多 AI 服务商，现有单表模型难以支持灵活切换和统一测试。

目标是将后台升级为 AI 场景路由配置中心：管理员可以配置服务商、接口/工作流、业务场景绑定，并让所有需要使用 AI 的业务都通过场景编码调用。后台切换场景绑定后，不需要发版，下一次调用立即生效。

现状

现有实现包含：

web-admin/src/views/aiconfig/AiConfigList.vue：AI 配置列表、编辑、测试、测试后保存。
backend-single/src/main/java/com/emotion/entity/AiConfig.java：对应 t_ai_config。
AiConfigController、AiConfigService、AiConfigServiceImpl：配置 CRUD、启用禁用、默认配置、测试后更新。
AiChatServiceImpl：包含大量 Coze 专用调用、请求组装、SSE 解析、工作流调用和日志记录逻辑。
docs/dify平台接口.md：Dify 平台接口文档，当前重点使用 /chat-messages。

现有 AI 业务入口包括：

对话 / WebSocket 对话。
剧本生成。
短片小说生成。
日记总结 / AI 评论。
情绪总结 / 情绪分析。
人生事件疗愈回复。
后续新增 AI 场景。

设计目标

后台可配置所有 AI 服务商，例如 Dify、Coze、未来 OpenAI 或自定义 HTTP 服务。
后台可配置具体接口或工作流，例如 Dify /chat-messages、Coze workflow。
后台可列出所有业务场景，并为每个场景选择当前生效的接口配置。
场景绑定修改后立即对后续调用生效。
支持按服务商和按场景测试，测试结果可用于排错和保存配置。
保留现有 Coze 能力，并支持短片小说生成、剧本生成优先绑定 Dify。
后续新增 AI 场景时，业务代码只新增稳定 sceneCode，不直接依赖服务商。

非目标

本期不做复杂流量权重、AB 实验和多配置灰度。
本期不删除旧 t_ai_config，它作为迁移来源和兼容兜底保留。
本期不要求所有历史 Coze 调用代码一次性完全清理，但新调用入口必须具备统一路由能力。

总体架构

采用三层配置模型：

ai_provider：服务商配置。
ai_endpoint_config：接口/工作流配置。
ai_scene_binding：业务场景绑定。

运行时新增 AiRuntimeService，业务服务只传 sceneCode 和输入参数：

aiRuntimeService.invoke("chat", params, userId);
aiRuntimeService.invoke("script_generate", params, userId);
aiRuntimeService.invoke("short_story_generate", params, userId);
aiRuntimeService.invoke("diary_summary", params, userId);

调用链：

业务服务
  -> AiRuntimeService.invoke(sceneCode, inputs, userId)
  -> 查询 ai_scene_binding 当前启用绑定
  -> 加载 ai_endpoint_config
  -> 加载 ai_provider
  -> 根据 provider_type 选择 DifyProviderAdapter / CozeProviderAdapter
  -> 按请求模板组包并调用外部服务
  -> 按响应解析规则提取结果
  -> 写 ai_call_log

模块边界

后端新增以下核心单元，避免继续把服务商差异堆在 AiChatServiceImpl：

单元	职责	不负责
`AiRuntimeService`	按 `sceneCode` 查询绑定、选择接口配置、执行 fallback、返回统一结果	不关心 Dify/Coze 请求细节
`AiProviderAdapter`	服务商适配器接口，定义组包、调用、解析的统一契约	不读取业务场景
`DifyProviderAdapter`	处理 Dify `/chat-messages` 的 blocking/streaming 请求和响应解析	不处理 Coze 格式
`CozeProviderAdapter`	迁移现有 Coze workflow 请求、SSE 解析和错误处理	不处理 Dify 格式
`AiTemplateRenderer`	渲染请求模板，合并场景输入、endpoint 默认值和运行时变量	不发送 HTTP
`AiCallLogService`	统一写入调用日志和测试日志，敏感字段脱敏	不决定业务结果

业务服务只依赖 AiRuntimeService，不直接依赖 DifyProviderAdapter、CozeProviderAdapter 或数据库配置表。

数据模型

所有新增表都遵循项目已有公共字段约定：

id
create_by
create_time
update_by
update_time
is_deleted
remarks

删除操作使用逻辑删除。查询默认过滤 is_deleted = 0。

ai_provider

服务商账号和基础能力配置。

字段	说明
`id`	主键
`provider_code`	唯一编码，如 `dify_default`、`coze_prod`
`provider_name`	显示名称
`provider_type`	`dify`、`coze`、`openai`、`custom`
`base_url`	服务商基础地址，如 `http://49.232.138.53/v1`
`auth_type`	`bearer`、`api_key`、`oauth`、`none`
`api_key`	服务商级 API Key
`client_id`	OAuth Client ID
`client_secret`	OAuth Client Secret
`grant_type`	OAuth 授权类型
`default_headers`	JSON，默认请求头
`health_check_url`	健康检查地址
`timeout_ms`	默认超时时间
`retry_count`	默认重试次数
`retry_delay_ms`	默认重试延迟
`environment`	`development`、`testing`、`production`
`is_enabled`	是否启用
`description`	描述

约束和索引：

UNIQUE(provider_code)
INDEX(provider_type, is_enabled)
INDEX(environment, is_enabled)

同一 provider_code 逻辑删除后不可直接复用，避免历史调用日志无法追溯。需要复用时通过恢复或显式改名处理。

ai_endpoint_config

具体接口、工作流或模型调用配置。

字段	说明
`id`	主键
`provider_id`	关联 `ai_provider.id`
`endpoint_code`	唯一编码，如 `dify.short_story.chat_messages`
`endpoint_name`	显示名称
`endpoint_type`	`chat`、`workflow`、`completion`、`audio`、`custom`
`http_method`	`GET`、`POST` 等
`path`	接口路径，如 `/chat-messages`
`full_url_override`	特殊接口完整 URL 覆盖
`app_id`	Dify App 或未来扩展
`bot_id`	Coze Bot ID
`workflow_id`	Dify 或 Coze Workflow ID
`model_name`	模型名称
`request_template`	JSON，请求模板
`response_parser`	JSON，响应解析规则
`support_stream`	是否支持流式
`support_file_upload`	是否支持文件上传
`timeout_ms`	接口级超时时间
`retry_count`	接口级重试次数
`retry_delay_ms`	接口级重试延迟
`last_test_status`	最近一次测试状态
`last_test_time`	最近一次测试时间
`last_test_trace_id`	最近一次测试链路 ID
`is_enabled`	是否启用
`description`	描述

约束和索引：

UNIQUE(endpoint_code)
INDEX(provider_id, is_enabled)
INDEX(endpoint_type, is_enabled)

path 与 full_url_override 的优先级：

如果 full_url_override 非空，直接使用该 URL。
否则使用 ai_provider.base_url + ai_endpoint_config.path。

timeout_ms、retry_count、retry_delay_ms 的优先级：

endpoint 配置值 > provider 默认值 > 系统默认值

ai_scene_binding

业务场景到接口配置的绑定。

字段	说明
`id`	主键
`scene_code`	稳定业务场景编码，如 `chat`、`script_generate`
`scene_name`	场景名称
`scene_category`	`chat`、`content`、`analysis`、`healing`
`endpoint_config_id`	当前生效接口配置
`fallback_endpoint_id`	兜底接口配置，可为空
`environment`	环境
`is_enabled`	是否启用
`priority`	预留优先级
`input_schema`	JSON，说明入参结构
`test_payload`	JSON，后台场景测试默认入参
`last_test_status`	最近一次场景测试状态
`last_test_time`	最近一次场景测试时间
`last_test_trace_id`	最近一次场景测试链路 ID
`description`	描述

约束和索引：

UNIQUE(scene_code, environment)
INDEX(endpoint_config_id)
INDEX(fallback_endpoint_id)
INDEX(scene_category, is_enabled)

同一环境内一个 scene_code 只能有一条生效绑定。后续如果需要灰度或权重路由，另行增加路由规则表，不在本期混入 ai_scene_binding。

本期不单独新增场景字典表，ai_scene_binding 同时承担“场景清单”和“环境绑定”职责。初始化时为每个支持的 scene_code 按环境创建一条记录，endpoint_config_id 可先为空，is_enabled = 0。后台场景页必须展示这些未绑定场景，管理员完成 endpoint 绑定、测试通过并启用后才参与运行时路由。

ai_call_log

统一调用日志，替代后续新增场景对 t_coze_api_call 的依赖。

字段	说明
`id`	主键
`trace_id`	链路追踪 ID
`scene_code`	场景编码
`provider_id`	服务商 ID
`provider_type`	服务商类型
`endpoint_config_id`	接口配置 ID
`fallback_used`	是否使用兜底
`request_url`	请求 URL
`request_headers`	脱敏后的请求头
`request_body`	请求体
`response_status`	HTTP 状态码
`response_body`	原始响应
`parsed_result`	解析后的结果
`duration_ms`	耗时
`status`	`success`、`failed`
`error_code`	错误码
`error_message`	错误信息

索引：

INDEX(trace_id)
INDEX(scene_code, create_time)
INDEX(provider_type, create_time)
INDEX(endpoint_config_id, create_time)
INDEX(status, create_time)

日志中 request_headers 必须脱敏 Authorization、api-key、x-api-key、client_secret 等敏感字段。

初始场景编码

sceneCode	场景
`chat`	对话
`script_generate`	剧本生成
`short_story_generate`	短片小说生成
`diary_summary`	日记总结 / AI 评论
`emotion_summary`	情绪总结
`emotion_analysis`	情绪分析
`life_healing`	人生事件疗愈回复

后续新增场景只需要新增 ai_scene_binding 和业务调用点，不需要新增服务商专用字段。

新增场景的规则：

先在代码中定义稳定 sceneCode 常量，业务调用只引用该常量。
数据初始化脚本为所有环境创建对应 ai_scene_binding 记录，默认禁用且不绑定 endpoint。
后台展示未绑定场景，并允许管理员选择 endpoint、填写 test_payload、执行场景测试。
只有绑定的 endpoint、provider 都启用，且场景本身启用后，运行时才会调用。
如果业务调用了未初始化的 sceneCode，返回 AI_SCENE_NOT_FOUND 并写入失败日志。

Dify 适配

依据 docs/dify平台接口.md，本期优先支持：

POST /chat-messages

Dify 请求体模板应支持：

{
  "inputs": {},
  "query": "{{input}}",
  "response_mode": "blocking",
  "conversation_id": "{{conversationId}}",
  "user": "{{userId}}",
  "workflow_id": "{{workflowId}}"
}

响应解析规则：

{
  "mode": "json_path",
  "answerPath": "$.answer"
}

流式响应本期定义为可测试、可解析，但业务是否启用由 endpoint 的 support_stream 和请求模板共同决定。Dify SSE 解析规则如下：

{
  "mode": "sse",
  "eventField": "event",
  "contentEvents": ["message"],
  "contentPath": "$.answer",
  "endEvents": ["message_end"],
  "errorEvents": ["error"]
}

DifyProviderAdapter 在 blocking 模式下返回 $.answer，在 streaming 模式下拼接所有 event=message 的 answer 内容；遇到 event=error 时标记调用失败并写入 ai_call_log.error_message。

Coze 适配

现有 Coze 工作流能力迁移到 CozeProviderAdapter：

组装 bot_id、workflow_id、user_id、stream、additional_messages、parameters。
保留现有 SSE 解析能力。
保留现有重试和异常处理策略。
新日志写入 ai_call_log，旧 t_coze_api_call 可在过渡期继续写入。

Coze 默认请求模板：

{
  "bot_id": "{{botId}}",
  "workflow_id": "{{workflowId}}",
  "user_id": "{{userId}}",
  "stream": true,
  "additional_messages": [
    {
      "role": "user",
      "content": "{{input}}",
      "content_type": "text",
      "type": "question"
    }
  ],
  "parameters": "{{parameters}}"
}

Coze 响应解析先沿用现有 AiChatServiceImpl 中的 SSE 解析逻辑，提取 End 节点 content.output 或文本回答；迁移完成后该逻辑归属 CozeProviderAdapter。

请求模板与响应解析

模板变量

request_template 使用简单占位符语法，避免引入复杂脚本执行：

{{input}}             单文本输入
{{userId}}            当前用户 ID
{{conversationId}}    会话 ID，可为空
{{workflowId}}        endpoint.workflow_id
{{botId}}             endpoint.bot_id
{{parameters}}        运行时参数对象
{{inputs.xxx}}        运行时参数中的 xxx 字段

渲染规则：

先加载 endpoint 的 request_template。
注入 endpoint 字段，例如 workflowId、botId。
注入运行时参数 inputs。
注入系统参数，例如 userId、conversationId、traceId。
渲染完成后必须校验为合法 JSON。

如果某个必填占位符缺失，测试和运行时调用都直接失败，并返回明确错误，例如 AI_TEMPLATE_VARIABLE_MISSING: workflowId。

响应解析

response_parser 支持三类模式：

{
  "mode": "json_path",
  "answerPath": "$.answer"
}

{
  "mode": "sse",
  "contentEvents": ["message"],
  "contentPath": "$.answer",
  "endEvents": ["message_end"],
  "errorEvents": ["error"]
}

{
  "mode": "raw_text"
}

解析失败时：

ai_call_log.status = failed。
error_code = AI_RESPONSE_PARSE_ERROR。
日志保留原始响应。
如果场景配置了 fallback，则继续调用 fallback。

统一错误码：

错误码	场景
`AI_SCENE_NOT_FOUND`	未找到当前环境的场景配置
`AI_SCENE_DISABLED`	场景被禁用
`AI_ENDPOINT_NOT_FOUND`	endpoint 不存在或已删除
`AI_ENDPOINT_DISABLED`	endpoint 被禁用
`AI_PROVIDER_NOT_FOUND`	provider 不存在或已删除
`AI_PROVIDER_DISABLED`	provider 被禁用
`AI_TEMPLATE_VARIABLE_MISSING`	请求模板缺少必填变量
`AI_TEMPLATE_INVALID_JSON`	请求模板渲染后不是合法 JSON
`AI_PROVIDER_REQUEST_FAILED`	外部服务调用失败
`AI_RESPONSE_PARSE_ERROR`	响应解析失败
`AI_FALLBACK_FAILED`	主配置和兜底配置都失败

业务层收到错误时，只处理统一错误码和用户可见提示，不直接解析 Dify 或 Coze 的原始错误结构。

后端接口

新增管理 API 前缀：

/ai/providers
/ai/endpoints
/ai/scenes
/ai/runtime/test
/ai/call-logs

服务商接口

GET    /ai/providers/page
GET    /ai/providers/detail?id=
POST   /ai/providers/create
PUT    /ai/providers/update
DELETE /ai/providers/delete?id=
PUT    /ai/providers/enable?id=
PUT    /ai/providers/disable?id=
POST   /ai/providers/test

接口/工作流接口

GET    /ai/endpoints/page
GET    /ai/endpoints/detail?id=
POST   /ai/endpoints/create
PUT    /ai/endpoints/update
DELETE /ai/endpoints/delete?id=
POST   /ai/endpoints/test

场景绑定接口

GET  /ai/scenes/page
GET  /ai/scenes/detail?id=
POST /ai/scenes/create
PUT  /ai/scenes/update
PUT  /ai/scenes/bind
POST /ai/scenes/test

运行时测试接口

POST /ai/runtime/test 支持：

按 endpoint 测试：验证某个接口配置能否调通。
按 scene 测试：验证某个业务场景当前绑定是否能返回结果。

后台页面

保留现有菜单 AI配置管理，内部升级为四个 Tab 或子路由：

服务商配置。
接口/工作流配置。
场景绑定。
调用日志。

服务商配置页

列表展示：

服务商名称。
类型。
Base URL。
环境。
状态。
健康状态。
更新时间。

操作：

新增。
编辑。
测试连接。
启用/禁用。
查看关联接口。

接口/工作流配置页

列表展示：

接口名称。
编码。
服务商。
类型。
路径 / Workflow。
是否流式。
状态。
最近测试结果。

表单包含：

服务商。
HTTP 方法。
接口路径或完整 URL 覆盖。
botId、workflowId、appId。
请求模板 JSON。
响应解析规则 JSON。
超时和重试。
流式、文件上传等能力开关。

场景绑定页

列表展示：

场景名称。
sceneCode。
当前绑定接口。
服务商。
兜底接口。
环境。
状态。

操作：

切换接口配置。
配置兜底接口。
场景测试。
启用/禁用。
查看调用日志。

调用日志页

列表展示：

时间。
场景。
服务商。
接口配置。
状态。
耗时。
错误信息。

详情展示：

请求 URL。
请求头，敏感字段脱敏。
请求体。
原始响应。
解析结果。
fallback 信息。

运行时行为

立即生效

每次 AiRuntimeService.invoke 都从数据库读取当前启用的场景绑定、接口配置和服务商配置。因此以下修改在保存后立即影响下一次调用：

服务商 Token。
服务商 Base URL。
接口路径。
Workflow ID。
请求模板。
响应解析规则。
场景绑定的 endpoint。
启用/禁用状态。
兜底配置。

本期不做长期缓存。后续如增加缓存，必须基于 update_time 或版本号自动失效。

后台保存配置时不需要重启服务。运行时读取顺序固定为：

scene_code + environment
  -> enabled ai_scene_binding
  -> enabled ai_endpoint_config
  -> enabled ai_provider

任一层不存在或禁用，调用失败并写日志，不静默降级到旧配置。

运行环境来源固定为后端当前环境配置，例如 Spring Profile 或项目已有环境变量。业务代码不从前端请求参数读取 environment，避免用户侧伪造环境导致误路由。

配置生效与切换保护

立即生效只针对已启用配置。新增或编辑 provider、endpoint、scene 时，保存动作只落库；是否进入运行时由 is_enabled 控制。

生产环境建议采用以下切换流程：

保存 provider 或 endpoint 后先保持禁用。
在后台执行 provider 测试、endpoint 测试或 scene 测试。
测试成功后再启用 endpoint 或 scene binding。
切换场景绑定时，后台记录切换前 endpoint、切换后 endpoint、操作者、时间和测试 traceId。
如果切换后出现失败，可直接把 scene 绑定切回上一条 endpoint 配置，下一次调用立即生效。

后台可以先实现为确认弹窗和审计日志，不强制做审批流。若后续生产切换风险升高，再增加“双人复核”或“待发布配置”状态。

兜底策略

主配置成功 -> 返回主配置结果
主配置失败且存在 fallback_endpoint_id -> 调用兜底配置
主配置失败且不存在 fallback_endpoint_id -> 返回业务可识别错误

调用日志必须记录主配置失败原因和是否发生 fallback。

禁用策略

服务商禁用：其下接口不可被调用。
接口配置禁用：不可作为主配置或兜底配置调用。
场景禁用：业务调用直接返回明确错误。
后台绑定时应提示禁用配置不可绑定，或允许保存但不可启用。

安全与审计

管理后台编辑页允许输入完整 Key，但列表页和详情页默认脱敏展示。
只有显式“显示密钥”操作才展示完整 Key，并记录管理员操作日志。
ai_call_log 永远不保存明文 Token。
测试请求中的请求头展示也必须脱敏。
所有配置新增、修改、启用、禁用、场景切换都写入后台操作审计日志。
不允许前端直接调用外部 Dify/Coze URL 进行正式测试；正式测试走后端 /ai/runtime/test，避免 Token 暴露到浏览器。

迁移策略

第一期保留 t_ai_config。

迁移脚本将现有 Coze 配置拆分为：

t_ai_config.provider/apiBaseUrl/apiToken -> ai_provider
t_ai_config.botId/workflowId/customParams -> ai_endpoint_config
t_ai_config.usageScenario/configKey -> ai_scene_binding 初始绑定

Dify 初始化：

从 docs/dify平台接口.md 的基础地址创建 dify_default provider。
为短片小说生成创建 Dify endpoint。
为剧本生成创建 Dify endpoint。
分别创建 short_story_generate、script_generate 的 scene 绑定。

旧配置键到新场景建议映射：

旧配置键	新场景
`coze.chat.default`	`chat`
`coze.course.life.generate`	`script_generate`
`coze.user.dairy.summary`	`diary_summary` 或 `life_healing`
`coze.emotion_analysis.default`	`emotion_analysis`
`coze.summary.default`	`emotion_summary`

迁移后，业务代码逐步从 callWorkflowByConfigKey(configKey, ...) 迁移到 invoke(sceneCode, ...)。

迁移后的兼容规则：

新场景优先走 AiRuntimeService。
尚未迁移的旧调用继续走 AiChatServiceImpl 和 t_ai_config。
如果新路由调用失败，不自动回退到旧 t_ai_config，除非该场景显式配置了 fallback endpoint。
每迁移一个业务场景，都要删除该业务中的硬编码 coze.* 配置键引用。

回滚方式：

保留旧 t_ai_config 和旧调用代码直到所有关键场景验收通过。
如果某个场景新路由异常，可在后台将该 sceneCode 绑定切回 Coze endpoint。
如果新 runtime 服务整体异常，可通过配置开关让指定业务临时回退旧方法；该开关只作为过渡保护，不作为长期设计。

实施顺序

新增数据库表、实体、Mapper、DTO、Service、Controller。
新增 AiRuntimeService 和 provider adapter 接口。
实现 DifyProviderAdapter 和 CozeProviderAdapter。
实现 endpoint 测试和 scene 测试。
升级 web-admin AI 配置管理为四个页面。
编写迁移脚本和初始数据。
将短片小说生成、剧本生成迁到 sceneCode 调用。
将对话、日记总结、情绪分析、疗愈等旧 Coze 场景逐步迁到 sceneCode。
保留旧 AiConfig 页面或提供只读迁移视图，确认稳定后再下线。

每一步交付都应保持系统可启动、已有 Coze 对话不回归。

测试计划

后端测试：

AiRuntimeServiceTest：验证场景路由、禁用状态、fallback。
DifyProviderAdapterTest：验证 Dify 请求体生成和 answer 解析。
DifyProviderAdapterStreamTest：验证 Dify SSE 的 message 拼接、message_end 结束和 error 失败处理。
CozeProviderAdapterTest：验证 Coze 请求体生成和 SSE 解析。
AiTemplateRendererTest：验证占位符替换、对象注入、缺失变量报错和 JSON 校验。
迁移脚本测试：验证旧 t_ai_config 能拆成 provider、endpoint、scene。

前端测试：

服务商配置可创建、编辑、启用、禁用和测试连接。
接口配置可按服务商生成默认请求模板。
场景绑定切换后，场景测试走新的接口配置。
禁用配置后不能被正常调用。
测试请求不在浏览器暴露明文 Token。

集成验收：

短片小说生成绑定 Dify 后能返回可解析结果。
剧本生成绑定 Dify 后能返回可解析结果。
对话绑定 Coze 后保持现有可用。
将剧本生成从 Dify 切回 Coze 后，不发版，下一次调用立即生效。
主配置失败且配置了兜底时，调用日志记录 fallback。

风险与缓解

风险	缓解
Dify 与 Coze 响应结构不同	使用 provider adapter 和 response_parser 隔离差异
请求模板过于自由导致配置错误	后台提供 Dify、Coze 默认模板，并在测试时校验 JSON
立即生效可能导致误操作影响线上	增加测试按钮、启用状态、环境隔离和调用日志
旧业务调用链较长	分阶段迁移，旧 `t_ai_config` 保留兼容
Token 暴露风险	管理后台可编辑但日志和普通详情默认脱敏
请求模板配置错误导致线上失败	保存时校验 JSON，测试通过后再允许启用场景绑定
场景切换误操作影响生产	环境隔离、操作审计、场景测试和明确启用开关

验收标准

管理员可以在后台创建 Dify 和 Coze 服务商。
管理员可以创建 Dify /chat-messages endpoint 和 Coze workflow endpoint。
管理员可以在场景绑定页将 script_generate、short_story_generate、chat 绑定到任意启用 endpoint。
后台场景测试可以展示原始响应和解析结果。
业务调用只依赖 sceneCode，不再需要知道当前场景使用 Dify 还是 Coze。
修改场景绑定后，下一次业务调用立即走新配置。
调用日志能区分服务商、接口配置、场景、成功/失败和 fallback。
Dify blocking 和 streaming 两种响应都能被后台测试解析。
管理后台和调用日志不泄露明文 Token。
旧 Coze 对话在迁移期间保持可用。

25 KiB Raw Blame History Unescape Escape

AI 场景路由配置中心设计

背景

现状

设计目标

非目标

总体架构

模块边界

数据模型

ai_provider

ai_endpoint_config

ai_scene_binding

ai_call_log

初始场景编码

Dify 适配

Coze 适配

请求模板与响应解析

模板变量

响应解析

后端接口

服务商接口

接口/工作流接口

场景绑定接口

运行时测试接口

后台页面

服务商配置页

接口/工作流配置页

场景绑定页

调用日志页

运行时行为

立即生效

配置生效与切换保护

兜底策略

禁用策略

安全与审计

迁移策略

实施顺序

测试计划

风险与缓解

验收标准

25 KiB

Raw Blame History