الانتقال إلى المحتوى الرئيسي
لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ النسخة الإنجليزية.
الـ LLMProvider هو ما يولّد الـ agent من خلاله. يأتي الـ SDK مع providers لـ OpenAI وAnthropic وGoogle (Gemini) وOpenRouter وOllama وpi (لكلٍّ منها peer package اختيارية، راجع التثبيت) ومع mock ثابت النتائج للاختبارات. تسمّيه بـ string بصيغة provider/model، أو تمرّر instance من الـ provider. البادئة vendor/ في اسم الـ model هي التي تحدد الـ provider؛ ومع OpenRouter تكتب openrouter/<vendor>/<model> (مثال openrouter/openai/gpt-4o-mini).
تحتاج البادئة google/ إلى الحزمة الاختيارية @ai-sdk/google (^1.2.0 مع ai 4، و^3.0.0 مع ai 6، و^4.0.0 مع ai 7) وتقرأ GOOGLE_GENERATIVE_AI_API_KEY، وهو المتغير نفسه الذي تستخدمه @ai-sdk/google.

Vendors بدون بادئة

البادئة التي لا يعرفها الـ SDK تفشل بالخطأ LOUSHO_PROVIDER_UNKNOWN. الخطأ الإملائي القريب (anthopic/...) يحصل على اقتراح “did you mean”؛ وأي vendor آخر تظهر له الطرق التي يمكنك الوصول إليه بها رغم ذلك:
  • openrouter/<vendor>/<model>: يخدم OpenRouter أغلب الـ vendors بمفتاح واحد OPENROUTER_API_KEY (مثال openrouter/mistralai/mistral-large؛ قد تختلف أسماء الـ vendors لدى OpenRouter عن أسمائها في AI SDK).
  • pi/<vendor>/<model>، إذا كان pi يخدم هذا الـ vendor (xai، groq، mistral، deepseek، amazon-bedrock، azure، …)؛ راجع الـ provider pi.
  • حزمة AI SDK الخاصة بالـ vendor نفسه مع fromAiSdk()، مثال createAgent({ provider: fromAiSdk(mistral('mistral-large-latest')) }).

اختيار الـ provider في createAgent()

يأخذ createAgent() واحدًا فقط مما يلي:
  1. model: 'provider/model' - يُحلّ باستخدام resolveProvider()؛ ويأتي المفتاح من متغير البيئة المعتاد للـ provider (راجع بيانات اعتماد الـ providers).
  2. provider: <LLMProvider> - provider كتبته أنت، أو built-in مضبوط، أو mock. ويمكنك أن تمرّر معه model (id مجرّد مثل 'gpt-4o'): فيصبح هو model هذا الـ agent ويتقدّم على الـ default الخاص بالـ provider.
  3. لا شيء - يُحلّ من البيئة: LOUSHO_MODEL (string بصيغة provider/model) إذا كان مضبوطًا، وإلا فأول ما يوجد من OPENAI_API_KEY و ANTHROPIC_API_KEY وOPENROUTER_API_KEY وOLLAMA_BASE_URL. وإذا لم يوجد أيٌّ منها، يرمي خطأً يعدّد الحلول.
تخبرك أخطاء الإعداد الخاطئ بكيفية إصلاحها: المفتاح الناقص يسمّي المتغير، والبادئة المجهولة تعدّد البادئات المدعومة وتقترح الأقرب، والـ peer package الناقصة تطبع أمر npm install الصحيح بالضبط.

Retry ونماذج fallback

يعيد createAgent() محاولة الاستدعاء الفاشل للـ model (rate limit، timeout، خطأ شبكة، 5xx) مرتين افتراضيًا. وإذا ضبطت fallbackModels ينتقل إلى الـ model التالي عندما يظل الاستدعاء فاشلًا:
يُحلّ string الـ model وكل fallback وتُعطَّل الـ retries المدمجة في ai، فيبقى retry هو طبقة الـ retry الوحيدة. ويُغلَّف instance الـ provider الـ built-in والـ provider المبني بـ fromAiSdk() بالطريقة نفسها (باستخدام maxRetries الخاص بهما، والافتراضي 2، عندما لا يكون retry مضبوطًا)، ثم تُعطَّل الـ retries الخاصة بـ ai فيهما (retry: false يرسل كل استدعاء مرة واحدة). أما أي instance provider آخر فلا يُغلَّف إلا إذا ضبطت retry. والخطوة المبثوثة التي تفشل قبل أي نص أو tool call (بعد reasoning فقط) تُعاد محاولتها أيضًا. يُصدر agent.stream() أحداث provider.retry وprovider.fallback. التفاصيل في Provider retries وfallback.

أي model يعمل؟

بالترتيب: settings.model الخاص بالـ agent (يُضبط باستخدام AgentBuilder.setSettings({ model })، أو باستخدام model بجانب provider في createAgent())، ثم الـ model الذي بُني عليه الـ provider (resolveProvider('openai/gpt-4o-mini')، أو provider.model في spec، أو defaultModel)، ثم الـ default المدمج في الـ provider. لا يُطبَّق الـ default الأخير إلا عندما لا يضبط أي شيء model — فالـ model الذي ضبطته أنت لا تتجاوزه أبدًا قيمة hard-coded.

إدخال multimodal

يكون Message.content إما string أو قائمة parts: { type: 'text', text }، و{ type: 'image', image, mimeType? } (رابط http(s)، أو data: URL، أو الـ bytes نفسها في Uint8Array) و{ type: 'file', data, mimeType, filename? }. تأخذ agent.send() وagent.stream() وsession.send() / stream() وt.send() في الـ evals وsend() الخاصة بالـ React hook كلها AgentInput: string، أو قائمة parts (تُرسل كرسالة user واحدة) أو Message[] (تُمرَّر كما هي؛ ويُضاف الـ system prompt الخاص بالـ agent في بدايتها ما لم تكن القائمة تبدأ به أصلًا، لذا يمكنك إعادة إرسال result.messages ومعها رسالة user جديدة). إرسال parts عبر createAgent():
تُمرَّر الـ Message[] كما هي؛ وتُرجع textOf() الـ parts النصية من الرسالة:
  • الصور تصل إلى الـ model داخل رسائل user مع كل الـ built-in providers (مع Anthropic وOllama تنزّل حزمة ai رابط الصورة أولًا؛ ويرسل pi data: URLs والـ bytes فقط - يتحوّل رابط http(s) إلى ملاحظة نصية مع تحذير يظهر مرة واحدة). اختر model يدعم vision: يتجاهل Ollama الصور مع model نصي فقط، ويرفضها OpenRouter له.
  • الملفات ({ type: 'file', data, mimeType }) تُرسل كـ parts من نوع file لأنواع الوسائط التالية، حسب الـ provider والإصدار الـ major من ai: أي file part آخر يرفض الاستدعاء بالخطأ LOUSHO_UNSUPPORTED_CONTENT قبل إرسال أي شيء، لذا لا يجيب الـ model أبدًا بدون الملف (وتحت withFallback() ينتقل الاستدعاء إلى الـ provider التالي). وإذا أردت ملاحظة نصية في مكانه بدلًا من ذلك ([file report.pdf (application/pdf) not sent]، مع تحذير واحد لكل media type)، فاضبط في إعداد الـ provider unsupportedFiles: 'text-note' (ويأخذ fromAiSdk() الخيار نفسه). على ai 4 يشمل نطاق @ai-sdk/* المقبول حزم 0.0.x التي لا تدعم file parts، لذا يكون كل ملف غير مدعوم هناك. ولا يزال الـ provider pi يرسل كل file part كملاحظة نصية مع تحذير يظهر مرة واحدة. وإذا كتبت subclass لـ provider يقبل الـ model الخاص به أنواعًا أكثر، فتجاوز protected fileMediaTypes(): readonly string[] لتعدادها، أو اضبط protected readonly acceptsFileParts = true لإرسال كل الأنواع.
  • تُرسل رسائل system وassistant وtool بأجزائها النصية.
  • كل ما يقرأ نص الرسائل يستخدم textOf(): estimateTokens() (يُحسب كل image أو file part بقيمة ثابتة هي 1,000 token)، والـ compaction، وcassettes الخاصة بـ recordReplay() (تخزّن النص وdigest لكل صورة أو ملف، أو رابطه) وmockModel(). يخزّن FileSessionStore الـ bytes بصيغة base64 ({ "$bytes": "..." }) ويُعيدها Uint8Array عند التحميل؛ ويفعل SqliteStore (للـ sessions والـ checkpoints) الشيء نفسه.

متقدم: executor API

يأخذ AgentExecutor.execute() الرسائل نفسها في input (راجع executor API):

Provider classes

إذا كان لديك backend آخر، فتحقق أولًا مما إذا كانت له provider package في AI SDK: إذا كانت موجودة، فغلّف الـ model الخاص بها باستخدام fromAiSdk() (أدناه). وإلا فنفّذ الـ interface LLMProvider (name وgenerate() وstream() و supportsTools() وsupportsStreaming() وgetModels()، واختياريًا defaultModel) ومرّر الـ instance بوصفه provider، أو سجّل factory باستخدام LLMProviderRegistry.register(name, factory)؛ وبعد ذلك يعمل الاسم المسجّل في string الـ model (model: 'name/model-id')، ويستلم الـ factory defaultModel ويقرأ الـ credentials الخاصة به بنفسه. يمكن للـ factory أن يأخذ نوع config خاصًا به، وهو interface يوسّع LLMProviderConfig (مثال BedrockConfig الذي يحتوي على region): register('bedrock', (config: BedrockConfig) => new BedrockProvider(config))، ثم LLMProviderRegistry.create('bedrock', { region: 'eu-west-1' }). الاسم الـ built-in ('openai'، 'anthropic'، 'google'، 'openrouter'، 'ollama'، 'pi'، 'mock') يأخذ نوع الـ config الخاص بذلك الـ provider (BuiltinProviderConfigs)، لذا يكون create('openai', { baseUrl: '...' }) خطأً في الأنواع (type error)؛ وإذا سجّلت factory خاصًا بك تحت اسم built-in، فمرّر نوع الـ config الخاص به: create<MyOpenAIConfig>('openai', ...).

مهلة الـ request

خيار timeout (بالـ ms) في الـ built-in providers هو أطول مدة انتظار حتى يبدأ رد الـ model، وبين أي chunkين منه. الاستدعاء الذي ينتظر أكثر من ذلك يفشل بـ TimeoutError قابل لإعادة المحاولة (compacted.category: 'timeout')، و يعيد retry محاولته. ولا يقطع أبدًا ردًا لا يزال يُبث. الافتراضي 10 دقائق؛ و0 أو Infinity يعطّله. تُطبَّق المهلة على كل محاولة، والمحاولة التي انتهت مهلتها تُعاد محاولتها (فالاتصال المعلّق غالبًا مؤقت)، لذا يفشل الـ provider الذي لا يرد أبدًا بعد مدة تصل إلى timeout × (maxRetries + 1) إضافةً إلى الـ backoff: نحو 30 دقيقة بالقيم الافتراضية (10 دقائق، وإعادتا محاولة). والـ stream الذي يتعلّق بعد أن أرسل نصًا لا تُعاد محاولته، فيفشل بعد timeout واحد. إذا أردته أن يفشل أسرع، فخفّض timeout أو retry.maxRetries.

تخزين ردود OpenAI (store)

على Responses API (الـ api الافتراضي، على ai 6/7)، يرسل OpenAIProvider store: false، لذا لا تحتفظ OpenAI بالاستدعاءات على الخادم: يرسل الـ SDK الـ transcript كاملًا في كل استدعاء ولا يرجع أبدًا إلى رد مخزّن. مرّر store: true إذا أردت أن تخزّنها OpenAI (لسجلات الـ dashboard لديها أو للـ evals). ويُتجاهَل store مع api: 'chat'.

Models محلية بطيئة: fetch مخصّص

تأخذ OpenAIProvider وAnthropicProvider وOpenRouterProvider و OllamaProvider خيار fetch تمر عبره استدعاءات الـ model الخاصة بها. يستسلم الـ fetch المدمج في Node مع الرد الذي تستغرق headers الخاصة به أكثر من 300 ثانية (Headers Timeout Error)، وهذا قد يحدث مع model محلي كبير في توليد طويل بدون streaming. يصنّف الـ SDK هذا الفشل كـ timeout قابل لإعادة المحاولة، لكن كل retry يبدأ التوليد من الصفر، لذا من الأفضل رفع الحد بدلًا من ذلك. ثبّت undici ومرّر الـ Agent الخاص به بوصفه dispatcher:

fetch مخصّص للـ proxies والاختبارات

إلى جانب المهل الأطول، fetch هو المكان الذي تركّب فيه proxy الشركة، أو تسجّل كل request، أو تحقن أعطالًا في الاختبارات. تأخذه OpenAIProvider و AnthropicProvider وOpenRouterProvider وOllamaProvider كلها بالطريقة نفسها، وتستخدمه OpenRouterProvider وOllamaProvider أيضًا لـ requests كتالوج الـ models. تغلّف معالجة الأخطاء وتعديلات الـ request لديها الدالة الخاصة بك، لذا يُصنَّف الفشل الذي تُرجعه منها كأنه آتٍ من الشبكة الحقيقية:

أي model من AI SDK: fromAiSdk()

تحوّل fromAiSdk(model) أي language model من provider package في AI SDK إلى LLMProvider، لذا لا تضطر إلى كتابة adapter بنفسك:
يعمل الشيء نفسه مع @ai-sdk/google (google('gemini-2.5-flash')) و@ai-sdk/amazon-bedrock و@ai-sdk/azure و@ai-sdk/mistral والـ AI Gateway (gateway('openai/gpt-4o') من ai 7 أو @ai-sdk/gateway). تمر الاستدعاءات عبر نسخة ai المثبّتة لديك، لذا ثبّت الإصدار الـ major المناسب لها من حزمة الـ provider (راجع إصدارات Vercel AI SDK). يقدّم الـ provider الـ model الواحد الذي يغلّفه فقط، مع tools وstreaming مفعّلين، ويترك إعدادات الـ reasoning للـ model الذي بنيته أنت (خيار reasoning بدون mapping). كل حالة مما يلي ترمي LOUSHO_CONFIG_INVALID:
  • string يحتوي على model id (fromAiSdk('openai/gpt-4o')): مرّر بدلًا منه الـ model الذي تُرجعه دالة الـ provider؛
  • model مبني لإصدار major آخر من ai غير المثبّت لديك (model specificationVersion: 'v1' مع ai 6 / 7، أو model أحدث مع ai 4)؛
  • run بـ model id مختلف عن المغلَّف (داخل الـ run يكون هذا سببًا للخطأ LOUSHO_PROVIDER_REQUEST_FAILED): غلّف كل model باستخدام fromAiSdk() وادمجها باستخدام withFallback().
تنتقل الـ tools المكتوبة لـ AI SDK (tool({ ... })) باستخدام fromAiSdkTools()؛ راجع الانتقال من AI SDK.

الـ provider pi

يمرّر pi/<pi-provider>/<model> الاستدعاء عبر @earendil-works/pi-ai (المحرك الذي يعمل عليه pi-coding-agent)، وهو peer اختياري لا يحتاج حزمة ai:
الجزء الذي يلي pi/ هو pi provider (openrouter، anthropic، openai، google، …)؛ والباقي هو id الـ model في الـ catalog حرفيًا، بما في ذلك الشرطات المائلة. الـ credentials لكل provider متداخل: يقرأ pi متغير البيئة المعتاد لكلٍّ منها (OPENROUTER_API_KEY وANTHROPIC_API_KEY و…)، لذا لا ترى مواصفة pi/anthropic/... مفتاح OpenRouter أبدًا. يجهّز lousho init --provider pi القيمة pi/openrouter/... كافتراضي. إذا كان مفتاح الـ provider المتداخل ناقصًا، يفشل الاستدعاء بالخطأ LOUSHO_PROVIDER_MISSING_API_KEY الذي يسمّي المتغير، وإذا كانت @earendil-works/pi-ai ناقصة يفشل بالخطأ MissingPeerDependencyError المعتاد. ما يُحوَّل في كل استدعاء:
  • الرسائل: تذهب system إلى systemPrompt الخاص بـ pi، وتبقى user/assistant/tool في مكانها؛ وتصبح بلوكات reasoning في الـ assistant أجزاء thinking، ويربط toolCallId في رسالة tool الرسالة بالـ call الخاص بها؛
  • الـ tools: تُرسل parameters بصيغة JSON Schema - تُحوَّل مدخلات raw JSON Schema وzod 3 وzod 4 وStandard Schema مرة واحدة وتُحفظ في الـ cache؛
  • الـ streams: تصبح أحداث text_delta/thinking_delta/toolcall_*/done/error الخاصة بـ pi هي نفس الـ chunks text-delta/reasoning-*/tool-call/ finish/error التي تُصدرها providers الـ ai، لذا لا تتغيّر أحداث agent.stream() وresult.usage؛
  • الـ usage والتكلفة: يدخل usage الخاص بـ pi لكل استدعاء (بما فيه cacheRead) في مجموع الـ run، وتسجّل أسعار الـ catalog تكلفة الـ model في usage.costUsd الخاص بالـ run؛
  • الـ retries: يُثبَّت maxRetries الخاص بـ pi نفسه على وضع التعطيل - ويبقى retry/fallbackModels طبقة الـ retry الوحيدة، مثل كل built-in.
تحقن PiProviderConfig.models مُدخلات في الـ catalog (الـ faux provider الخاص بـ pi، أو catalog خاص) قبل القائمة المدمجة. لا يعمل pi إلا على Node: يرفض الـ target cloudflare-worker مواصفات pi/...، ويستبدل الـ bundle الحزمة بـ shim مكتوب.

السيرفرات المحلية والمتوافقة مع OpenAI

LM Studio، و/v1 الخاص بـ Ollama، وvLLM، وllama-server الخاص بـ llama.cpp، والـ APIs المستضافة المتوافقة مع OpenAI (Groq، DeepSeek، Together، …) كلها تتحدث wire format الخاص بـ OpenAI. وجّه OpenAIProvider إلى رابط /v1 الخاص بالخادم واختر الـ API الذي ينفّذه باستخدام api:
  • قيمة api الافتراضية هي 'responses' (POST /v1/responses، الذي يقدّمه api.openai.com). أغلب السيرفرات المتوافقة تنفّذ Chat Completions فقط، وعندها يفشل الاستدعاء بـ 404، لذا اضبط api: 'chat'. مع 'chat' تُرفض الـ hosted tools المدمجة (webSearch()، codeInterpreter()، fileSearch())، لأنها tools خاصة بـ Responses API؛ أما hostedTool() فيمر بشكل عادي، و يرسل reasoning الـ effort فقط (بدون summary).
  • المفتاح وهمي: يحتاج الـ provider إلى apiKey غير فارغ، والسيرفرات المحلية تتجاهله.
  • المخرجات المنظَّمة: لا يفرض /v1/responses في LM Studio الـ JSON schema، لذا يتبعه الـ model من الـ prompt فقط. استخدم api: 'chat'، الذي يرسل الـ schema بوصفه response_format.
  • اضبط الـ context window. لا يعرف الـ model registry الـ models المحلية، لذا يفترض الـ compaction قيمة 128_000 token ويحذّر مرة واحدة. مرّر compaction: { contextWindow }، أو استدعِ registerModel({ id, provider: 'openai', contextWindow }) مرة واحدة (راجع الـ models المحلية وغير المعروفة).
الـ string openai/<model> مع OPENAI_BASE_URL. يمرّر OpenAIProvider OPENAI_BASE_URL إلى @ai-sdk/openai عندما لا يكون baseURL مضبوطًا (على كل إصدار major، بما في ذلك خط 1.x الذي يُقرَن مع ai 4)، لذا فإن createAgent({ model: 'openai/qwen3-8b' }) مع OPENAI_BASE_URL=http://localhost:1234/v1 ومفتاح وهمي OPENAI_API_KEY=any يستدعي الخادم المحلي بدون أي تغيير في الكود. يستخدم هذا المسار Responses API ما لم تضبط LOUSHO_OPENAI_API=chat أيضًا، الذي يختار Chat Completions لكل OpenAIProvider ليس فيه api صريح (وهذا ما يحتاجه vLLM وllama.cpp و /v1 الخاص بـ Ollama). أي model من AI SDK. يغلّف fromAiSdk() model Chat Completions مبنيًا باستخدام @ai-sdk/openai مباشرة (أو @ai-sdk/openai-compatible، إذا كنت تستخدمها):
يعرض npx lousho doctor قيمة OPENAI_BASE_URL عندما تكون مضبوطة، و يستدعي npx lousho doctor --ping المسار GET <base>/models على كل provider مضبوط لكي يتأكد من أن الخادم يرد.

إصدارات Vercel AI SDK

كل built-in provider باستثناء pi هو adapter فوق Vercel AI SDK (ai). ما يعمل على كل إصدار major اليوم: تقبل نطاقات الـ peer الإصدارات الـ major الثلاثة. اقرن كل واحد منها بحزم الـ provider المناسبة له: يسمّي تلميح التثبيت لحزمة provider ناقصة وlousho doctor الإصدار المناسب لنسخة ai لديك، وينبّهك lousho doctor إلى الاقتران غير المتوافق (مثال ai 7 مع @ai-sdk/openai 1.x). لا يتحقق من الاقتران إلا lousho doctor و fromAiSdk(): أما الـ built-in provider (string model) فيحمّل أي إصدار major مثبّت بدون التحقق منه، لذا شغّل lousho doctor لكي تكتشف عدم التوافق قبل أول استدعاء. يحمّل OllamaProvider ollama-ai-provider على ai 4 وollama-ai-provider-v2 على ai 6/7؛ ولحزمة v2 peer dependency على zod 4، والـ SDK يقبله، لذا ثبّت zod 4 معها (مشاريع zod 3 تستخدم Ollama مع ai 4). يجهّز lousho init الإصدار ai@^7.0.0 مع @ai-sdk/*@^4.0.0 لـ OpenAI وAnthropic وGoogle وOpenRouter، وai@^7.0.0 مع ollama-ai-provider-v2@^4.0.0 وzod 4 لـ Ollama. يثبّت الـ CI ويختبر ai 4 و6 و7، كلٌّ منها مع zod 3 وzod 4 (ستة اقترانات؛ اقتران ai 4 مع zod 4 هو الوحيد الذي لا تعلنه حزم الـ providers)، مع ollama-ai-provider-v2 الحقيقية على ai 6 و7 في الـ jobs الخاصة بـ zod 4. يستخدم OpenRouter حزمة @ai-sdk/openai موجّهة إلى الـ base URL الخاص بـ OpenRouter. بدءًا من @ai-sdk/openai 2، يستهدف الاستدعاء الافتراضي openai(modelId) الـ Responses API، الذي لا ينفّذه OpenRouter، لذا يطلب OpenRouterProvider model الـ Chat Completions (provider.chat(modelId)) على كل إصدار major؛ ويعمل على ai 4 و6 و7 مع الاقتران المذكور أعلاه. يأخذ OllamaProvider الـ base URL الخاص بالخادم (baseURL، أو OLLAMA_BASE_URL مع resolveProvider()) ويُلحق /api بالـ host المجرّد، لأن حزمتي Ollama كلتيهما تتوقعانه بهذا الشكل: http://host:11434 وhttp://host:11434/ يصبحان http://host:11434/api. أما الرابط المنتهي أصلًا بـ /api (أو /api/)، أو الذي يحتوي على أي مسار آخر مثل prefix لـ reverse proxy، فيُستخدم كما هو. يختار generate() وstream() شكل الاستدعاء حسب وحدة ai المثبّتة: عندما تُصدّر stepCountIs (v5 وأحدث)، يُرسل الـ request بشكل v6/v7 وتُقرأ النتيجة وتُعاد إلى GenerateResult أو StreamResult نفسها:
  • تصبح الرسائل ModelMessages: تصبح وسائط الـ tool call هي input الخاص به، وتصبح نتيجة الـ tool هي output (json أو text، وerror-json أو error-text عندما يفشل الـ tool)، ويصبح mimeType في الـ image أو file part هو mediaType. تبقى رسائل الـ system في مكانها (allowSystemInMessages).
  • يُرسل maxTokens باسم maxOutputTokens، والخطوة الواحدة بصيغة stopWhen: stepCountIs(1)، والـ tools بصيغة inputSchema (zod schema كما هو، وJSON Schema عبر jsonSchema()) بدون execute، وresponseFormat بصيغة output في وضع JSON لا يمسّ نص الرد.
  • يأتي الـ usage من inputTokens / outputTokens / totalTokens، مع cachedInputTokens من inputTokenDetails.cacheReadTokens وreasoningTokens من outputTokenDetails.reasoningTokens.
  • يقرأ stream() قيمة fullStream الخاصة بالـ SDK على أيٍّ من الإصدارين ويحوّلها إلى الـ chunks نفسها: text-delta (في v6/v7 الحقل text، وفي v4 textDelta)، وtool-call (الـ call الكامل الذي يرسله v6/v7 بعد tool-input-start/-delta/-end، أو call يُجمَّع من ذلك الـ input عندما لا يرسل الـ model واحدًا)، وfinish مع سبب الإنهاء الذي يعطيه الـ SDK والـ usage المذكور أعلاه (في v6/v7 الحقل totalUsage). يجعل جزء error الـ stream يُرفض بخطئه، على v4 أيضًا (كان v4 ينهي stream كهذا بسبب إنهاء error)، ويرفضه جزء abort بسبب الـ signal. تُبلَّغ تغيّرات الـ reasoning الجزئية كـ chunks من نوع reasoning-delta وتظهر كأحداث reasoning.* (راجع Reasoning).
على v6/v7 يجب أن يأتي الـ model من provider package خاصة بالإصدار الـ major نفسه (الجدول أعلاه)؛ فحزم 0.0.x/1.x تنتج models يرفضها ai v7. تُرسل الـ image parts كـ file parts بـ media type للصور (وهو الشكل الذي يقبله ai v6/v7 للصور، لذا لا يظهر تحذير deprecation). ai v5 غير مدعوم: يُفشل lousho doctor الإصدار ai 5 المثبّت مع تلميح للترقية (انتقل إلى ai 6 أو 7 والإصدار الـ major المطابق من @ai-sdk/*).

أين يعمل كل provider

تعمل كل الـ providers على Node. يدعم الـ deploy target cloudflare-worker mock وopenai وanthropic وopenrouter (المفتاح من binding باسم OPENROUTER_API_KEY)؛ أما google وollama وpi فتحتاج إلى target node-server أو docker (راجع Cloudflare Workers).