واجهة برمجة تطبيقات 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 لمجرد أنه يبدو أخف. لا تلجأ أبدا إلى أدوات التوافق مع 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` المكتوب؛ يجب أن تتحقق أدوات `betaTool()` JSON-Schema والحلقات اليدوية من صحتها)، تعامل مع الفشل مثل 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`. |