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، …)؛ راجع الـ providerpi.- حزمة AI SDK الخاصة بالـ vendor نفسه مع
fromAiSdk()، مثالcreateAgent({ provider: fromAiSdk(mistral('mistral-large-latest')) }).
اختيار الـ provider في createAgent()
يأخذ createAgent() واحدًا فقط مما يلي:
model: 'provider/model'- يُحلّ باستخدامresolveProvider()؛ ويأتي المفتاح من متغير البيئة المعتاد للـ provider (راجع بيانات اعتماد الـ providers).provider: <LLMProvider>- provider كتبته أنت، أو built-in مضبوط، أو mock. ويمكنك أن تمرّر معهmodel(id مجرّد مثل'gpt-4o'): فيصبح هو model هذا الـ agent ويتقدّم على الـ default الخاص بالـ provider.- لا شيء - يُحلّ من البيئة:
LOUSHO_MODEL(string بصيغةprovider/model) إذا كان مضبوطًا، وإلا فأول ما يوجد منOPENAI_API_KEYوANTHROPIC_API_KEYوOPENROUTER_API_KEYوOLLAMA_BASE_URL. وإذا لم يوجد أيٌّ منها، يرمي خطأً يعدّد الحلول.
npm install الصحيح بالضبط.
Retry ونماذج fallback
يعيدcreateAgent() محاولة الاستدعاء الفاشل للـ model (rate limit،
timeout، خطأ شبكة، 5xx) مرتين افتراضيًا. وإذا ضبطت fallbackModels ينتقل
إلى الـ model التالي عندما يظل الاستدعاء فاشلًا:
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رابط الصورة أولًا؛ ويرسلpidata: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)، فاضبط في إعداد الـ providerunsupportedFiles: 'text-note'(ويأخذfromAiSdk()الخيار نفسه). علىai4 يشمل نطاق@ai-sdk/*المقبول حزم 0.0.x التي لا تدعم file parts، لذا يكون كل ملف غير مدعوم هناك. ولا يزال الـ providerpiيرسل كل 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غير المثبّت لديك (modelspecificationVersion: 'v1'معai6 / 7، أو model أحدث معai4)؛ - run بـ
modelid مختلف عن المغلَّف (داخل الـ run يكون هذا سببًا للخطأLOUSHO_PROVIDER_REQUEST_FAILED): غلّف كل model باستخدامfromAiSdk()وادمجها باستخدامwithFallback().
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 هي نفس الـ chunkstext-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_000token ويحذّر مرة واحدة. مرّرcompaction: { contextWindow }، أو استدعِregisterModel({ id, provider: 'openai', contextWindow })مرة واحدة (راجع الـ models المحلية وغير المعروفة).
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، وفي v4textDelta)، و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).
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 targetcloudflare-worker
mock وopenai وanthropic وopenrouter (المفتاح من binding باسم
OPENROUTER_API_KEY)؛ أما google وollama وpi فتحتاج إلى target node-server أو
docker (راجع Cloudflare Workers).