knowledge-agent-template

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

开源 🏷️完全免费 🚫 站点已失效智能体 🍴 复刻 140 🐛 待处理 5 👀 关注 2

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1080

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，提供在线Demo，可免费使用，无付费版本。

项目预览

knowledge-agent-template 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队vercel-labs

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

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

定价模式🏷️完全免费

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

访问状态🚫 站点已失效

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 1080

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

代码更新2026-09-15

仓库体积2.3 MB

本站数据更新2026-11-10

维护状态维护中

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1080

技术标签

agents ai-agent chatbot knowledge-base nuxt

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 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`