‏اجرای Agent Native Slides روی سیستم خودتون

Agent Native یه فریم‌ورک TypeScript از شرکت Builder هست برای ساختن اپ‌هایی که ایجنت هوش مصنوعی و آدم هر دو داخلش کار می‌کنن. به جای یه پنجرهٔ چت جدا، ایجنت به همون اکشن‌ها، داده و state رابط کاربری وصله که کاربر می‌بینه. Slides اپ نمونهٔ این فریم‌ورکه: یه ادیتور ارائه که می‌تونید دستی یه تیتر رو عوض کنید یا اسلاید رو جابه‌جا کنید و بعد از ایجنت بخواید از همون نسخهٔ جدید ادامه بده، نه از یه کپی قدیمی.

برای نصب، Node نسخهٔ ۲۲.۲۲ به بالا و PNPM لازمه. اگه PNPM ندارید، corepack enable فعالش می‌کنه. یه دستور npx پکیج @agent-native/core رو می‌گیره و با حالت standalone و تمپلیت slides پروژه رو می‌سازه. بعدش pnpm install و pnpm dev می‌زنید و تو مرورگر گزینهٔ «continue as local dev» رو انتخاب می‌کنید. دیتابیس یا کانتینر جدایی لازم نیست.

سه راه برای وصل کردن مدل هست: مدل‌های خود Builder، کلید API خودتون (مثلاً OpenRouter)، یا یه مدل لوکال Ollama که نه کلید می‌خواد نه صورتحساب. به گفتهٔ مقاله، یه اشتباه رایج اینه که فکر کنید با لاگین کار تمومه؛ اگه باکس پرامپت هنوز «connect agent» یا «connect keys» نشون می‌ده، یعنی مدل پیش‌فرض انتخاب نشده. خود فریم‌ورک رایگانه و فقط هزینهٔ استفاده از مدل می‌مونه.

ساختار پروژه دور actionها می‌چرخه: هر عملیات یه توضیح، یه schema برای ورودی‌ها و یه تابع run داره. مثلاً اکشن update slide شناسهٔ دک و اسلاید رو می‌گیره، دسترسی ویرایش رو چک می‌کنه، تغییر رو ذخیره می‌کنه و به کلاینت‌های وصل خبر می‌ده. کامپوننت‌های React این اکشن‌ها رو با hook صدا می‌زنن و همین اکشن‌ها روی HTTP و MCP هم در دسترسن. یعنی ایجنت بیرونی دقیقاً همون عملیاتی رو اجرا می‌کنه که UI اجرا می‌کنه و ویرایش‌ها روی هم نمی‌افتن.

نویسنده پیشنهاد می‌ده پروژه رو تو یه ایجنت کدنویس مثل Claude Code یا Codex باز کنید و بخواید یه قابلیت کوچیک، مثلاً یه چک‌لیست بازبینی برای هر دک، با همون الگوی اکشن‌ها اضافه کنه. بعد یه آیتم رو دستی تیک بزنید و از ایجنت بپرسید چی مونده؛ اگه جوابش درست بود، state مشترک درست وصل شده. اپ‌های نمونه هنوز alpha هستن، پس ویرایش‌های ایجنت رو باید بازبینی کرد.

نکات کلیدی:

• پیش‌نیاز: Node نسخهٔ ۲۲.۲۲ یا بالاتر و PNPM.
• پروژه با پکیج @agent-native/core و تمپلیت slides ساخته می‌شه و با pnpm dev اجرا می‌شه.
• سه راه اتصال مدل هست: Builder، کلید API مثل OpenRouter، یا Ollama لوکال.
• اکشن‌ها از طریق React hook، HTTP و MCP در دسترسن، پس UI و ایجنت یه عملیات مشترک دارن.
• فریم‌ورک رایگان و اوپن‌سورسه ولی اپ‌های نمونه هنوز alpha هستن.