95 lines
3.6 KiB
Markdown
95 lines
3.6 KiB
Markdown
---
|
||
context:
|
||
module: "intent-driven-script"
|
||
feature: "IDS-Backend"
|
||
status: "✅已完成"
|
||
version: "1.0.0"
|
||
active_ac_range: "AC-IDS-01~13"
|
||
role: "backend"
|
||
|
||
spec_references:
|
||
requirements: "spec/intent-driven-script/requirements.md"
|
||
design: "spec/intent-driven-script/design.md"
|
||
tasks: "spec/intent-driven-script/tasks.md"
|
||
openapi: "spec/intent-driven-script/openapi.admin.yaml"
|
||
|
||
overall_progress:
|
||
- [x] Phase 1: 数据模型与 API 扩展 (100%)
|
||
- [x] Phase 2: 后端话术生成引擎 (100%)
|
||
- [x] Phase 4: 测试与验证 (100%)
|
||
|
||
current_phase:
|
||
goal: "后端开发已完成"
|
||
sub_tasks:
|
||
- [x] Task 1.1: 扩展 Python 类型定义 ✅
|
||
- [x] Task 1.3: 更新 OpenAPI 契约 ✅ (已定义在 spec/)
|
||
- [x] Task 1.4: 验证 API 向后兼容性 ✅
|
||
- [x] Task 2.1: 创建 ScriptGenerator 模块 ✅
|
||
- [x] Task 2.2: 创建 TemplateEngine 模块 ✅
|
||
- [x] Task 2.3: 扩展 FlowEngine ✅
|
||
- [x] Task 2.4: 修改 FlowEngine.start() ✅
|
||
- [x] Task 2.5: 修改 FlowEngine.advance() ✅
|
||
- [x] Task 2.6: 实现 Fallback 机制 ✅
|
||
- [x] Phase 4: 单元测试 ✅ (32 tests passed)
|
||
|
||
next_action:
|
||
immediate: "后端开发完成，等待前端联调"
|
||
details:
|
||
file: "N/A"
|
||
action: "通知前端进行联调"
|
||
constraints: "无"
|
||
|
||
technical_context:
|
||
module_structure: "ai-service/app/services/flow/"
|
||
key_decisions:
|
||
- decision: "在现有 FlowStep SQLModel 中扩展字段"
|
||
reason: "steps 字段已经是 JSON 类型，可以直接扩展，无需数据库迁移"
|
||
impact: "保持向后兼容，现有流程无需修改"
|
||
- decision: "ScriptGenerator 和 TemplateEngine 作为独立模块"
|
||
reason: "遵循单一职责原则，便于测试和维护"
|
||
impact: "需要在 FlowEngine 中注入 LLM 客户端"
|
||
- decision: "LLM 调用超时设置为 2 秒"
|
||
reason: "对话系统需要快速响应，2 秒是可接受的上限"
|
||
impact: "超时后返回 fallback 话术"
|
||
code_snippets: |
|
||
# FlowStep 扩展字段
|
||
script_mode: str = Field(default=ScriptMode.FIXED.value)
|
||
intent: str | None = Field(default=None)
|
||
intent_description: str | None = Field(default=None)
|
||
script_constraints: list[str] | None = Field(default=None)
|
||
expected_variables: list[str] | None = Field(default=None)
|
||
|
||
# FlowEngine 话术生成
|
||
async def _generate_step_content(step, context, history) -> str:
|
||
script_mode = step.get("script_mode", "fixed")
|
||
if script_mode == "fixed":
|
||
return step.get("content", "")
|
||
elif script_mode == "flexible":
|
||
return await self._script_generator.generate(...)
|
||
elif script_mode == "template":
|
||
return await self._template_engine.fill_template(...)
|
||
|
||
session_history:
|
||
- session: "Session #1 (2026-02-28)"
|
||
completed:
|
||
- Task 1.1: 扩展 Python 类型定义
|
||
- Task 2.1: 创建 ScriptGenerator 模块
|
||
- Task 2.2: 创建 TemplateEngine 模块
|
||
- Task 2.3-2.6: 扩展 FlowEngine
|
||
- Phase 4: 单元测试 (32 tests)
|
||
changes:
|
||
- ai-service/app/models/entities.py (新增 ScriptMode 枚举，扩展 FlowStep)
|
||
- ai-service/app/services/flow/script_generator.py (新建)
|
||
- ai-service/app/services/flow/template_engine.py (新建)
|
||
- ai-service/app/services/flow/engine.py (重构)
|
||
- ai-service/app/services/flow/__init__.py (更新导出)
|
||
- ai-service/tests/test_script_generator.py (新建)
|
||
- ai-service/tests/test_template_engine.py (新建)
|
||
- ai-service/tests/test_flow_engine_script_generation.py (新建)
|
||
|
||
startup_guide:
|
||
- "Step 1: 读取本进度文档"
|
||
- "Step 2: 读取 spec_references 中的规范"
|
||
- "Step 3: 执行 next_action"
|
||
---
|