ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

AgentChat自定义智能体实战教程:4步为AI助手绑定工具、MCP与知识库

AgentChat自定义智能体实战教程:4步为AI助手绑定工具、MCP与知识库
  • 人工智能
  • 大模型
  • AI 应用
  • AI Agent
  • RAG
  • 后端
  • 前端

【免费下载链接】AgentChat

AgentChat 是一个基于 LLM 的智能体交流平台,内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作,Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术,实现高效的知识检索与工具调用,使用 FastAPI 构建高性能后端服务。

项目地址:https://gitcode.com/gh_mirrors/age/AgentChat
点击查看免费下载

AgentChat 是一个基于 LLM 的智能体交流平台,支持用户自定义 Agent,并为其绑定工具、MCP、Skill 与知识库。本教程带你用 4 步完成一次完整的 AgentChat 自定义智能体配置:从准备资源到绑定能力,让你的 AI 助手真正"长出手脚",能搜索、发邮件、查天气,还能读懂你的私有文档。

先看懂智能体配置界面:3个Tab各管什么

进入左侧边栏的智能体页面,点击右上角创建智能体,会进入 AgentChat 智能体编辑界面(源码位于 agent-editor.vue)。整个编辑页分为 3 个 Tab:

Tab作用必填项
基础信息名称、描述、Logo、选择大模型名称、描述、大模型
提示词编写系统提示词(system prompt)系统提示词
高级设置绑定工具、MCP、Skill、知识库,开关记忆无

💡 小提示:模型、工具、MCP、知识库这四类"原料"需要先在各自的管理页面准备好,配置界面才会显示可选列表。

第1步:提前备好智能体能力资源

1.1 配置工具(Tools)

点击左侧工具页面,AgentChat 内置了约 18 个开箱即用的工具,覆盖办公协作、文档处理、信息检索、内容创作、生活服务几大类,例如发送邮件、联网搜索、论文检索、天气预博、PDF转Docx 等。

  • 内置工具:直接查看参数即可使用。
  • 自定义工具:点击右上角创建工具,或通过导入 OpenAPI 方式扩展业务能力,相关说明见 docs/reference/agentchat.md。

1.2 连接 MCP 服务器

MCP(Model Context Protocol)让智能体接入外部工具与数据服务。AgentChat 的 MCP 页面默认自带 3 个服务:高德地图、必应搜索、Parallel 搜索,均为"已添加"状态,可直接绑定使用,详见 docs/mcp-defaults.md。

如需接入自己的服务,点击添加服务填写 SSE / Streamable HTTP 地址即可,AgentChat 会自动发现并生成该服务的工具列表。

1.3 创建知识库(RAG 私有知识)

点击左侧知识库,先点击创建知识库建立你的专属知识空间,再上传 PDF、DOCX、TXT 等资料。AgentChat 会自动完成文档解析、向量化入库,检索后还会经过重排(Rerank),保证回答有据可依。

⚠️ 知识库依赖向量模型与重排模型,请确认模型服务页已配置对应能力,参考 docs/simple-config.md。

第2步:创建智能体并填写基础信息

回到智能体页面点击创建智能体,在"基础信息"Tab 中:

  1. 名称:起一个有辨识度的名字,如"旅行研究助手";
  2. 描述:一句话说清它能做什么,会展示在智能体卡片上;
  3. Logo:上传头像,增强识别度;
  4. 选择大模型:从模型服务页已添加的模型中挑选(如 GPT、DeepSeek、Qwen 等)。展示名称与实际调用标识分别管理,以服务商要求的标识为准。

每个字段的校验规则可在 agent.ts 的接口类型定义中看到:name、description、system_prompt、llm_id为创建时必填,tool_ids、mcp_ids、knowledge_ids默认为空列表。

第3步:编写系统提示词

切换到"提示词"Tab。系统提示词决定了智能体的"性格"与行为边界,是自定义智能体效果好坏的关键。

  • 零基础用户:可直接使用 AgentChat 内置的 3 个提示词模板——深度研究助手、写作助手、数据分析助手,一键应用后按需微调;
  • 进阶用户:建议按"角色定义 → 工作流 → 输出约束"的结构撰写,例如:

你是一位旅行研究助手。先明确用户的目的地与预算,再调用搜索工具收集景点、交通信息,最后输出结构清晰、标注来源的行程建议。

第4步:绑定工具、MCP与知识库

切换到"高级设置"Tab,在能力配置区域为智能体勾选四类能力,勾选即绑定:

能力字段适合场景
工具tool_ids发送邮件、联网搜索、文件转换等原子操作
MCPmcp_ids调用高德地图、搜索服务等外部 MCP 工具集
Skillagent_skill_ids研究报告、代码审查等六类技能模板
知识库knowledge_ids基于私有文档的问答(RAG)

另外还有记忆开关(enable_memory):开启后智能体可在后续会话中调用历史信息,适合长期协作场景。

配置完成后保存,智能体卡片就会出现在列表中,点击开始对话即可体验:

发起对话,验证绑定效果

在会话页选择刚创建的智能体,测试两类问题:

  • 工具类:「帮我查一下杭州今天的天气」——验证工具/MCP 绑定是否生效;
  • 知识类:提问与知识库文档内容相关的问题——验证 RAG 检索是否命中。

同一会话内还可以随时切换其他智能体,观察不同能力组合的回答差异:

常见问题速查

  • MCP 出现在列表里 = 已绑定吗?不等于。MCP 页面"已添加"只代表服务可用,必须进入智能体编辑页勾选后才绑定到该智能体。
  • 工具调用失败怎么办?确认第三方服务的地址、API Key 可用;MCP 工具元数据生成失败时,可在服务卡片点击重试按钮。
  • 知识库检索不到内容?检查文档是否处理完成、向量模型是否已配置。
  • 资源会被其他用户影响吗?不会。AgentChat 按用户隔离资源,注册时自动获得独立的智能体、工具、Skill 与 MCP 副本,详见 docs/private-resources.md。

参考资料

  • 完整功能与部署说明:README.md
  • 智能体数据模型(含各绑定字段定义):src/backend/agentchat/schemas/agent.py
  • 智能体管理界面源码:src/frontend/src/pages/agent/agent-editor.vue
  • 技术参考文档:docs/reference/agentchat.md
  • API 接口文档:docs/reference/api.md
  • 人工智能
  • 大模型
  • AI 应用
  • AI Agent
  • RAG
  • 后端
  • 前端

【免费下载链接】AgentChat

AgentChat 是一个基于 LLM 的智能体交流平台,内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作,Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术,实现高效的知识检索与工具调用,使用 FastAPI 构建高性能后端服务。

项目地址:https://gitcode.com/gh_mirrors/age/AgentChat
点击查看免费下载

相关推荐

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进