skill
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة المحتوى، موازنة التحميل، حوكمة نماذج الذكاء الاصطناعي، تحديد معدل MCP، كشف الاختراق، إضافة واجهة خلفية ل Azure OpenAI، إضافة نموذج AI Foundry، اختبار بوابة الذكاء الاصطناعي، سياسات LLM، تهيئة الواجهة الخلفية للذكاء الاصطناعي، مقاييس الرمز المميز، التحكم في تكلفة الذكاء الاصطناعي، تحويل API إلى MCP، استيراد OpenAPI إلى البوابة.
نبذة
# بوابة Azure AI
قم بتكوين Azure API Management (APIM) كبوابة AI لحوكمة نماذج AI وأدوات MCP والوكلاء.
> **لنشر APIM**، استخدم مهارة **azure-prepare**. راجع [دليل نشر APIM](https://learn.microsoft.com/azure/api-management/get-started-create-service-instance).
## متى تستخدم هذه المهارة
| الفئة | المحفزات | |----------|----------| | **حوكمة النماذج** | "semantic caching", "token limits", "load balance AI", "track token usage" | | **حوكمة الأدوات** | "rate limit MCP", "protect my tools", "configure my tool", "convert API to MCP" | | **حوكمة الوكلاء** | "content safety", "jailbreak detection", "filter harmful content" | | **التكوين** | "add Azure OpenAI backend", "configure my model", "add AI Foundry model" | | **الاختبار** | "test AI gateway", "call OpenAI through gateway" |
---
## مرجع سريع
| السياسة | الغرض | التفاصيل | |--------|---------|---------| | `azure-openai-token-limit` | التحكم في التكلفة | [سياسات النموذج](references/policies.md#token-rate-limiting) | | `azure-openai-semantic-cache-lookup/store` | توفير 60-80% من التكلفة | [سياسات النموذج](references/policies.md#semantic-caching) | | `azure-openai-emit-token-metric` | قابلية المراقبة | [سياسات النموذج](references/policies.md#token-metrics) | | `llm-content-safety` | السلامة والامتثال | [سياسات الوكيل](references/policies.md#content-safety) | | `rate-limit-by-key` | حماية MCP/الأداة | [سياسات الأداة](references/policies.md#request-rate-limiting) |
---
## الحصول على تفاصيل البوابة
```bash # Get gateway URL az apim show --name <apim-name> --resource-group <rg> --query "gatewayUrl" -o tsv
# List backends (AI models) az apim backend list --service-name <apim-name> --resource-group <rg> \ --query "[].{id:name, url:url}" -o table
# Get subscription key az apim subscription keys list \ --service-name <apim-name> --resource-group <rg> --subscription-id <sub-id> ```
---
## اختبار نقطة نهاية AI
```bash GATEWAY_URL=$(az apim show --name <apim-name> --resource-group <rg> --query "gatewayUrl" -o tsv)
curl -X POST "${GATEWAY_URL}/openai/deployments/<deployment>/chat/completions?api-version=2024-02-01" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: <key>" \ -d '{"messages": [{"role": "user", "content": "Hello"}], "max_tokens": 100}' ```
---
## المهام الشائعة
### إضافة واجهة خلفية للذكاء الاصطناعي (AI Backend)
راجع [references/patterns.md](references/patterns.md#pattern-1-add-ai-model-backend) للحصول على الخطوات الكاملة.
```bash # Discover AI resources az cognitiveservices account list --query "[?kind=='OpenAI']" -o table
# Create backend az apim backend create --service-name <apim> --resource-group <rg> \ --backend-id openai-backend --protocol http --url "https://<aoai>.openai.azure.com/openai"
# Grant access (managed identity) az role assignment create --assignee <apim-principal-id> \ --role "Cognitive Services User" --scope <aoai-resource-id> ```
### تطبيق سياسة حوكمة الذكاء الاصطناعي
الترتيب الموصى به للسياسات في `<inbound>`:
1. **المصادقة** - الهوية المدارة للواجهة الخلفية 2. **بحث التخزين المؤقت الدلالي (Semantic Cache Lookup)** - التحقق من التخزين المؤقت قبل استدعاء AI 3. **حدود الرموز (Token Limits)** - التحكم في التكلفة 4. **سلامة المحتوى (Content Safety)** - تصفية المحتوى الضار 5. **اختيار الواجهة الخلفية (Backend Selection)** - موازنة التحميل 6. **المقاييس (Metrics)** - تتبع استخدام الرموز
راجع [references/policies.md](references/policies.md#combining-policies) للحصول على مثال كامل.
---
## استكشاف الأخطاء وإصلاحها
| المشكلة | الحل | |-------|----------| | حد الرموز 429 | زيادة `tokens-per-minute` أو إضافة موازنة التحميل | | لا توجد نتائج من التخزين المؤقت | خفض `score-threshold` إلى 0.7 | | إيجابيات خاطئة للمحتوى | زيادة عتبات الفئة (5-6) | | مصادقة الواجهة الخلفية 401 | منح APIM دور "Cognitive Services User" |
راجع [references/troubleshooting.md](references/troubleshooting.md) للحصول على التفاصيل.
---
## المراجع
- [**السياسات التفصيلية**](references/policies.md) - أمثلة كاملة للسياسات - [**أنماط التكوين**](references/patterns.md) - أنماط خطوة بخطوة - [**استكشاف الأخطاء وإصلاحها**](references/troubleshooting.md) - المشكلات الشائعة - [عينات AI-Gateway](https://github.com/Azure-Samples/AI-Gateway) - [وثائق GenAI Gateway](https://learn.microsoft.com/azure/api-management/genai-gateway-capabilities)
## مراجع SDK السريعة
- **Content Safety**: [Python](references/sdk/azure-ai-contentsafety-py.md) | [TypeScript](references/sdk/azure-ai-contentsafety-ts.md) - **API Management**: [Python](references/sdk/azure-mgmt-apimanagement-py.md) | [.NET](references/sdk/azure-mgmt-apimanagement-dotnet.md)
التثبيت
شغل هذا الأمر
npx skills add microsoft/azure-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add microsoft/azure-skills`، أو استنسخ المستودع وانسخ مجلد `skills/azure-aigateway` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة بوابة Azure AI؟
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة المحتوى، موازنة التحميل، حوكمة نماذج الذكاء الاصطناعي، تحديد معدل MCP، كشف الاختراق، إضافة واجهة خلفية ل Azure OpenAI، إضافة نموذج AI Foundry، اختبار بوابة الذكاء الاصطناعي، سياسات LLM، تهيئة الواجهة الخلفية للذكاء الاصطناعي، مقاييس الرمز المميز، التحكم في تكلفة الذكاء ا…
كيف أثبت بوابة Azure AI؟
شغل هذا الأمر في الطرفية:
npx skills add microsoft/azure-skillsمع أي أدوات ذكاء اصطناعي تعمل بوابة Azure AI؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور بوابة Azure AI؟
طورها microsoft، وتصدر بترخيص MIT.
هل بوابة Azure AI مجانية؟
نعم، يمكنك استخدامها مجانا وفق ترخيص MIT.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add 101-skills/superpowers
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى