ai-ticket-platform/docs/development/ai-platform-demo-acceptance.md

AI 平台配置演示版验收

更新日期：2026-07-14

验收状态

检查项	状态	证据
后端自动化	已通过	71 项 pytest；Ruff、迁移漂移与 Django system check 通过
全新数据库迁移	已通过	测试配置下从空库应用全部迁移
前端自动化	已通过	11 项 Vitest；ESLint、类型检查与生产构建通过
真实模型三步运行	待执行	凭证仅允许管理员在本地录入，不进入仓库

真实模型三步运行通过前，本演示版只能描述为“实现完成、真实渠道验收待完成”。

前置条件

• 使用桌面端浏览器和系统管理员账号。
• .env 已设置独立的 AI_CREDENTIAL_ENCRYPTION_KEY。
• PostgreSQL、Redis、Django、Celery worker、Celery Beat 和前端均已启动。
• 已准备一个允许聊天补全、能够输出 JSON 的 OpenAI-compatible 文本模型渠道。

固定端到端脚本

1. 管理员登录空白环境，确认 AI 能力菜单包含 Agent、运行记录、Skill 和模型渠道。
2. 打开 #/modelhub/providers，创建渠道并在密码输入框录入真实凭证；保存后确认页面只显示末四位脱敏值。
3. 创建文本模型配置并执行连通测试，等待状态变为“成功”；记录测试 UUID、Token 是否由渠道提供以及耗时。
4. 在后端执行 python manage.py seed_ai_demo --deployment-id <模型配置 ID>，确认生成三个已发布 Skill 和一个技术支持分析 Agent 草稿。
5. 打开 #/skills，进入每个 Skill，校验并格式化输入/输出 Schema；编辑草稿后发布。
6. 打开 #/agents，检查三个有序步骤及其输入映射，按需调整模型参数，并以示例输入运行草稿沙箱。
7. 在运行详情确认执行脊柱包含“问题结构化、排查建议、客户回复草稿”，最终输出等于最后一步输出；检查每步版本、输入输出、调用尝试、Token、耗时和配置快照。
8. 发布 Agent，再运行已发布版本；确认运行记录不再标记沙箱。
9. 修改配置并创建新版本，回看旧运行，确认旧运行仍显示原 Agent、Skill、模型和参数快照。
10. 创建一个不具备 model.manage、skill.manage、agent.manage、agent.use、agent.run.view 的账号，确认入口隐藏，直接请求相应 API 返回 403。
11. 查看操作审计，确认存在渠道、模型测试、Skill/Agent 发布回滚、运行启动/结束和取消记录；确认审计中不存在明文密钥、完整 Prompt、完整输入或完整模型响应。

失败路径抽查

• 将测试渠道凭证替换为无效值，确认鉴权失败立即终止且不重试。
• 使用可控兼容服务返回一次 429 或 5xx，确认只退避重试一次。
• 让模型首次返回不符合 Schema 的内容，确认出现一次 structure_repair；第二次仍无效时运行失败且后续步骤不执行。
• 对排队任务执行取消，确认立即变为 cancelled；对运行中任务取消，确认当前模型请求返回后不再开始下一步。

验收记录模板

日期：
执行人：
渠道名称 / 模型名：
模型测试 UUID：
草稿运行 UUID：
发布运行 UUID：
旧版本快照检查：通过 / 不通过
权限与审计检查：通过 / 不通过
结论：通过 / 不通过
备注（禁止粘贴密钥和完整敏感输入）：