Knowledge Agent Template

开源的文件系统与知识库 Agent 模板。构建能够与你的知识库保持同步的 AI Agent。

---

这是一个模板。你可以 Fork 它、自定义并部署你自己的基于文件系统的 AI Agent。

开源的文件系统与知识库 Agent 模板。构建能与你的知识库保持实时同步的 AI Agent——无需 Embedding，无需向量数据库，即可对你的资源进行 grep、find 和 cat 操作。你可以接入任何数据源（GitHub 仓库、YouTube 字幕、自定义 API），并将其部署为聊天应用、GitHub Bot、Discord Bot，或同时部署在多个平台。

特性

基于文件的搜索 — 无需 Embedding

没有向量数据库，没有分块（chunking）流水线，没有 Embedding 模型。Agent 在 隔离的沙箱环境 中使用 grep、find 和 cat 对你的所有 资源 进行搜索。结果确定、可解释且即时。零基础设施开销。

多平台 Bot — 一个 Agent，随处运行

一次编写 Agent，即可部署在 Web 聊天界面、GitHub Issues、Discord 上，未来还将支持 Slack、Linear 等。得益于 Chat SDK 的可插拔适配器，添加新平台只需 一个适配器文件。

内置管理面板

开箱即用的完整管理界面：包含使用统计、错误日志、用户管理、资源配置和内容同步控制。无需额外的仪表盘或第三方监控工具。

AI 驱动的管理 Agent

你可以直接询问应用自身的问题。例如：“过去 24 小时内发生了什么错误？”、“按模型显示 Token 使用量”、“哪些接口响应最慢？”——管理 Agent 可以访问内部工具（如 query_stats、query_errors、run_sql 和 chart），用自然语言回答运维问题。

智能复杂度路由

每个传入的问题都会根据复杂度（从简单到复杂）进行分类，并 路由到合适的模型。简单问题交给快速、廉价的模型；复杂问题交给强大的模型。成本优化自动完成，无需维护繁琐的手动规则。

实时工具可视化

聊天 UI 会实时显示 Agent 正在执行的操作：它正在读取哪些文件、正在运行哪些命令，以及每一步耗时多久。拒绝黑盒体验。

可分享的对话

一键分享任何对话。生成带有完整元数据（作者、标题和完整交互内容）的公共只读链接。

共享沙箱池

沙箱在用户和对话之间共享。当聊天开始时，它会连接到一个已经运行的沙箱，而不是创建一个新的——启动时间在 100ms 以内。如果没有可用沙箱，预构建的快照会在 1-3 秒内启动一个。沙箱为只读状态，禁用了危险命令，并自动共享，以便多个 Agent 可以搜索同一份最新内容，无需重复资源。

架构

┌─────────────────────────────────────────────────────────────────┐
│                        Your AI Application                      │
│                     (Discord bot, GitHub bot, etc.)             │
└─────────────────────────────────┬───────────────────────────────┘
                                  │
                                  ▼
┌─────────────────────────────────────────────────────────────────┐
│                          @savoir/sdk                            │
│              AI SDK compatible tools (bash, bash_batch)         │
└─────────────────────────────────┬───────────────────────────────┘
                                  │ API calls
                                  ▼
┌─────────────────────────────────────────────────────────────────┐
│                         apps/app                                │
│                    (Unified Nuxt Application)                   │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────────────────┐  │
│  │   Sandbox   │  │   Content    │  │   Vercel Workflows     │  │
│  │   Manager   │  │     Sync     │  │   (scheduled sync)     │  │
│  └──────┬──────┘  └──────┬───────┘  └────────────────────────┘  │
└─────────┼────────────────┼──────────────────────────────────────┘
          │                │
          ▼                ▼
   ┌────────────┐   ┌─────────────┐
   │   Vercel   │   │   GitHub    │
   │   Sandbox  │   │  Snapshot   │
   │            │   │    Repo     │
   └────────────┘   └─────────────┘

软件包

软件包	描述
@savoir/sdk	兼容 AI SDK 的 Agent 工具
@savoir/agent	Agent 核心：路由、提示词、工具、类型定义
apps/app	统一的 Nuxt 应用（聊天 UI + API + Bot）

快速上手

使用 SDK

import { generateText } from 'ai'
import { createSavoir } from '@savoir/sdk'

const savoir = createSavoir({
  apiUrl: process.env.SAVOIR_API_URL!,
  apiKey: process.env.SAVOIR_API_KEY!,
})

// 获取 Agent 工具
const tools = await savoir.tools.get()

// 在 AI SDK 中使用
const result = await generateText({
  model: yourModel,
  tools,
  prompt: '...',
})