knowledge-agent-template

让AI助手直接读写你的文件系统，与知识库实时同步。

这是一个基于文件系统和知识库的AI智能体模板，旨在帮助开发者快速构建能够与个人或团队知识库保持同步的智能体。它采用TypeScript编写，结合了Nuxt/Vue前端、沙箱环境和智能体框架，提供了一套完整的文件系统访问和知识检索能力。项目解决了传统AI助手无法实时访问本地或云端知识文件的问题，使智能体能够直接读取、理解和操作文件系统中的文档，从而提供更准确、更个性化的回答。核心能力包括：文件系统集成、知识库管理、智能体对话、沙箱安全执行等。作为早期开源项目，它提供了清晰的模板结构，适合作为构建特定领域AI助手的基础。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1015

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队vercel-labs

所属国家

官网地址https://chatsdk-knowledge-agent.vercel.app

GitHubhttps://github.com/vercel-labs/knowledge-agent-template

定价模式free

价格说明开源项目，提供在线Demo，可免费使用，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agents,ai-agent,chatbot,file-system,knowledge-base,nuxt,sandbox,typescript,vue

GitHub 星标★ 1015

30天Star增速

HF 下载量

上线时间2026-01-20 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 10 分钟部署方式：云服务 8 步

环境要求

Bun 包管理器（README 使用 bun install / bun run test）
一个 Vercel 账号（README 提供一键部署按钮）
一个 GitHub App 的 Client ID 与 Client Secret（用于 BETTER_AUTH_SECRET 之外的登录认证）
能生成随机密钥的环境（README 示例使用 openssl rand -hex 32）

安装与启动步骤

1获取项目代码

README 建议 Fork 后自定义部署；也可直接克隆仓库到本地再推送到自己的 Git 仓库。
```
git clone https://github.com/vercel-labs/knowledge-agent-template.git
```
2安装依赖

进入项目目录后用 Bun 安装全部依赖，这是 README Quick Start 给出的第一条命令。
```
cd knowledge-agent-template
bun install
```
3生成认证密钥

README 说明 BETTER_AUTH_SECRET 用 openssl rand -hex 32 生成，把输出填入 .env。
```
openssl rand -hex 32
```
4创建 GitHub App

在 github.com/settings/apps/new 创建 GitHub App，把 Client ID 和 Client Secret 填入 .env 对应变量。
5编辑 .env 配置

在项目根目录按 README 要求填写 BETTER_AUTH_SECRET、GITHUB_CLIENT_ID、GITHUB_CLIENT_SECRET 三个变量。
6部署到 Vercel

使用 README 中的 Deploy with Vercel 按钮克隆并部署，部署时按提示填入上面三个环境变量。
7运行测试

README 给出的校验命令，确认依赖安装与项目状态正常。
```
bun run test
```
8添加知识源

部署完成后访问站点 /admin 管理界面，添加 GitHub 仓库或 YouTube 频道作为知识源并触发同步。

关键配置

配置项	必填	说明	示例
`BETTER_AUTH_SECRET`	是	认证加密密钥，用随机 32 字节十六进制串填充	`openssl rand -hex 32 生成的随机串`
`GITHUB_CLIENT_ID`	是	GitHub App 的 Client ID，用于登录认证	`Iv1.xxxxxxxxxxxx`
`GITHUB_CLIENT_SECRET`	是	GitHub App 的 Client Secret，用于登录认证	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

如何确认成功

访问部署后的站点，能正常登录并打开 /admin 管理界面即表示部署成功。

常见问题

Q：需要向量数据库或 embedding 模型吗？

A：不需要。README 明确说明不做向量库、不做切分流水线、不用 embedding 模型，智能体在隔离沙箱内用 grep、find、cat 检索你的文件源。

Q：知识源怎么配置？

A：通过 /admin 管理界面添加 GitHub 仓库和 YouTube 频道等源，然后在界面上触发同步；也可以用 SDK 的 savoir.client.getSources() 以编程方式列出源。

Q：可以不部署到 Vercel 吗？

A：README 以 Vercel 一键部署为主线，并说明模板可 Fork 后自行定制部署；本地运行方式 README 未给出具体命令，需自行按 Nuxt/TypeScript 项目处理。

Q：为什么用 bun install 而不是 npm？

A：README 的 Quick Start 和测试命令都使用 Bun（bun install、bun run test），使用其他包管理器可能得不到一致的结果。

注意事项

README 未给出本地开发服务器的启动命令，本地运行前请自行确认 run 脚本，不要照搬猜测的命令。
三个环境变量缺一不可，缺少 BETTER_AUTH_SECRET 或 GitHub App 凭据会导致认证失败。
知识源默认在 /admin 界面管理，新增后需要手动触发同步才会生效。
项目处于早期阶段，模板结构清晰但接口和配置可能随版本变化。

核心亮点

内置文件系统访问能力，AI可实时读取本地文档，回答更精准
基于Nuxt/Vue构建，前端体验好，易于定制界面
沙箱环境隔离，AI执行文件操作更安全

不足之处

文档/社区待观察
早期项目，功能完整性和稳定性需进一步验证

适用场景

个人知识库问答助手，如本地笔记、PDF文档智能检索
企业内部文档智能客服，快速定位产品手册、政策文件
自动化报告生成，基于文件数据自动汇总分析

替代项目

Dify、FastGPT、RAGFlow

项目介绍

knowledge-agent-template 是智能体领域的开源项目，由 vercel-labs 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,015）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 992 增加到 1,015，净增 23。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。提供在线Demo，可免费使用，无付费版本。从国内网络环境看，当前已无法正常访问。

它主要面向的使用场景是：个人知识库问答助手，如本地笔记、PDF文档智能检索。同类可对比的替代方案包括 Dify、FastGPT、RAGFlow。

上一篇：waku-agent

下一篇：Octop