构建企业级智能搜索与 AI Agent 平台:Coco 架构解析
在当今的企业级应用中,单纯的关键字搜索已无法满足复杂的信息获取需求。Coco 项目展示了一个现代化的、集成了 AI Agent(智能体)、RAG(检索增强生成) 和 全渠道知识库连接 的智能搜索平台架构。本文将深入剖析其技术实现与核心 Agent 设计。
1. 系统架构概览
Coco 采用前后端分离的架构,后端负责核心的 Agent 编排、知识索引与 LLM 交互,前端则提供高度交互式的 AI 对话体验。
后端架构 (Go)
后端基于 Go 语言构建,核心模块划分清晰,体现了 插件化 和 模块化 的设计思想:
- Core Domain (
/core): 定义了系统核心实体,包括Assistant(助手)、Session(会话)、Message(消息)、DataSource(数据源)以及MCPServer(模型上下文协议服务器)。 - Modules (
/modules): 业务逻辑层。assistant: 核心 Agent 逻辑,集成了langchain用于编排,包含deep_research(深度研究)和deep_search(深度搜索)子模块。llm: 统一的大模型接口层,适配不同的 LLM Provider。connector: 连接器管理,负责对接外部数据源。
- Plugins (
/plugins): 极其丰富的插件系统,包含数十种数据源连接器(Connectors),如 GitHub, GitLab, Jira, Notion, S3, SQL Databases 等,为 RAG 提供了强大的数据支撑。
前端架构 (React + Vite Monorepo)
前端采用 Monorepo 结构管理 UI 组件库,确保了 Agent 能力在不同宿主环境(如独立搜索页、嵌入式挂件)中的复用性:
@infinilabs/ai-chat: 核心对话交互组件,封装了流式响应处理、会话管理。@infinilabs/chat-message: 复杂消息渲染引擎,支持 Markdown、思维链(Think)、工具调用(CallTools)和深度研究报告(DeepResearch)的渲染。@infinilabs/ai-answer: 针对即时问答场景的轻量级组件。
2. AI Agent 核心能力
Coco 的 Agent 不仅仅是一个聊天机器人,它具备了执行复杂任务的能力。
2.1 深度研究 (Deep Research)
项目在 modules/assistant/deep_research 和前端组件 DeepResearch 中实现了深度研究功能。这意味着 Agent 可以:
- 多步推理: 拆解用户问题,进行多轮搜索和思考。
- 思维链可视化: 前端通过
<Think />组件展示 Agent 的思考过程(CoT),增强用户信任。 - 生成研究报告: 最终输出结构化的研究报告,而不仅仅是简单的对话回复。
2.2 模型上下文协议 (MCP) 支持
Coco 原生支持 MCP (Model Context Protocol),这在 core/mcp_server.go 和 plugins/mcp 中有明确体现。
- 标准化工具调用: 通过 MCP,Agent 可以以标准方式连接外部工具和数据,无需为每个工具编写特定的胶水代码。
- 可扩展性: 开发者可以轻松添加新的 MCP Server,扩展 Agent 的能力边界。
2.3 强大的 RAG 知识引擎
Agent 的智能离不开数据。Coco 的 plugins/connectors 目录展示了其强大的数据集成能力:
- 全源接入: 支持代码仓库 (GitHub/GitLab)、文档协作 (Notion/Feishu/Confluence)、文件存储 (S3/Local FS) 和 结构化数据 (MySQL/PostgreSQL/MongoDB)。
- 统一索引: 通过
modules/datasource和modules/document将异构数据统一索引,供 Agent 在回答问题时进行语义检索。
3. 前端交互细节与体验优化
优秀的 Agent 需要极致的交互体验,Coco 前端在这方面做了大量工作:
3.1 流式响应与增量渲染
在 ui-common/packages/AIChat/src/api/streamFetch.ts 中,实现了基于 SSE (Server-Sent Events) 或流式 Fetch 的响应处理。前端能够实时解析 LLM 返回的数据块(Chunk),并动态更新 UI,降低用户感知的延迟。
3.2 复杂消息体渲染
ChatMessage 包不仅仅渲染文本,它还能处理:
- 工具调用状态: 显示 Agent 正在调用哪个工具(如 "Searching database...")。
- 引用溯源: 在回答中通过
<Citation />组件高亮引用来源,点击可跳转至原始文档。 - 多模态附件: 支持上传和展示图片、文档等附件,供多模态模型理解。
3.3 模块化 UI 设计
通过将 AIChat、SearchBox、CommandCenter 拆分为独立包,Coco 可以灵活地构建多种产品形态:
- 全屏搜索: 类似 Google/Perplexity 的沉浸式搜索体验。
- 悬浮助手: 嵌入在业务系统右下角的 Copilot。
- 命令中心 (Launcher): 类似 Spotlight 的快捷启动与问答入口。
4. 总结
Coco 项目展示了一个企业级 AI Agent 平台的完整技术蓝图:后端通过 Go 语言的高并发能力和丰富的连接器生态构建了坚实的 RAG 基座;前端通过 React 组件化和精细的交互设计提供了流畅的 Agent 体验。特别是对 Deep Research 和 MCP 的支持,标志着它已从简单的对话系统进化为具备自主解决问题能力的智能体平台。
