(已处理/总切片) 进度。[1] [2],点击可展开查看原文段落;若触发了工具调用,气泡内还会展示 🔧 已调用:工具名 折叠块,可查看参数和返回结果。智能体是你可以自由定制的 AI 助手角色。相比普通对话,智能体允许你预先设定:
每个对话可以绑定一个智能体,绑定后该对话的模型、提示词和工具将完全由智能体接管,无需每次手动切换。
点击主界面侧边栏中的 智能体 入口,进入智能体管理页面。
× 按钮,或在编辑器"基本设置"Tab 中点击"删除"按钮,确认后永久移除。在此 Tab 中配置智能体的外观和基础信息。
| 字段 | 说明 |
|---|---|
| 头像 | 点击头像区域展开 Emoji 选择面板,支持 30+ 种图标,选中后自动更新。 |
| 名称 必填 | 智能体的显示名称,会出现在聊天页的选择器和对话标题中。 |
| 描述 可选 | 简短说明该智能体的用途,显示在列表条目下方,便于区分多个智能体。 |
| 问候语 可选 | 选中该智能体并新建对话时,AI 自动发送的开场白消息。留空则不显示问候。 |
系统提示词(System Prompt)是智能体的"灵魂",它在每次对话前作为 system 角色消息发送给模型,决定 AI 的行为方式、语气风格和任务边界。
提示词支持以下变量,每次对话时自动替换为当前实时值,无需手动更新:
| 变量 | 替换内容 | 示例 |
|---|---|---|
{{date}} | 当前日期(中文格式) | 2026年4月5日 |
{{time}} | 当前时间(24小时制) | 14:32 |
{{datetime}} | 当前完整日期时间 | 2026/4/5 14:32:00 |
{{weekday}} | 当前星期 | 星期日 |
点击编辑器中的变量标签可将其快速插入到光标位置。
{{date}},AI 就会在回答时自动感知当前日期,适合"日历助手"、"任务提醒"等时间敏感场景,无需每次手动告知 AI 今天是几号。
在此 Tab 中可为智能体单独指定模型和推理参数,优先级高于全局设置。
| 参数 | 说明 |
|---|---|
| 模型选择 | 从已配置的厂商模型中选择。留空则继承聊天页当前全局选中的模型,适合需要灵活切换模型的场景。 |
| Temperature(温度) |
控制回答的随机性,范围 0~2。0 = 每次输出几乎相同,适合代码生成、数据提取等严谨任务;0.7(默认)= 平衡创意与准确性;1.5+ = 发散创意,适合头脑风暴、文学创作。留空则继承全局设置。 |
| Max Tokens(最大输出长度) | 单次回复最多生成的 Token 数。翻译、摘要等需要长输出时可调大;快问快答场景可调小以加快响应。留空则继承全局设置。 |
工具配置让智能体具备"主动获取信息"的能力,包括三类工具:
勾选后,使用该智能体发起对话时,联网搜索功能将自动开启,无需在聊天页手动点击"地球"图标。
为智能体固定绑定一个或多个知识库,对话时将仅在这些知识库中检索,不受聊天页知识库选择状态影响。
这是一个面向进阶用户的功能,允许智能体通过 Function Calling 调用外部 HTTP 接口,从而获取实时数据或触发外部操作。
开启方式:勾选"HTTP 请求工具"复选框,展开配置区域,点击"+ 添加 HTTP 工具"按钮。
HTTP 工具配置字段说明:
| 字段 | 说明 |
|---|---|
| 工具名称 必填 | 英文命名,不含空格,如 get_weather、search_stock。该名称会作为 Function Calling 的函数名传给模型。 |
| 功能描述 | 告知 LLM 何时应该调用该工具,描述越清晰,模型判断越准确。例如:"当用户询问某城市的实时天气时,调用此工具获取天气数据。" |
| 请求方式 | 支持 GET、POST、PUT、DELETE 四种 HTTP 方法。 |
| URL |
目标接口地址,支持用 {{参数名}} 占位符标记 LLM 需要填充的动态参数。例如: https://api.example.com/weather?city={{city}}&unit=celsius
|
| 请求头 | JSON 格式,可选。常用于传入鉴权信息,例如:{"Authorization": "Bearer YOUR_TOKEN"} |
| 请求体模板 | POST 等方法时填写,同样支持 {{参数名}} 占位符,例如:{"city": "{{city}}", "unit": "celsius"} |
占位符 {{参数名}} 的工作原理:模型在决定调用该工具时,会自动从用户的问题中提取对应参数值,并将其填入 URL 或请求体中的占位符位置,然后由本地代理发起实际的 HTTP 请求。
/agent-http 端点)转发,无需担心浏览器跨域限制。请确保应用以 npm run dev 启动,代理服务正常运行。
同一个智能体可以添加多个 HTTP 工具,已添加的工具列表支持编辑(✏️)和删除(🗑️)操作。
无需保存、无需回到主界面,即可在"测试对话"Tab 中直接验证当前配置效果。
智能体配置可以 JSON 文件格式分享和备份。
.json 文件。.json 文件,系统会自动生成新 ID 并创建为独立智能体,不会覆盖现有配置。通过 HTTP 工具调用行情接口,让 AI 实时查询股票或基金的最新价格、涨跌幅等数据。
通过 POST 请求向团队协作工具推送消息,适合"提醒助手"、"任务播报"等场景。
/embeddings 接口的服务(如 OpenAI 或兼容接口),填写 API 地址、Key 和模型名称(如 text-embedding-3-small)。支持 .txt、.md、.pdf、.docx(Word)、.csv、.html。PDF 采用流式解析,Word 文档通过 mammoth.js 提取纯文本,即使是长文档也能稳步处理。
也可点击"手动添加条目"直接输入知识文本,适合笔记、摘录等场景。
[1] [2] 等标注可点击展开,显示原文段落、来源文档和相似度分数。(已处理/总切片),向量化进度一目了然。/(坚果云要求带斜杠)。MCP(Model Context Protocol) 是 Anthropic 发布的开放标准协议,允许大语言模型通过统一接口调用外部工具和数据源。简单来说,你可以为智能体接入任何兼容 MCP 的服务(如文件系统、数据库、代码执行、网络请求等),模型在对话中会自动决策何时调用、如何传参。
npm run dev)需正常运行。
打开主页面右上角 ⚙️ 设置,切换到 MCP 服务器 Tab:
http://localhost:3100/mcp进入 智能体管理 → 选择目标智能体 → 切换到 工具配置 Tab → MCP 工具 卡片:
路由逻辑:
mcpTools 非空):对话中只会注入这些精选工具,按工具名精确分发给对应服务器执行。httpTools),再匹配 MCP 工具(mcpTools 或服务器全量)。工具名应全局唯一,避免跨服务器重名导致路由混乱。
Q: 工具配置页显示"无可用工具(服务器可能未运行)"?
A: 检查:① 服务器 URL 是否填写正确;② MCP 服务器是否已启动并可正常访问;③ 本地代理 npm run dev 是否已运行(代理层负责转发请求到 MCP 服务器)。
Q: 模型没有调用 MCP 工具?
A: ① 确认模型支持 Function Calling;② 检查工具描述是否清晰说明了触发条件;③ 在智能体"测试对话"Tab 中快速验证,查看气泡内是否出现"正在调用"提示;④ 检查浏览器控制台是否有工具加载失败的警告。
Q: 工具调用结果不符合预期?
A: 展开对话气泡中的 🔧 已调用:工具名 折叠块,可查看实际传入的参数和返回的原始结果,据此调整工具描述或系统提示词。
14:32),今年的显示月日,跨年的显示完整日期。Q: 选了智能体但感觉没有生效,回答风格没变化?
A: 请检查:① 是否在智能体管理页保存了最新配置;② 系统提示词是否为空;③ 该对话是否已有大量历史,模型受已有上下文影响较大。建议新建对话后再测试效果。
Q: HTTP 工具配置好了,但模型没有调用?
A: 请确认:① 所用模型支持 Function Calling;② 工具描述是否清晰说明了触发条件;③ 本地 Node 代理是否正常运行(npm run dev 状态);④ 可切换到"测试对话"Tab 验证是否触发。
Q: 能否在一次对话中临时切换智能体?
A: 可以。在聊天页的智能体选择器中随时切换,历史记录不受影响,切换后新发送的消息将使用新智能体的配置。
Q: 换了电脑/终端后,之前上传的文档还能用吗?
A: 文档的列表和元数据(文件名、切片数等)会通过 WebDAV 自动同步过来。向量数据支持按需下载:文档列表中带 ☁️ 云端就绪 标签的文档,点击操作栏 ☁️ 按钮即可下载,完成后立即可用于检索。若云端也没有,则需重新上传原文件进行向量化。
Q: 检索效果不理想怎么办?
A: 可从以下几个方向调整:① 切换到"混合检索"模式;② 适当降低相似度阈值(如从 0.5 降至 0.35);③ 增大 Top K 召回数量;④ 确保 Embedding 模型与向量化时使用的一致。
Q: API Key 存储安全吗?
A: 所有敏感信息都在本地加密存储,WebDAV 同步时敏感字段也会加密处理,不会明文传输。
Q: 手机访问时弹出 WebDAV 登录框怎么办?
A: 在设置"云同步"中勾选"使用本地 Node 代理",代理层会自动处理认证,手机浏览器不再弹出登录框。
Q: WebDAV 同步失败怎么排查?
A: ① 确认填写的是应用密码(坚果云中单独生成),而非账号登录密码;② 检查 WebDAV 地址末尾是否有 /;③ 勾选本地代理后重试。