Agent 与自动化AI 资源
AI Helpdesk：为客服坐席生成回复建议的模块化单体参考实现
Giansantos-carlos/ai-helpdesk · Projeto de referencia: helpdesk com assistente de IA demonstrando Spec Driven Development, Arquitetura Monolitica Modular, Context Engineering, Code Review e Quality Gate
ELI5：它是什么，解决什么问题
这是一个 Java/Spring Boot 的 helpdesk 参考项目，包含用户、知识库、工单与 AI 助手四个模块。助手模块监听工单创建事件，实时排序工单历史与知识库文章，在字符预算内截断后组装上下文，调用 Anthropic Claude API 生成回复建议并持久化，供坐席查询。项目主要用于演示 Spec Driven Development、模块化单体架构、上下文工程、代码评审与质量门禁五类工程实践，README 明确说明它并非可直接投入生产的完整产品。
核心能力与快速开始
★ 0 · Java
- 能做什么
- 以细模块垂直切片的形式实现 helpdesk 场景：管理用户、知识库文章（Postgres tsvector 关键词检索）、工单与消息；assistant 模块通过 Spring 事件异步响应 TicketCreated，由 ContextBuilder 对工单历史与知识库文章打分排序、按字符预算截断，再经 ClaudeAssistantClient 调用 Anthropic /v1/messages 生成建议并写入 reply_suggestions（READY/FAILED）；模块间仅通过公开查询接口与事件通信，并由 Spring Modulith 的 ModularityTests 自动校验边界；CI 含 Checkstyle、SpotBugs、Semgrep 与 JaCoCo 覆盖率门禁。
- 适用场景
- 适合作为学习与教学材料阅读：了解如何在一个可部署单体中组织模块化边界、如何做事件驱动的异步 AI 调用、如何设计上下文排序与截断策略，以及如何将规范文档、代码评审与质量门禁串成流程；也可作为团队内部搭建 AI 客服建议功能的架构参照。
- 项目形态
- 开发框架
- 部署方式
- 本地运行：docker compose 启动 Postgres，执行 mvn spring-boot:run；单可部署单元。仓库的 deploy.yml 仅构建 jar 并打印日志，没有真实目标基础设施。
- 主要依赖
- 需 Java 与 Maven 环境、Docker（启动 Postgres，部分集成测试依赖 Testcontainers）；需自行提供 ANTHROPIC_API_KEY 才能生成建议，未提供时建议状态为 FAILED（降级处理）。具体 Java 版本、资源规格与 API 调用成本未说明。
- 使用限制
- README 自述不是完整产品，不适合按现状上生产；没有真实身份认证；知识库为关键词检索而非向量检索，同义词可能检索不到；上下文预算以字符数估算而非真实 token；没有跨模块物理外键；没有持久化 outbox，进程中断会丢失处理；JaCoCo 60% 覆盖率阈值为演示用任意值；CODEOWNERS 指向单一维护者；本机 Docker Engine 过新时 Testcontainers 集成测试可能失败。
- 许可证
- 未说明
- 最近推送
- 2026-10-20 07:52
资料检查：2026-10-21 07:00 · 卡片整理：2026-10-21 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证
讨论 0
登录后参与讨论，阅读资讯无需注册。
还没有评论，来分享第一个看法。