skill

بوابة Azure AI

تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة المحتوى، موازنة التحميل، حوكمة نماذج الذكاء الاصطناعي، تحديد معدل MCP، كشف الاختراق، إضافة واجهة خلفية ل Azure OpenAI، إضافة نموذج AI Foundry، اختبار بوابة الذكاء الاصطناعي، سياسات LLM، تهيئة الواجهة الخلفية للذكاء الاصطناعي، مقاييس الرمز المميز، التحكم في تكلفة الذكاء الاصطناعي، تحويل API إلى MCP، استيراد OpenAPI إلى البوابة.

microsoft605,853+ تثبيتموثوق

نبذة

# بوابة 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add microsoft/azure-skills`، أو استنسخ المستودع وانسخ مجلد `skills/azure-aigateway` إلى دليل مهارات Claude الخاص بك.

عرض المصدر
الرخصة: MITبواسطة microsoft

أسئلة شائعة

ما هي مهارة بوابة 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.

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل بوابة Azure AI ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط وثائق المجال. يشغل مرة واحدة قبل الاستخدام الأول لم…967,342+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+
skillclaude_appclaude_codeclaude_api
npx skills add 101-skills/superpowers
أتمتة تويتر
أتمتة Twitter/X عبر النشر والتفاعل وإدارة المستخدمين من خلال واجهة سطر الأوامر inference.sh CLI. التطبيقات: x/post-tweet، x/post-create (مع وسائط)، x/…553,316+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في إنشاء المحتوى