Knowledge Support AI Agent 被描述为对话式 AI 客服智能体的生产级参考实现。它的目的是展示如何使用整洁架构(Clean Architecture)来构建真实场景的 AI 后端,从一开始就包含 RAG、语义记忆、持久的聊天历史和服务商独立性。项目称业务逻辑与 LLM 服务商、数据库和消息平台相隔离,使每一层都可独立测试和替换。WhatsApp Cloud API 是预期的沟通渠道,同时提供 REST API 用于直接集成和本地开发。系统包含的功能有:为每个联系人保留持久历史的对话式聊天、通过语义搜索的 RAG 检索、结合向量相似度和 PostgreSQL 全文搜索的混合搜索、带 pgvector 索引的文档摄取、工具调用、对话历史优化、查询改写、上下文压缩、服务商独立性、OpenTelemetry 埋点、限流、错误处理和安全响应头。它还提供 REST API 和 CLI 接口。
团队用该智能体为每个联系人提供带持久历史的对话式聊天。
团队用 RAG 在每一轮通过语义搜索检索知识块。
团队用混合搜索把向量相似度与 PostgreSQL 全文搜索通过倒数排名融合(Reciprocal Rank Fusion)结合起来。
团队用文档摄取对文档进行分块、嵌入,并在 pgvector 中建立索引,认证方式可插拔。
团队用工具调用访问 search_documents 和 get_current_date,并带有输入验证、查询净化和执行超时。
团队用服务商独立性在配置时更换聊天和嵌入服务商。
团队用 OpenTelemetry 埋点获取用例和 RAG 流水线的 span 与指标。
团队用 REST API 和 CLI 接口进行直接集成和本地开发。