قالب ایجنت دانش ورسل بدون وکتور دیتابیس
خلاصهٔ کاملتر
ورسللبز یه قالب اوپنسورس به اسم Knowledge Agent Template منتشر کرده برای ساختن ایجنتهایی که روی دانش خودت جواب میدن. نکته اصلیش اینه که خبری از embedding (یعنی تبدیل متن به بردار عددی برای جستوجوی معنایی) و وکتور دیتابیس نیست. ایجنت بهجاش با همون دستورهای آشنای grep و find و cat داخل یه sandbox ایزوله فایلها رو میگرده. تو توضیحات پروژه اومده که نتیجهش قطعی و قابلتوضیحه و هیچ زیرساخت اضافهای نمیخواد.
منابع دانش از پنل ادمین اضافه میشن: مخزنهای گیتهاب، کانالهای یوتیوب یا API دلخواه. محتوا با Vercel Workflow توی یه snapshot repo همگام میشه و موقع پرسش، sandbox اون مخزن رو clone میکنه. sandboxها بین کاربرها و گفتوگوها مشترکن؛ اگه یکی از قبل روشن باشه اتصال زیر ۱۰۰ میلیثانیه طول میکشه و اگه نباشه از روی snapshot توی ۱ تا ۳ ثانیه بالا میاد.
چون sandbox مشترکه، هر دستور از یه policy رد میشه که فقط اجازه دستورهای فقطخواندنی رو میده؛ نه نوشتن فایل، نه ساختن پروسه. یه router هم هر سوال رو از نظر سختی دستهبندی میکنه و سادهها رو میفرسته سراغ مدلهای ارزون و سریع، سختها رو سراغ مدلهای قویتر. یعنی بهینهسازی هزینه خودکار انجام میشه و لازم نیست خودت قانون بنویسی.
سمت کد، پکیج @savoir/sdk دو تا ابزار bash و bash_batch میده که با Vercel AI SDK سازگارن، پس هر مدلی که AI SDK پشتیبانی کنه باهاش کار میکنه:
const savoir = createSavoir({
apiUrl: process.env.SAVOIR_API_URL!,
apiKey: process.env.SAVOIR_API_KEY,
})
const { text } = await generateText({
model: yourModel,
tools: savoir.tools, // bash and bash_batch tools
prompt: 'How do I configure authentication?',
})همین یه ایجنت رو میتونی همزمان روی چت وب، ایشوهای گیتهاب و دیسکورد سوار کنی و به گفته ورسللبز اضافهکردن یه پلتفرم جدید فقط یه فایل adapter میخواد. پنل ادمین هم آمادهست: آمار مصرف، لاگ خطا و یه ایجنت ادمین که با ابزارهایی مثل query_stats و run_sql به سوالهای عملیاتی جواب میده. پروژه با Nuxt نوشته شده و لایسنسش MIT ـه.
نکات کلیدی:
- بدون embedding و وکتور دیتابیس؛ جستوجو با grep و find و cat داخل Vercel Sandbox
- اتصال به sandbox روشنِ مشترک زیر ۱۰۰ میلیثانیه، ساخت از snapshot بین ۱ تا ۳ ثانیه
- فقط دستورهای فقطخواندنی از policy رد میشن، چون sandbox بین کاربرها مشترکه
- روتر سختی سوال رو تشخیص میده و بین مدل ارزون و مدل قوی خودش انتخاب میکنه
- بات آماده گیتهاب و دیسکورد، پنل ادمین با query_stats و run_sql، نوشتهشده با Nuxt، لایسنس MIT




