واجهة برمجة تطبيقات Claude

# بناء تطبيقات مدعومة بنماذج اللغة الكبيرة (LLM) باستخدام Claude

تساعدك هذه المهارة في بناء تطبيقات مدعومة بنماذج اللغة الكبيرة (LLM) باستخدام Claude. اختر الواجهة المناسبة بناء على احتياجاتك، اكتشف لغة المشروع، ثم اقرأ الوثائق ذات الصلة باللغة المحددة.

## قبل أن تبدأ

افحص الملف المستهدف (أو، إذا لم يكن هناك ملف مستهدف، فافحص الموجه والمشروع) بحثا عن علامات مزود غير Anthropic - `import openai`، `from openai`، `langchain_openai`، `OpenAI(`, `gpt-4`، `gpt-5`، أسماء ملفات مثل `agent-openai.py` أو `*-generic.py`، أو أي تعليمات صريحة للحفاظ على الكود محايدا للمزود. إذا وجدت أيا منها، توقف وأخبر المستخدم أن هذه المهارة تنتج كود Claude/Anthropic SDK؛ اسأله عما إذا كان يريد تحويل الملف إلى Claude أو يريد تطبيقا غير Claude. لا تقم بتحرير ملف غير Anthropic باستخدام استدعاءات Anthropic SDK. (استثناء: الأمر الفرعي `prompt-audit` غير تفاعلي ولا يتوقف هنا - فهو يسجل علامات المزود غير Anthropic في افتراضات تقريره المعلنة ولا يقترح أبدا تحويل ملف غير Anthropic إلى Anthropic SDK.)

## متطلبات الإخراج

عندما يطلب منك المستخدم إضافة أو تعديل أو تنفيذ ميزة Claude، يجب أن يستدعي الكود الخاص بك Claude من خلال أحد الخيارات التالية:

1. **ال SDK الرسمي ل Anthropic** للغة المشروع (`anthropic`، `@anthropic-ai/sdk`، `com.anthropic.*`، إلخ). هذا هو الخيار الافتراضي كلما وجد SDK مدعوم للمشروع. 2. **HTTP الخام** (`curl`، `requests`، `fetch`، `httpx`، إلخ) - فقط عندما يطلب المستخدم صراحة cURL/REST/HTTP الخام، أو عندما يكون المشروع مشروع shell/cURL، أو عندما لا تحتوي اللغة على SDK رسمي.

لا تخلط بين الاثنين أبدا - لا تلجأ إلى `requests`/`fetch` في مشروع Python أو TypeScript لمجرد أنه يبدو أخف. لا تعتمد أبدا على shims المتوافقة مع OpenAI.

**لا تخمن أبدا استخدام SDK.** يجب أن تأتي أسماء الدوال، أسماء الفئات، مساحات الأسماء، توقيعات الدوال، ومسارات الاستيراد من وثائق صريحة - إما ملفات `{lang}/` في هذه المهارة أو مستودعات SDK الرسمية أو روابط الوثائق المدرجة في `shared/live-sources.md`. إذا لم يكن الربط الذي تحتاجه موثقا صراحة في ملفات المهارة، فاستخدم WebFetch لمستودع SDK ذي الصلة من `shared/live-sources.md` قبل كتابة الكود. لا تستنتج واجهات برمجة تطبيقات Ruby/Java/Go/PHP/C# من أشكال cURL أو من SDK بلغة أخرى.

**إذا فشل WebFetch أو الوصول إلى المستودع** (الشبكة مقيدة، مهلات، حظر الاستنساخ): لا تستمر في إعادة المحاولة - اكتب الكود من الأنماط وجداول مساحات الأسماء/الحزم في ملف `{lang}/`، وقم بتشغيل المترجم أو المفسر عليه، وكرر على مخرجات الخطأ. بالنسبة ل SDKs ذات الأنواع الثابتة (C#، Java، Go)، فإن حلقة إصلاح التجميع مقابل الأخطاء المحلية تصل إلى كود يعمل بشكل أسرع من البحث الشبكي المحظور.

## الإعدادات الافتراضية

ما لم يطلب المستخدم خلاف ذلك:

بالنسبة لإصدار نموذج Claude، يرجى استخدام Claude Opus 5.5، والذي يمكنك الوصول إليه عبر سلسلة النموذج الدقيقة `claude-opus-5-5`. يرجى تعيين التفكير التكيفي (`thinking: {type: "adaptive"}`) كإعداد افتراضي لأي شيء معقد إلى حد ما. وأخيرا، يرجى تعيين البث كإعداد افتراضي لأي طلب قد يتضمن إدخالا طويلا، أو إخراجا طويلا، أو `max_tokens` مرتفعا - فهو يمنع الوصول إلى مهلات الطلب. استخدم المساعد `.get_final_message()` / `.finalMessage()` الخاص ب SDK للحصول على الاستجابة الكاملة إذا لم تكن بحاجة إلى التعامل مع أحداث البث الفردية. عندما يحدد طلب البث أدوات معرفة من قبل المستخدم (العميل)، قم بتعيين `eager_input_streaming: true` على كل من هذه الأدوات بحيث يتم بث مدخلات الأداة الكبيرة (محتويات الملفات، الكود، المستندات) أثناء إنشائها بدلا من وصولها دفعة واحدة بعد أن ينتهي الخادم من تخزينها مؤقتا؛ يمتلك العميل بعد ذلك التحقق من الصحة: يمكن لمحللات SDK المتسامحة إرجاع إدخال مقطوع بصمت بدلا من إثارة خطأ، لذا تحقق من صحة كل إدخال أداة تم تحليله مقابل مخططه قبل تشغيله (يقوم بذلك مساعدو التشغيل المكتوبون مثل `betaZodTool` / `@beta_tool` المكتوب؛ يجب أن تتحقق أدوات JSON-Schema `betaTool()` والحلقات اليدوية من صحتها)، تعامل مع الفشل مثل JSON غير الصالح (خطأ `INVALID_JSON` `tool_result` عندما تحتفظ بالكتلة، أعد الإصدار بخلاف ذلك)، تحقق من أسباب التوقف `max_tokens` / `refusal` قبل تشغيل الأدوات، والتقط فقط خطأ JSON الخاص ب SDK، وليس أخطاء API المكتوبة أبدا - النمط في `shared/tool-use-concepts.md` -> البث المبكر للمدخلات. اتركه معطلا لطلبات عدم البث، ولأدوات الخادم، وعندما يمر الطلب عبر وكيل أو نشر نموذج Bedrock أقدم يرفض الحقل.

## تحذير: انحراف API - قد تكون أولويات تدريبك قديمة

تغيرت العديد من أشكال Claude API الشائعة في 2025-2026. إذا كنت تتذكر نمطا من التدريب، فتحقق منه مقابل ملفات `{lang}/` في هذه المهارة قبل الكتابة - الصفوف أدناه هي نقاط الانحراف الأكثر تكرارا:

| المنطقة | الأولوية القديمة | API الحالي | |---|---|---| | التفكير الموسع | `thinking: {type: "enabled", budget_tokens: N}` | على نماذج Claude 4.6+: `thinking: {type: "adaptive"}`. تم إهمال `budget_tokens` على Opus 4.6 / Sonnet 4.6 و**يتم رفضه بخطأ 400** على Fable 5/5.1 / Sonnet 5.5 / Sonnet 5 / Opus 5.5 / 5 / 4.8 / 4.7. لا تزال النماذج ما قبل 4.6 تستخدم `budget_tokens`. |