‏AI SDK 7 منتشر شد؛ نوبت ایجنت‌های جدی

ورسل نسخهٔ AI SDK 7 رو منتشر کرده؛ همون SDK تایپ‌اسکریپتی با بیش از ۱۶ میلیون دانلود هفتگی که برای ساخت اپلیکیشن و ایجنت روی هر پرووایدر مدلی استفاده می‌شه و فریم‌ورک ایجنت متن‌باز خود ورسل (eve) هم روش سواره. به گفتهٔ تیم، این نسخه در پنج محور «عمق پروداکشن» به کار با ایجنت اضافه می‌کنه: توسعهٔ ایجنت، اجرای ایجنت، اتصال به هر harness دیگه (مثل Codex یا Claude Code)، رصد و تله‌متری، و فراتر رفتن از متن با صدای بلادرنگ و تولید ویدیو.

اولین قابلیت مهم، کنترل استدلال (reasoning) ـه. تقریباً همهٔ مدل‌های نسل جدید استدلال قابل‌تنظیم دارن، ولی هر پرووایدر اون رو جور دیگه‌ای تو API‌اش بیرون می‌ده. AI SDK 7 یه گزینهٔ reasoning استاندارد برای generateText و streamText گذاشته که به تنظیمات بومی هر پرووایدر نگاشت می‌شه:

import { generateText } from 'ai';

const result = await generateText({
  model,
  prompt,
  reasoning: 'high',
});

قابلیت دوم کانتکست ابزارـه. ابزارها دیگه مستقل از ایجنت ساخته می‌شن (شرکت‌های ثالث ابزار می‌سازن تا ایجنت‌ها به API‌شون وصل بشن) و همین یعنی ابزار به ورودی‌هایی نیاز داره که مدل تولیدشون نمی‌کنه — مثل کلید API یا تنظیمات. حالا هر ابزار می‌تونه با یه schema کانتکست تایپ‌دار خودش رو بگیره و کانتکست فقط به همون ابزار محدود می‌مونه، تا ابزار شخص‌ثالث به چیزی که لازم نداره دسترسی نداشته باشه:

const agent = new ToolLoopAgent({
  model,
  tools: {
    weather: tool({
      contextSchema: z.object({ apiKey: z.string() }),
      execute: async (input, { context: { apiKey } }) => {
        // ...
      },
    }),
  },
  toolsContext: { weather: { apiKey: process.env.WEATHER_API_KEY } },
});

کنار اون کانتکست ران‌تایم اضافه شده: متغیرهای تایپ‌دار که تو prepareStep و توابع تأیید ابزار در دسترسن و می‌تونی بین قدم‌ها بخونی و به‌روزشون کنی — مثلاً برای عوض کردن پرامپت یا انتخاب مدل وسط یه حلقهٔ agentic. این‌طوری منطق بیشتری داخل خود ToolLoopAgent جمع می‌شه و ایجنت با همون منطق قابل اشتراکه.

دو تا API جدید سطح‌بالا هم اومده: uploadFile و uploadSkill. مشکل این بود که فرستادن فایل‌های بزرگ (PDF، تصویر، دیتاست) به‌صورت inline تو هر درخواست، مخصوصاً تو استنتاج بدون حالت، کند و پرهزینه‌ست چون همون بایت‌ها بارها و بارها فرستاده می‌شن. حالا یه بار آپلود می‌کنی و بعد فقط یه ارجاع سبک رو به فراخوانی‌های بعدی پاس می‌دی. همین منطق برای skillها هم صادقه.

برای اجرا و رصد هم تیم از تأیید ابزار (tool approvals)، دوام با WorkflowAgent، تایم‌اوت و پشتیبانی از سندباکس، و در سمت مشاهده‌پذیری از تله‌متری و رویدادهای چرخهٔ حیات حرف زده. اگه روی نسخهٔ ۶ هستی، مهاجرت با یه codemod آماده (npx @ai-sdk/codemod v7) انجام می‌شه و ادعا اینه که تغییر کد خیلی کمی لازم داره.

نکات کلیدی:

• گزینهٔ استاندارد reasoning برای generateText و streamText روی همهٔ پرووایدرها
• کانتکست تایپ‌دار و محدود به هر ابزار، برای پاس دادن امن کلید API و تنظیمات
• uploadFile و uploadSkill: یه بار آپلود کن، بعد فقط ارجاع سبک بفرست
• تأیید ابزار، دوام با WorkflowAgent، تایم‌اوت و سندباکس برای اجرای مطمئن ایجنت
• مهاجرت از نسخهٔ ۶ با npx @ai-sdk/codemod v7