AgentChat 智能对话平台
面向知识检索、工具调用与协作任务的自托管智能对话平台。
- Star 数
- ★ 929
- 最近更新
- 19 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 29/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 高 · 需要较重的基础设施
- 开始前需要
- 典型场景
- 需要把内部资料用于问答的团队，可将资料接入知识库，以语义检索和 RAG 回答用户问题。
- 不适合
- 希望开箱即用、不想自建 MySQL、Redis 与向量库的团队
- 仍在使用 LangChain 0.x 旧版工具与 Agent 配置的项目
这个 Agent 能做什么，适合哪些场景？
AgentChat 是一个前后端分离的大语言模型智能对话系统，后端采用 FastAPI，前端采用 Vue 3 与 Element Plus。它提供默认智能体和用户自定义智能体，支持多轮对话、子智能体协作、任务工作流及工具多轮调用。知识库模块可处理多种格式的内容，进行语义分块和向量检索，并用于 RAG 问答。系统还支持 MCP Server 的运行时动态加载，以及通过 HITL 将 OpenAPI 信息对话式生成为 MCP Server。可通过 Docker Compose 部署，也可分别启动 Python 后端和 Node.js 前端；MySQL、Redis 和可选的 Milvus、ChromaDB、Elasticsearch 构成其部署与检索边界。
用户在 Vue 前端与智能体进行多轮交流，系统保留 3000 tokens 以内的短期上下文、自动总结更早历史，并持久化用户偏好等长期记忆。智能体可执行依赖式工具调用，例如按 A → B → C 的顺序把前一工具结果传给后一工具；项目还提供 10+ 内置工具，并允许上传 Swagger/OpenAPI 构建自定义工具。知识库流程对多格式内容做语义分块和向量检索，再用于 RAG 问答。对于 OpenAPI 信息，HITL 流程在关键决策点请求人工确认，并产出 MCP Server 配置结果。后端以 FastAPI 提供服务，启动后可通过 /docs 访问 Swagger 文档。
- 需要把内部资料用于问答的团队，可将资料接入知识库，以语义检索和 RAG 回答用户问题。
- 希望把多个 API 串成任务步骤的业务人员，可上传 Swagger/OpenAPI 构建自定义工具，并让智能体按依赖顺序多轮调用。
- 需要审查自动生成服务的开发者，可在 OpenAPI 到 MCP Server 的对话式生成过程中于关键节点介入确认。
- 同时管理多个对话型应用的运营人员，可在工作区与应用中心之间切换，并按智能体、模型和时间范围查看调用次数与 Token 用量。
- 需要部署私有对话服务的工程团队，可使用 Docker Compose，或分别运行 FastAPI 后端和 Vue 前端。
如何安装或部署这个 Agent？
文档列出的运行条件为 Python 3.12+、Node.js 18+、MySQL 8.0+、Redis 7.0+ 和 Docker 20.10+。Docker 部署：git clone https://github.com/Shy2593666979/AgentChat.git，cd AgentChat，编辑 docker/docker_config.yaml，再执行 cd docker 和 docker-compose up --build -d。本地部署时，在 src/backend 执行 pip install -r requirements.txt，或先安装 uv 后执行 uv sync；在 src/frontend 执行 npm install 和 npm run dev。文档未给出模型供应商凭据字段、MySQL/Redis 初始化步骤，或可复制的首个 API 请求，因此这些配置需在部署前另行确认。
如何使用这个 Agent？
启动后端后访问 /docs 查看 Swagger 文档；启动前端后，通过界面创建或使用智能体进行多轮对话。可将知识库内容用于 RAG 问答，上传 Swagger/OpenAPI 创建自定义工具，或在 HITL 流程中根据 OpenAPI 信息生成 MCP Server。首次启动若缺少模型配置，项目说明会进行配置检查并给出引导提示；但文档未说明具体模型配置位置、凭据格式或首个可调用接口。
这个 Agent 有哪些优点和局限？
- 将 RAG、语义分块、向量检索、工具调用和多智能体协作整合在同一前后端平台中。
- 支持依赖式多轮工具调用，可表示 A → B → C 的工具执行顺序。
- OpenAPI 到 MCP Server 的生成过程具备 HITL 人工确认点，适合需要控制关键决策的场景。
- 三层记忆明确区分 3000 tokens 内的短期上下文、历史总结和持久化长期偏好。
- 模型供应商、凭据配置字段和具体首个 API 调用未在提供的文档中说明。
- 本地运行依赖 Python、Node.js、MySQL、Redis，Docker 路径还需要 Docker，运维组成较多。
- 从 v2.2.0 起升级到 LangChain 1.0+；旧版 0.x 的工具和智能体配置存在迁移风险。
- Milvus、ChromaDB、Elasticsearch、OSS 与 MiniO 的选型和完整配置细节未在提供内容中展开。
这个 Agent 与同类方案有什么区别？
部署说明明确列出 Milvus 或 ChromaDB 作为可配置的向量数据库，并提到 Elasticsearch；对象存储支持 OSS 和 MiniO。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AgentChat 智能对话平台 当前 | 29 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 929 | 19 天前 | Python | — |
| Tribe AI | 45 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 1.1k | 1 年前 | TypeScript | OpenAI API |
| CoordClaw 多智能体协作系统 | 42 · 缺口较多 | — | ★ 160 | 2 个月前 | TypeScript | — |
| DeepTutor 终身个性化辅导系统 | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 55k | 今天 | Python | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示存在基于用户ID的权限检查（如mcp_agent.py中的update/delete），但权限模型简单，且未发现用户确认机制（如HITL仅用于MCP生成，非工具调用确认）。数据流透明度不足，未说明用户数据如何被处理或传输。敏感数据处理未见专门措施。依赖安全未提及，外部效果（如工具调用）缺乏明确限制。回滚机制未提及。来源归属：README和LICENSE明确作者为MingGuang Tian，但发布者未验证。
代码中多处使用try-except并记录日志，但错误处理不统一，部分函数返回None而非错误信息。依赖可用性未验证，README声称支持多种数据库和向量库，但未提供配置细节。失败消息不友好，用户可能得不到明确提示。
README描述了多种使用场景（如天气查询、文生图），但能力边界不清晰，未说明哪些操作是安全的。触发精度一般，工具调用依赖LLM决策，缺乏明确规则。环境适配有Docker和本地部署说明，但依赖较多，配置复杂。
信息架构清晰，有目录和文档链接。安装说明详细，但依赖版本要求较高。命名稳定性一般，版本更新频繁。示例和FAQ较少，已知限制未提及。许可证为MIT，版本更新日志存在。维护责任由作者承担，但未明确社区支持。
输出可用性一般，主要依赖LLM生成，但未提供输出格式规范。边际价值较高，提供了多种高级功能。成本效益未评估，未提供性能或成本数据。
README中的功能声明缺乏代码级验证，部分功能（如HITL）在代码中未找到对应实现。跨来源佐证不足，仅依赖README。事实与推断未明确区分。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 权限模型简单，可能无法满足多租户安全需求。
- 未发现用户确认机制，工具调用可能自动执行，存在风险。
- 依赖安全未评估，存在供应链风险。
- 数据流不透明，用户数据可能被发送至第三方LLM服务。