简介这份PDF文档系统梳理了AnythingLLM这款大型语言模型应用的核心功能面向希望搭建私有化AI服务、集成嵌入式聊天或进行多用户权限管理的开发者与运维人员。内容围绕代理功能、API访问与密钥管理、外观自定义、嵌入式聊天小部件、工作空间聊天日志导出及事件日志等模块展开并涉及向量数据库、嵌入模型与多用户模式等配置要点。资源包共1个PDF文件大小约1.32MB便于集中查阅与离线学习。目前已有734人学习下载。读者可借此了解agent指令触发代理会话、抓取网站内容、总结文档、网络搜索与图表制作等操作方式掌握API密钥的创建与权限管理、Docker版本下的品牌Logo与欢迎消息替换、聊天小部件嵌入配置以及CSV、JSON、JSONL等多格式日志导出方法为构建完整服务生态提供参考。1. 从一份 PDF 说起AnythingLLM 到底能替你省掉哪些脏活很多人第一次接触 AnythingLLM是因为手里已经攒了一堆 PDF、Markdown 和会议纪要却不想再手动复制粘贴到对话框里问来问去。这份《Anythingllm 的功能详细介绍 .pdf》本质上就是一份功能地图它把 AnythingLLM 的能力拆成了代理、API、外观自定义、嵌入式聊天小部件、事件日志、多用户模式这几块。我拿到手的第一反应不是“功能真多”而是“哪些能直接落地哪些只是锦上添花”。如果你正在找一个能私有部署、能接本地或云端大型语言模型、还能把聊天窗口嵌到自己网站里的方案这份资料值得先过一遍。它适合两类人一类是想快速搭一个内部知识库问答的开发者另一类是需要在客户页面里塞一个可控聊天入口的交付工程师。下面我按实际拆解顺序把这份 PDF 里真正影响落地的点拎出来。2. 代理与 API把 agent 和密钥管理跑通2.1 代理不是玄学它就是一个带工具调用的 LLM 会话AnythingLLM 的代理机制在 PDF 里写得很直白代理基本上是一个可以访问简单工具的大型语言模型。所有代理在工作区之间共享相同的工具集但被 agent 调用时只在其所属工作区内操作。这意味着你不能指望代理跨工作区去抓另一个空间的文档它的视野被锁在当前工作区。启动方式是在任意工作区输入agent 你的提示退出输入exit。PDF 里给了两个例子agent 你能看到哪些文档会让模型列出它能看到的文档agent 总结readme.pdf会让它总结特定嵌入文件。我实际跑的时候发现代理能做的事包括抓取网站内容、列出并总结文档、搜索网络、制作图表甚至把文件保存到桌面和自身内存中。这里有个容易翻车的点代理的工具调用依赖工作区里已经嵌入的文档和当前配置的模型能力如果模型本身不支持函数调用agent 会退化成普通聊天你会在日志里看到工具没有被触发的记录。下面是一个用 API 触发代理会话的最小示例。AnythingLLM 的 API 文档在实例的/api/docs路径下你可以直接打开看可用端点。假设你已经创建了 API 密钥并且知道工作区的 slug# 先拿到工作区列表确认 slug curl -X GET http://localhost:3001/api/v1/workspaces \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json # 向指定工作区发送代理指令 curl -X POST http://localhost:3001/api/v1/workspace/your-workspace-slug/chat \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { message: agent 总结readme.pdf, mode: agent }逻辑说明第一段请求用来确认工作区 slug因为 API 路径里必须用 slug 而不是显示名称。第二段请求里的mode字段是关键设成agent才会走代理会话设成chat就是普通聊天。参数方面message里带agent前缀是给界面用的API 调用时其实可以省略前缀但保留它更直观。YOUR_API_KEY必须从具有正确访问级别的账户里生成PDF 里特别提醒任何持有 API 密钥的人都可以使用 AnythingLLM API所以不要在任何地方共享或发布这个密钥。我一般会把密钥放在环境变量里而不是硬编码在脚本中。2.2 API 密钥的创建、删除与权限边界PDF 里提到如果你有权限可以即时创建和删除 API 密钥。这一点在实际交付里很有用比如给某个临时集成方开一个只读密钥用完就删。但要注意API 密钥的权限跟创建它的账户角色绑定。管理员创建的密钥能访问管理、更新、嵌入和聊天接口经理角色的密钥在 LLM、嵌入模型和向量数据库设置上会被挡住默认角色只能向明确添加的工作区发消息。我见过有人用默认角色账户生成密钥然后抱怨调不通嵌入接口其实就是权限没给够。创建密钥的常见做法是走界面里的 API 密钥管理页或者用管理员账户调 API# 创建新的 API 密钥需要管理员权限 curl -X POST http://localhost:3001/api/v1/admin/api-keys \ -H Authorization: Bearer ADMIN_API_KEY \ -H Content-Type: application/json \ -d { name: temp-integration, expiresAt: 2025-12-31T23:59:59Z }参数说明name是给你自己看的备注expiresAt是可选的过期时间。如果实例版本不支持过期字段这个参数会被忽略密钥永久有效那就需要你手动删。删除密钥用DELETE /api/v1/admin/api-keys/{id}。这里有个血泪经验不要在客户端代码里直接调管理接口管理密钥一旦泄露别人可以删你的工作区、改你的模型配置。我一般只把聊天接口的密钥给前端管理密钥留在服务端。3. 外观自定义与嵌入式聊天小部件Docker 版的专属能力3.1 换 Logo、改欢迎语、调页脚这些只在 Docker 版生效PDF 里反复强调外观自定义和嵌入式聊天小部件仅限 Docker 版本。如果你用的是桌面版这部分菜单根本不会出现。外观自定义包括三块替换登录页和整个应用里的 AnythingLLM 品牌 Logo、自定义欢迎消息、自定义页脚链接和图标。Logo 替换就是上传一张图片PDF 里用了一个绿色方形图像做演示。欢迎消息用的是系统消息输入框你可以模拟系统和用户的响应消息借此告诉用户特定工作空间的用途。页脚图标可以换成自定义链接方便快速访问相关资源或网页。我实际配置时发现Logo 图片的尺寸没有强制校验但太大或比例不对会被 CSS 裁切建议用正方形、透明背景的 PNG。欢迎消息支持 Markdown但不要塞太多内容否则首次登录的引导页会显得很挤。页脚链接的图标需要是图标字体或 SVGPDF 没写具体格式常见做法是直接用内置图标集里的名称。3.2 嵌入式聊天小部件的配置项与域名限制嵌入式聊天小部件是这份 PDF 里最有交付价值的部分。创建后你会得到一个链接用简单的script标签就能集成到任何网站的 HTML 里。配置选项包括工作空间设置决定聊天窗口基于哪个工作空间除非被特定配置覆盖否则所有默认值都从选定的工作空间继承允许的聊天方法有两个选项聊天表示机器人回答所有问题查询表示只回答与工作空间中文档相关的问题限制来自域名的请求可以阻止指定列表以外域名的任何请求留空意味着任何人都可以在任何网站上使用每日最大聊天次数和每会话最大聊天次数分别限制 24 小时内的总次数和单会话次数设为零表示无限制启用动态模型使用允许设置的首选 LLM 覆盖工作空间默认设置启用动态 LLM 温度允许温度覆盖启用提示覆盖允许系统提示覆盖。下面是一个嵌入脚本的示例假设你已经在小部件配置页拿到了 embed 链接!-- 把 YOUR_EMBED_URL 替换成小部件配置页给出的链接 -- script window.AnythingLLMConfig { embedUrl: YOUR_EMBED_URL, workspace: customer-support, chatMethod: query, allowedDomains: [example.com, app.example.com], dailyChatLimit: 500, sessionChatLimit: 20, dynamicModel: false, dynamicTemperature: false, promptOverride: false }; /script script srchttps://your-anythingllm-instance.com/embed.js/script逻辑说明这段配置里workspace指定聊天窗口绑定的工作区chatMethod设成query可以防止用户问无关问题allowedDomains是域名白名单只有列表里的域名才能加载小部件。dailyChatLimit和sessionChatLimit设为零就是无限制但生产环境建议设一个上限防止被刷。dynamicModel、dynamicTemperature、promptOverride这三个开关默认关闭关闭时小部件完全继承工作区设置打开后允许前端覆盖适合多租户场景。注意embed.js的地址取决于你的实例部署域名PDF 里没有给出固定 CDN 地址你需要从自己的实例里取。4. 事件日志、多用户模式与隐私开关上线前必须确认的三件事4.1 事件日志能看什么不能看什么事件日志页面允许用户查看和监控应用内发生的各种事件。PDF 里列出的类型包括用户登录尝试成功和失败、用户发送的消息、对应用程序设置所做的更改、文档上传。每个事件包含事件类型、关联用户如适用、时间戳以及特定于事件类型的其他详细信息。这对监控实例非常有用但要注意事件日志不是审计级日志它不会记录每条消息的完整内容也不会记录 API 调用的请求体。如果你需要合规级审计得自己在反向代理层加日志。我一般会定期导出事件日志重点看登录失败次数和设置变更。登录失败突然增多可能是有人在撞密码设置变更如果不是你做的那就要查 API 密钥是不是泄露了。4.2 单用户模式与多用户模式的切换代价PDF 里给了一个警告一旦进入多用户模式就无法再切换回单用户模式。这个坑我踩过当时为了测试多用户角色在一个已经配好工作区的实例上开了多用户模式结果想切回去发现按钮没了只能重建实例。单用户模式适用于仅自己或一组可信任人员使用的情况如果你希望为每个用户设置权限就应该切换到多用户模式。单用户模式下如果设置了实例密码任何知道密码的人都能使用实例、更改任何配置或设置并查看所有聊天记录。多用户模式下默认创建管理员账户拥有最高权限经理角色可以查看所有工作区并管理所有属性除了 LLM、嵌入模型和向量数据库的设置默认角色只能向明确添加的工作区发送聊天信息无法查看或编辑任何工作区或系统设置。启用多用户模式时你会被登出然后用新密码登录。这里有个操作顺序问题先确保你记得管理员用户名和密码再切换否则只能去数据库里改。常见做法是切换前先导出一份工作区配置和嵌入文档列表万一要重建至少不用从头再来。4.3 匿名遥测与数据边界PDF 里提到AnythingLLM 收集匿名遥测数据绝不会收集个人数据收集目的是帮助改进产品。如果你不想共享可以在此菜单中禁用。我的习惯是交付给客户前一定关掉遥测不是不信任而是客户环境里任何外发请求都需要提前报备。另外向量数据库默认由 LanceDB 驱动使用默认选项时向量数据永远不会离开 AnythingLLM。但如果你切换到云向量数据库提供商数据就会出实例这个切换点需要跟客户确认清楚。5. 避坑与排查代理不响应、小部件不显示、多用户切不回去5.1 代理不响应或工具没触发现象输入agent 总结readme.pdf后模型回复“我无法访问该文件”或直接当普通聊天回答。原因当前工作区没有嵌入 readme.pdf或者当前 LLM 不支持函数调用。解决先在工作区文档列表里确认文件已嵌入且状态为可用再检查模型配置里是否选了支持工具调用的模型。如果模型不支持换一个支持函数调用的本地或云端模型。5.2 嵌入式小部件加载后空白现象页面里插入了script标签但聊天窗口不显示。原因域名不在允许列表里或者 embed 链接的实例地址前端访问不到。解决检查小部件配置里的允许域名是否包含当前页面域名留空表示不限制再打开浏览器控制台看有没有跨域或 404 错误确认embed.js的地址能从公网访问。5.3 多用户模式切换后无法回退现象启用多用户模式后设置里找不到切回单用户的选项。原因PDF 明确写了一旦进入多用户模式就无法再切换回单用户模式。解决没有后悔药只能重建实例或接受多用户模式。建议在测试环境先验证多用户角色权限再在生产环境切换。5.4 API 密钥调不通嵌入接口现象用 API 密钥调/api/v1/workspace/{slug}/update-embeddings返回 403。原因密钥所属账户角色是默认或经理没有嵌入模型和向量数据库的设置权限。解决换管理员账户生成密钥或者让管理员调整该账户角色。PDF 里写得很清楚经理角色不能管理 LLM、嵌入模型和向量数据库的设置。5.5 聊天日志导出按钮不可点现象工作区顶部导出按钮是灰的。原因聊天日志少于 10 条。PDF 里写了只要至少有 10 条聊天日志可用点击导出才生效。解决先聊够 10 条或者直接调 API 导出。导出格式支持 CSV、JSON、JSONAlpaca、JSONLOpenAI 微调如果你要做微调选 JSONL 格式最省事。6. 进阶技巧用 API 批量导出日志并转成微调数据集最后一章说一个我常用的技巧把 AnythingLLM 的聊天日志批量导出然后转成 OpenAI 微调格式。PDF 里提到导出格式有 JSONLOpenAI 微调但界面导出一次只能导一个工作区如果你有多个工作区手动点太慢。我一般用 API 循环拉取。先拿到所有工作区 slugcurl -X GET http://localhost:3001/api/v1/workspaces \ -H Authorization: Bearer ADMIN_API_KEY \ -H Content-Type: application/json | jq -r .workspaces[].slug然后对每个 slug 调导出接口for slug in $(curl -s -X GET http://localhost:3001/api/v1/workspaces \ -H Authorization: Bearer ADMIN_API_KEY | jq -r .workspaces[].slug); do curl -X GET http://localhost:3001/api/v1/workspace/$slug/chats/export?formatjsonl \ -H Authorization: Bearer ADMIN_API_KEY \ -o export-$slug.jsonl done逻辑说明第一段用jq提取 slug 列表第二段循环导出每个工作区的 JSONL 文件。参数format可以换成csv、json、alpaca。导出的 JSONL 每条记录包含用户消息和助手回复但字段名可能跟 OpenAI 微调格式不完全一致常见做法是写一个 Python 脚本做字段映射import json with open(export-customer-support.jsonl, r, encodingutf-8) as f_in, \ open(finetune-ready.jsonl, w, encodingutf-8) as f_out: for line in f_in: record json.loads(line) # 映射成 OpenAI 微调格式messages 数组 messages [] if record.get(prompt): messages.append({role: user, content: record[prompt]}) if record.get(response): messages.append({role: assistant, content: record[response]}) if messages: f_out.write(json.dumps({messages: messages}, ensure_asciiFalse) \n)参数说明prompt和response是 AnythingLLM 导出记录里的常见字段不同版本可能叫userMessage和assistantMessage你需要先打开一个导出文件看实际字段名。ensure_asciiFalse保证中文不被转义。这个脚本跑完你就得到了可以直接喂给微调接口的 JSONL。验证方法拿一条导出的记录手动构造一个微调请求看接口是否接受。如果报字段错误就调整映射。我一般会先导 10 条做小样本测试确认格式没问题再全量跑。从那以后我每次做私有知识库交付都会先确认三件事代理用的模型支不支持工具调用、多用户模式是不是必须开、遥测有没有关。这三个点一旦漏掉后面返工的成本远大于前期多问一句。希望帮到你。本文还有配套的精品资源点击获取 AnythingLLM 私有部署实战：代理、API、嵌入小部件与多用户避坑指南
简介这份PDF文档系统梳理了AnythingLLM这款大型语言模型应用的核心功能面向希望搭建私有化AI服务、集成嵌入式聊天或进行多用户权限管理的开发者与运维人员。内容围绕代理功能、API访问与密钥管理、外观自定义、嵌入式聊天小部件、工作空间聊天日志导出及事件日志等模块展开并涉及向量数据库、嵌入模型与多用户模式等配置要点。资源包共1个PDF文件大小约1.32MB便于集中查阅与离线学习。目前已有734人学习下载。读者可借此了解agent指令触发代理会话、抓取网站内容、总结文档、网络搜索与图表制作等操作方式掌握API密钥的创建与权限管理、Docker版本下的品牌Logo与欢迎消息替换、聊天小部件嵌入配置以及CSV、JSON、JSONL等多格式日志导出方法为构建完整服务生态提供参考。1. 从一份 PDF 说起AnythingLLM 到底能替你省掉哪些脏活很多人第一次接触 AnythingLLM是因为手里已经攒了一堆 PDF、Markdown 和会议纪要却不想再手动复制粘贴到对话框里问来问去。这份《Anythingllm 的功能详细介绍 .pdf》本质上就是一份功能地图它把 AnythingLLM 的能力拆成了代理、API、外观自定义、嵌入式聊天小部件、事件日志、多用户模式这几块。我拿到手的第一反应不是“功能真多”而是“哪些能直接落地哪些只是锦上添花”。如果你正在找一个能私有部署、能接本地或云端大型语言模型、还能把聊天窗口嵌到自己网站里的方案这份资料值得先过一遍。它适合两类人一类是想快速搭一个内部知识库问答的开发者另一类是需要在客户页面里塞一个可控聊天入口的交付工程师。下面我按实际拆解顺序把这份 PDF 里真正影响落地的点拎出来。2. 代理与 API把 agent 和密钥管理跑通2.1 代理不是玄学它就是一个带工具调用的 LLM 会话AnythingLLM 的代理机制在 PDF 里写得很直白代理基本上是一个可以访问简单工具的大型语言模型。所有代理在工作区之间共享相同的工具集但被 agent 调用时只在其所属工作区内操作。这意味着你不能指望代理跨工作区去抓另一个空间的文档它的视野被锁在当前工作区。启动方式是在任意工作区输入agent 你的提示退出输入exit。PDF 里给了两个例子agent 你能看到哪些文档会让模型列出它能看到的文档agent 总结readme.pdf会让它总结特定嵌入文件。我实际跑的时候发现代理能做的事包括抓取网站内容、列出并总结文档、搜索网络、制作图表甚至把文件保存到桌面和自身内存中。这里有个容易翻车的点代理的工具调用依赖工作区里已经嵌入的文档和当前配置的模型能力如果模型本身不支持函数调用agent 会退化成普通聊天你会在日志里看到工具没有被触发的记录。下面是一个用 API 触发代理会话的最小示例。AnythingLLM 的 API 文档在实例的/api/docs路径下你可以直接打开看可用端点。假设你已经创建了 API 密钥并且知道工作区的 slug# 先拿到工作区列表确认 slug curl -X GET http://localhost:3001/api/v1/workspaces \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json # 向指定工作区发送代理指令 curl -X POST http://localhost:3001/api/v1/workspace/your-workspace-slug/chat \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { message: agent 总结readme.pdf, mode: agent }逻辑说明第一段请求用来确认工作区 slug因为 API 路径里必须用 slug 而不是显示名称。第二段请求里的mode字段是关键设成agent才会走代理会话设成chat就是普通聊天。参数方面message里带agent前缀是给界面用的API 调用时其实可以省略前缀但保留它更直观。YOUR_API_KEY必须从具有正确访问级别的账户里生成PDF 里特别提醒任何持有 API 密钥的人都可以使用 AnythingLLM API所以不要在任何地方共享或发布这个密钥。我一般会把密钥放在环境变量里而不是硬编码在脚本中。2.2 API 密钥的创建、删除与权限边界PDF 里提到如果你有权限可以即时创建和删除 API 密钥。这一点在实际交付里很有用比如给某个临时集成方开一个只读密钥用完就删。但要注意API 密钥的权限跟创建它的账户角色绑定。管理员创建的密钥能访问管理、更新、嵌入和聊天接口经理角色的密钥在 LLM、嵌入模型和向量数据库设置上会被挡住默认角色只能向明确添加的工作区发消息。我见过有人用默认角色账户生成密钥然后抱怨调不通嵌入接口其实就是权限没给够。创建密钥的常见做法是走界面里的 API 密钥管理页或者用管理员账户调 API# 创建新的 API 密钥需要管理员权限 curl -X POST http://localhost:3001/api/v1/admin/api-keys \ -H Authorization: Bearer ADMIN_API_KEY \ -H Content-Type: application/json \ -d { name: temp-integration, expiresAt: 2025-12-31T23:59:59Z }参数说明name是给你自己看的备注expiresAt是可选的过期时间。如果实例版本不支持过期字段这个参数会被忽略密钥永久有效那就需要你手动删。删除密钥用DELETE /api/v1/admin/api-keys/{id}。这里有个血泪经验不要在客户端代码里直接调管理接口管理密钥一旦泄露别人可以删你的工作区、改你的模型配置。我一般只把聊天接口的密钥给前端管理密钥留在服务端。3. 外观自定义与嵌入式聊天小部件Docker 版的专属能力3.1 换 Logo、改欢迎语、调页脚这些只在 Docker 版生效PDF 里反复强调外观自定义和嵌入式聊天小部件仅限 Docker 版本。如果你用的是桌面版这部分菜单根本不会出现。外观自定义包括三块替换登录页和整个应用里的 AnythingLLM 品牌 Logo、自定义欢迎消息、自定义页脚链接和图标。Logo 替换就是上传一张图片PDF 里用了一个绿色方形图像做演示。欢迎消息用的是系统消息输入框你可以模拟系统和用户的响应消息借此告诉用户特定工作空间的用途。页脚图标可以换成自定义链接方便快速访问相关资源或网页。我实际配置时发现Logo 图片的尺寸没有强制校验但太大或比例不对会被 CSS 裁切建议用正方形、透明背景的 PNG。欢迎消息支持 Markdown但不要塞太多内容否则首次登录的引导页会显得很挤。页脚链接的图标需要是图标字体或 SVGPDF 没写具体格式常见做法是直接用内置图标集里的名称。3.2 嵌入式聊天小部件的配置项与域名限制嵌入式聊天小部件是这份 PDF 里最有交付价值的部分。创建后你会得到一个链接用简单的script标签就能集成到任何网站的 HTML 里。配置选项包括工作空间设置决定聊天窗口基于哪个工作空间除非被特定配置覆盖否则所有默认值都从选定的工作空间继承允许的聊天方法有两个选项聊天表示机器人回答所有问题查询表示只回答与工作空间中文档相关的问题限制来自域名的请求可以阻止指定列表以外域名的任何请求留空意味着任何人都可以在任何网站上使用每日最大聊天次数和每会话最大聊天次数分别限制 24 小时内的总次数和单会话次数设为零表示无限制启用动态模型使用允许设置的首选 LLM 覆盖工作空间默认设置启用动态 LLM 温度允许温度覆盖启用提示覆盖允许系统提示覆盖。下面是一个嵌入脚本的示例假设你已经在小部件配置页拿到了 embed 链接!-- 把 YOUR_EMBED_URL 替换成小部件配置页给出的链接 -- script window.AnythingLLMConfig { embedUrl: YOUR_EMBED_URL, workspace: customer-support, chatMethod: query, allowedDomains: [example.com, app.example.com], dailyChatLimit: 500, sessionChatLimit: 20, dynamicModel: false, dynamicTemperature: false, promptOverride: false }; /script script srchttps://your-anythingllm-instance.com/embed.js/script逻辑说明这段配置里workspace指定聊天窗口绑定的工作区chatMethod设成query可以防止用户问无关问题allowedDomains是域名白名单只有列表里的域名才能加载小部件。dailyChatLimit和sessionChatLimit设为零就是无限制但生产环境建议设一个上限防止被刷。dynamicModel、dynamicTemperature、promptOverride这三个开关默认关闭关闭时小部件完全继承工作区设置打开后允许前端覆盖适合多租户场景。注意embed.js的地址取决于你的实例部署域名PDF 里没有给出固定 CDN 地址你需要从自己的实例里取。4. 事件日志、多用户模式与隐私开关上线前必须确认的三件事4.1 事件日志能看什么不能看什么事件日志页面允许用户查看和监控应用内发生的各种事件。PDF 里列出的类型包括用户登录尝试成功和失败、用户发送的消息、对应用程序设置所做的更改、文档上传。每个事件包含事件类型、关联用户如适用、时间戳以及特定于事件类型的其他详细信息。这对监控实例非常有用但要注意事件日志不是审计级日志它不会记录每条消息的完整内容也不会记录 API 调用的请求体。如果你需要合规级审计得自己在反向代理层加日志。我一般会定期导出事件日志重点看登录失败次数和设置变更。登录失败突然增多可能是有人在撞密码设置变更如果不是你做的那就要查 API 密钥是不是泄露了。4.2 单用户模式与多用户模式的切换代价PDF 里给了一个警告一旦进入多用户模式就无法再切换回单用户模式。这个坑我踩过当时为了测试多用户角色在一个已经配好工作区的实例上开了多用户模式结果想切回去发现按钮没了只能重建实例。单用户模式适用于仅自己或一组可信任人员使用的情况如果你希望为每个用户设置权限就应该切换到多用户模式。单用户模式下如果设置了实例密码任何知道密码的人都能使用实例、更改任何配置或设置并查看所有聊天记录。多用户模式下默认创建管理员账户拥有最高权限经理角色可以查看所有工作区并管理所有属性除了 LLM、嵌入模型和向量数据库的设置默认角色只能向明确添加的工作区发送聊天信息无法查看或编辑任何工作区或系统设置。启用多用户模式时你会被登出然后用新密码登录。这里有个操作顺序问题先确保你记得管理员用户名和密码再切换否则只能去数据库里改。常见做法是切换前先导出一份工作区配置和嵌入文档列表万一要重建至少不用从头再来。4.3 匿名遥测与数据边界PDF 里提到AnythingLLM 收集匿名遥测数据绝不会收集个人数据收集目的是帮助改进产品。如果你不想共享可以在此菜单中禁用。我的习惯是交付给客户前一定关掉遥测不是不信任而是客户环境里任何外发请求都需要提前报备。另外向量数据库默认由 LanceDB 驱动使用默认选项时向量数据永远不会离开 AnythingLLM。但如果你切换到云向量数据库提供商数据就会出实例这个切换点需要跟客户确认清楚。5. 避坑与排查代理不响应、小部件不显示、多用户切不回去5.1 代理不响应或工具没触发现象输入agent 总结readme.pdf后模型回复“我无法访问该文件”或直接当普通聊天回答。原因当前工作区没有嵌入 readme.pdf或者当前 LLM 不支持函数调用。解决先在工作区文档列表里确认文件已嵌入且状态为可用再检查模型配置里是否选了支持工具调用的模型。如果模型不支持换一个支持函数调用的本地或云端模型。5.2 嵌入式小部件加载后空白现象页面里插入了script标签但聊天窗口不显示。原因域名不在允许列表里或者 embed 链接的实例地址前端访问不到。解决检查小部件配置里的允许域名是否包含当前页面域名留空表示不限制再打开浏览器控制台看有没有跨域或 404 错误确认embed.js的地址能从公网访问。5.3 多用户模式切换后无法回退现象启用多用户模式后设置里找不到切回单用户的选项。原因PDF 明确写了一旦进入多用户模式就无法再切换回单用户模式。解决没有后悔药只能重建实例或接受多用户模式。建议在测试环境先验证多用户角色权限再在生产环境切换。5.4 API 密钥调不通嵌入接口现象用 API 密钥调/api/v1/workspace/{slug}/update-embeddings返回 403。原因密钥所属账户角色是默认或经理没有嵌入模型和向量数据库的设置权限。解决换管理员账户生成密钥或者让管理员调整该账户角色。PDF 里写得很清楚经理角色不能管理 LLM、嵌入模型和向量数据库的设置。5.5 聊天日志导出按钮不可点现象工作区顶部导出按钮是灰的。原因聊天日志少于 10 条。PDF 里写了只要至少有 10 条聊天日志可用点击导出才生效。解决先聊够 10 条或者直接调 API 导出。导出格式支持 CSV、JSON、JSONAlpaca、JSONLOpenAI 微调如果你要做微调选 JSONL 格式最省事。6. 进阶技巧用 API 批量导出日志并转成微调数据集最后一章说一个我常用的技巧把 AnythingLLM 的聊天日志批量导出然后转成 OpenAI 微调格式。PDF 里提到导出格式有 JSONLOpenAI 微调但界面导出一次只能导一个工作区如果你有多个工作区手动点太慢。我一般用 API 循环拉取。先拿到所有工作区 slugcurl -X GET http://localhost:3001/api/v1/workspaces \ -H Authorization: Bearer ADMIN_API_KEY \ -H Content-Type: application/json | jq -r .workspaces[].slug然后对每个 slug 调导出接口for slug in $(curl -s -X GET http://localhost:3001/api/v1/workspaces \ -H Authorization: Bearer ADMIN_API_KEY | jq -r .workspaces[].slug); do curl -X GET http://localhost:3001/api/v1/workspace/$slug/chats/export?formatjsonl \ -H Authorization: Bearer ADMIN_API_KEY \ -o export-$slug.jsonl done逻辑说明第一段用jq提取 slug 列表第二段循环导出每个工作区的 JSONL 文件。参数format可以换成csv、json、alpaca。导出的 JSONL 每条记录包含用户消息和助手回复但字段名可能跟 OpenAI 微调格式不完全一致常见做法是写一个 Python 脚本做字段映射import json with open(export-customer-support.jsonl, r, encodingutf-8) as f_in, \ open(finetune-ready.jsonl, w, encodingutf-8) as f_out: for line in f_in: record json.loads(line) # 映射成 OpenAI 微调格式messages 数组 messages [] if record.get(prompt): messages.append({role: user, content: record[prompt]}) if record.get(response): messages.append({role: assistant, content: record[response]}) if messages: f_out.write(json.dumps({messages: messages}, ensure_asciiFalse) \n)参数说明prompt和response是 AnythingLLM 导出记录里的常见字段不同版本可能叫userMessage和assistantMessage你需要先打开一个导出文件看实际字段名。ensure_asciiFalse保证中文不被转义。这个脚本跑完你就得到了可以直接喂给微调接口的 JSONL。验证方法拿一条导出的记录手动构造一个微调请求看接口是否接受。如果报字段错误就调整映射。我一般会先导 10 条做小样本测试确认格式没问题再全量跑。从那以后我每次做私有知识库交付都会先确认三件事代理用的模型支不支持工具调用、多用户模式是不是必须开、遥测有没有关。这三个点一旦漏掉后面返工的成本远大于前期多问一句。希望帮到你。本文还有配套的精品资源点击获取