|
|
@@ -1,6 +1,6 @@
|
|
|
# LambdAgent Desktop 安装与使用手册
|
|
|
|
|
|
-> 版本:v0.1.0 ・ 更新日期:2026-06-11
|
|
|
+> 版本:v1.3.0 ・ 更新日期:2026-06-13
|
|
|
> 适用读者:科研人员、研究生、高校教师等**非技术背景用户**,以及需要本地部署的技术用户。
|
|
|
|
|
|
---
|
|
|
@@ -13,13 +13,15 @@
|
|
|
4. [首次启动与设置向导](#4-首次启动与设置向导)
|
|
|
5. [配置大模型(Provider)](#5-配置大模型provider)
|
|
|
6. [核心概念速览](#6-核心概念速览)
|
|
|
-7. [Web 界面使用指南](#7-web-界面使用指南)
|
|
|
-8. [内置科研智能体包](#8-内置科研智能体包)
|
|
|
-9. [知识库:把你的文献变成可问答的资料库](#9-知识库把你的文献变成可问答的资料库)
|
|
|
-10. [命令行(CLI)速查](#10-命令行cli速查)
|
|
|
-11. [数据与隐私](#11-数据与隐私)
|
|
|
-12. [常见问题与故障排查](#12-常见问题与故障排查)
|
|
|
-13. [进阶配置](#13-进阶配置)
|
|
|
+7. [Web 界面使用指南(含工作台/对话/记忆面板/模型切换)](#7-web-界面使用指南)
|
|
|
+8. [记忆系统:让智能体记住上下文](#8-记忆系统让智能体记住上下文)
|
|
|
+9. [工具与连接:MCP 工具 + 能力插件](#9-工具与连接mcp-工具--能力插件)
|
|
|
+10. [内置科研智能体包](#10-内置科研智能体包)
|
|
|
+11. [知识库:把你的文献变成可问答的资料库](#11-知识库把你的文献变成可问答的资料库)
|
|
|
+12. [命令行(CLI)速查](#12-命令行cli速查)
|
|
|
+13. [数据与隐私](#13-数据与隐私)
|
|
|
+14. [常见问题与故障排查](#14-常见问题与故障排查)
|
|
|
+15. [进阶配置](#15-进阶配置)
|
|
|
|
|
|
---
|
|
|
|
|
|
@@ -100,7 +102,7 @@ Docker 模式下数据目录挂载到容器的 `/data`(由 `AGENTPAAS_DATA_DIR
|
|
|
```bash
|
|
|
agentpaas serve --port 8000 &
|
|
|
curl http://127.0.0.1:8000/health
|
|
|
-# 期望输出: {"status":"ok","version":"0.1.0"}
|
|
|
+# 期望输出: {"status":"ok","version":"1.3.0"}
|
|
|
```
|
|
|
|
|
|
---
|
|
|
@@ -118,7 +120,7 @@ agentpaas serve --port 8067
|
|
|
桌面(desktop)模式是默认模式。首次启动时系统会自动完成初始化(auto-bootstrap):
|
|
|
|
|
|
1. 创建你的本地租户和管理员 API Key,写入 `~/.agentpaas/config.json`;
|
|
|
-2. 自动安装 4 个内置科研智能体包(见 §8);
|
|
|
+2. 自动安装 10 个内置智能体包(见 §10);
|
|
|
3. 清理上次异常退出遗留的运行记录。
|
|
|
|
|
|
### 4.2 打开 Web 界面
|
|
|
@@ -193,7 +195,16 @@ ollama serve # 通常安装后已自动运行
|
|
|
|
|
|
## 7. Web 界面使用指南
|
|
|
|
|
|
-左侧导航:**仪表盘 / 智能体 / 知识库 / 智能体包 / 环境配置**。
|
|
|
+左侧导航:**今日工作 / 智能体 / 智能体包 / 资料库 / 模型与隐私 / 工具与连接**。
|
|
|
+
|
|
|
+### 7.0 今日工作台(首页)
|
|
|
+
|
|
|
+打开界面默认进入工作台,这是日常入口:
|
|
|
+
|
|
|
+- **AI 助手输入框(主角)**:直接用自然语言描述任务(例如「帮我审这篇论文 ~/Papers/draft.pdf,目标期刊 TSE」),系统用一次轻量分类自动判断该交给哪个智能体,命中后直达对话并预填好你的话;拿不准时弹出手动选择框(永远不会卡住)。
|
|
|
+- **继续上次的工作**:跨智能体的最近运行列表(运行中的排最前),一键回到对话。
|
|
|
+- **常用场景卡片**:审一篇论文 / 出一份试卷 / 写推荐信 / 设计一门课 —— 点击直达,没有对应智能体时自动从内置包创建。
|
|
|
+- 底部一行显示累计运行次数与 token 用量,点击进模型页看明细。
|
|
|
|
|
|
### 7.1 创建智能体
|
|
|
|
|
|
@@ -233,7 +244,11 @@ ollama serve # 通常安装后已自动运行
|
|
|
- `edit` — 指定某个子智能体定向修改;
|
|
|
- `chat` — 只追问讨论,不动产物;
|
|
|
- **工作目录浏览**:回复下方可直接浏览/下载本次运行产出的所有文件;
|
|
|
-- **记忆编辑**:查看与修改智能体的核心记忆和回忆日志。
|
|
|
+- **会话记忆**(顶部按钮):
|
|
|
+ - **新会话** — 开始一段干净对话(不带前情记忆),换话题时用;
|
|
|
+ - **历史** — 列出该智能体过往的对话线程,点击恢复历史气泡接着聊;
|
|
|
+ - 连续对话时第二句会自动带上前情,无需重复背景(详见 §8 记忆系统)。
|
|
|
+- **记忆面板**(右侧抽屉,点「智能体记忆」):核心记忆 / **待确认** / 近期对话三个标签。「待确认」里是系统自动提炼的、可能值得长期记住的事实,点「记住」纳入核心记忆、「忽略」丢弃。
|
|
|
|
|
|
> 如果运行期间后端重启,界面会自动查询该次运行的最终状态并妥善收尾,不会永久转圈。
|
|
|
|
|
|
@@ -255,9 +270,57 @@ curl -X POST http://127.0.0.1:8000/api/v1/traces/<run_id>/confirm \
|
|
|
|
|
|
「仪表盘」显示智能体数量、运行次数、成功率、平均时延、累计 token。每个智能体详情页可查看最近运行列表、健康分,点开单次运行可看完整 trace 与工具审计日志。
|
|
|
|
|
|
+### 7.6 模型显示与切换
|
|
|
+
|
|
|
+「模型与隐私」页顶部「使用中的模型」区块:列出每个智能体当前用的 provider/model,下拉一键切换。切换会生成新版本(旧配置在版本历史可回滚);Ollama 选项会实时探测你本机实际装好的模型。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 8. 记忆系统:让智能体记住上下文
|
|
|
+
|
|
|
+智能体的记忆分五层,全部存在本机、跨运行持久:
|
|
|
+
|
|
|
+| 层 | 作用 | 你看到的效果 |
|
|
|
+|---|---|---|
|
|
|
+| **会话记忆** | 同一对话线程内自动带前情(最近几轮 + 滚动摘要) | 连续追问不用重复背景,第二句「简答题换两道」它知道指的是上一份试卷 |
|
|
|
+| **核心记忆** | 长期事实/偏好(学科、惯用格式、常用路径) | 你确认后长期生效;在记忆面板「待确认」里逐条确认 |
|
|
|
+| **情景记忆** | 跨会话按当前问题语义召回的相关历史 | 换个对话问相关话题,它能想起以前处理过的类似任务 |
|
|
|
+| **档案记忆** | 知识库(见 §10) | 挂接的文献库 |
|
|
|
+| **工作记忆** | 单次运行内的对话历史 | 一次 ReAct 多步推理内部 |
|
|
|
+
|
|
|
+**自动提炼,但不自动记**:每次对话后系统会提炼「可能值得长期记住的事实」放进**待确认区**,需要你在记忆面板点「记住」才转正。敏感信息(身份证、手机号、成绩、健康状况)有双层拦截,绝不会被自动记录。
|
|
|
+
|
|
|
+**隐私**:记忆压缩/提炼默认复用该智能体自己的模型 —— 用本地 Ollama 的智能体,对话内容不会被偷偷送到云端。
|
|
|
+
|
|
|
+操作入口:对话页顶部「新会话 / 历史」管理对话线程;右侧记忆面板管理核心记忆与待确认项。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 9. 工具与连接:MCP 工具 + 能力插件
|
|
|
+
|
|
|
+侧栏「工具与连接」页,两个标签:
|
|
|
+
|
|
|
+### 9.1 MCP 工具(接入外部工具服务)
|
|
|
+
|
|
|
+把外部 MCP 服务(如 arXiv 检索、数据库查询)接进来供智能体调用:
|
|
|
+
|
|
|
+1. 「添加 MCP」→ 选连接方式(http / sse 端点,或 stdio 本机命令)→ 填地址,凭证填**环境变量名**(值写在 `~/.agentpaas/.env`,不直接存密钥);
|
|
|
+2. 点「测试」拉取工具清单,每个工具自动标注风险等级;
|
|
|
+3. 启停开关控制是否对智能体可用。
|
|
|
+
|
|
|
+**安全**:stdio 命令限 npx/node/python 等已知运行器;MCP 的删除/发送类工具默认标为高危,运行时需人工确认(见 §7.4)。
|
|
|
+
|
|
|
+### 9.2 能力插件(prompt skill)
|
|
|
+
|
|
|
+能力插件 = 一段提示词 + 工具依赖,挂载到智能体即扩充其能力,不用每个智能体重写提示词。例如一个「PDF 导出」插件,任何智能体挂上它就会用规范的中文字体导出 PDF。
|
|
|
+
|
|
|
+- 「新建能力插件」填名称/描述/提示词/依赖工具;
|
|
|
+- 在智能体配置里 `skills:` 引用即挂载;
|
|
|
+- **安全**:插件提示词始终在系统规则**之后**、优先级更低,含可疑指令(「忽略以上规则」等)的插件会被拒绝;高风险工具(Bash/写删类)不会被插件自动授予。
|
|
|
+
|
|
|
---
|
|
|
|
|
|
-## 8. 内置科研智能体包
|
|
|
+## 10. 内置科研智能体包
|
|
|
|
|
|
桌面模式首次启动自动安装以下 10 个包(全部 local-first:工具层不联网、不可执行 shell),覆盖科研、教学、学术服务三类场景:
|
|
|
|
|
|
@@ -304,7 +367,7 @@ curl -X POST http://127.0.0.1:8000/api/v1/traces/<run_id>/confirm \
|
|
|
|
|
|
---
|
|
|
|
|
|
-## 9. 知识库:把你的文献变成可问答的资料库
|
|
|
+## 11. 知识库:把你的文献变成可问答的资料库
|
|
|
|
|
|
1. 「知识库」页 → 「新建」→ 填名称和**根目录**(你的文献文件夹,支持 PDF/DOCX/TXT/MD/CSV/HTML);
|
|
|
2. 「添加文件」选入需要索引的文档;
|
|
|
@@ -316,7 +379,7 @@ curl -X POST http://127.0.0.1:8000/api/v1/traces/<run_id>/confirm \
|
|
|
|
|
|
---
|
|
|
|
|
|
-## 10. 命令行(CLI)速查
|
|
|
+## 12. 命令行(CLI)速查
|
|
|
|
|
|
```bash
|
|
|
# 服务
|
|
|
@@ -352,7 +415,7 @@ agentpaas xiaoyi start <agent_id> # 华为小艺 ↔ Agent
|
|
|
|
|
|
---
|
|
|
|
|
|
-## 11. 数据与隐私
|
|
|
+## 13. 数据与隐私
|
|
|
|
|
|
- **数据目录**(默认 `~/LambdAgentDesktop`):知识库索引、智能体实例、运行工作目录全部在本机;
|
|
|
- **配置目录** `~/.agentpaas/`:`config.json`(登录凭证与数据目录选择)、`providers.json`(API Key)、`.env`(环境变量覆盖);
|
|
|
@@ -362,7 +425,7 @@ agentpaas xiaoyi start <agent_id> # 华为小艺 ↔ Agent
|
|
|
|
|
|
---
|
|
|
|
|
|
-## 12. 常见问题与故障排查
|
|
|
+## 14. 常见问题与故障排查
|
|
|
|
|
|
**Q1:启动后浏览器打不开界面?**
|
|
|
确认服务在跑:`curl http://127.0.0.1:8000/health`。若改过端口,访问对应端口。前端白屏时检查仓库根目录是否存在 `webui-dist/`(源码安装需 `cd webui && npm install && npm run build` 编译一次)。
|
|
|
@@ -390,7 +453,7 @@ Provider Key 无效、欠费或超时。到「环境配置」页点「测试连
|
|
|
|
|
|
---
|
|
|
|
|
|
-## 13. 进阶配置
|
|
|
+## 15. 进阶配置
|
|
|
|
|
|
环境变量写入 `~/.agentpaas/.env`(重启服务生效):
|
|
|
|