المهارات azure-ai-projects-py
📦

azure-ai-projects-py

آمن

بناء تطبيقات Azure AI باستخدام Foundry SDK

ابنِ تطبيقات الذكاء الاصطناعي على Microsoft Foundry باستخدام Azure AI Projects Python SDK. يوفر هذا الدليل وثائق شاملة لإنشاء الوكلاء، وإدارة المحادثات، وتكوين الأدوات، وتشغيل التقييمات.

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "azure-ai-projects-py". إنشاء وكيل أساسي مع CodeInterpreterTool

النتيجة المتوقعة:

تم إنشاء الوكيل بنجاح مع المعرف 'agent-123abc'. الأدوات المُمكَّنة: CodeInterpreterTool. يمكنك الآن إنشاء سلاسل وتشغيلات بهذا الوكيل.

استخدام "azure-ai-projects-py". أظهر لي كيفية سرد عمليات النشر

النتيجة المتوقعة:

عمليات النشر المتاحة: ['gpt-4o-mini', 'gpt-4o', 'o1-mini']. يمكنك استخدام أسماء النماذج هذه عند إنشاء الوكلاء.

التدقيق الأمني

آمن
v1 • 2/24/2026

All 74 static findings are false positives. The file is a markdown documentation file (SKILL.md) containing code examples for the Azure AI Projects Python SDK. The 'external_commands' detections are markdown code fences, not shell execution. The 'network' detection is a placeholder URL template in documentation. The 'env_access' detections are documentation examples showing SDK configuration. No actual executable code or malicious patterns exist. This is a legitimate documentation skill for Microsoft's Azure Foundry SDK.

1
الملفات التي تم فحصها
301
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

بناء وكلاء الذكاء الاصطناعي في Microsoft Foundry

أنشئ وكلاء أذكياء يمكنهم تنفيذ كود Python، والبحث في الملفات، واستدعاء واجهات برمجة التطبيقات الخارجية باستخدام Azure AI Projects SDK.

تكوين أدوات وقدرات الوكلاء

أضف قدرات مثل تفسير الكود، والبحث في الملفات، و Bing grounding، واستدعاء الدوال المخصصة إلى وكلائك.

تشغيل التقييمات على مخرجات الوكلاء

استخدم المُقيِّمين المدمجين أو أنشئ مُقيِّمين مخصصين لاختبار وقياس جودة الوكيل والتزامه بالمتطلبات.

جرّب هذه الموجهات

إنشاء وكيل أساسي
أنشئ وكيل Azure AI Projects باسم 'my-agent' باستخدام نموذج gpt-4o-mini مع التعليمات 'You are a helpful assistant.' استخدم AIProjectClient مع DefaultAzureCredential.
وكيل مع Code Interpreter
أنشئ وكيلًا مع تمكين CodeInterpreterTool و FileSearchTool. يجب أن يكون الوكيل قادرًا على تنفيذ كود Python والبحث في المستندات المُحمَّلة.
تدفق سلسلة المحادثات
أظهر لي كيفية إنشاء سلسلة، وإضافة رسالة مستخدم، وإنشاء ومعالجة تشغيل، واسترجاع رد المساعد باستخدام Azure AI Projects SDK.
وكيل مُصدِّر للإنتاج
أنشئ وكيلًا مُصدَّرًا باستخدام PromptAgentDefinition مع تسمية الإصدار 'v1.0'. ضمِّن تعليمات لمتخصص دعم العملاء وأظهر كيفية نشره.

أفضل الممارسات

  • استخدم مديري السياق (async with) لـ async AIProjectClient لضمان تنظيف الموارد بشكل صحيح
  • أنشئ وكلاء مُصدَّرين باستخدام PromptAgentDefinition لعمليات النشر الإنتاجية للحفاظ على واجهات برمجة تطبيقات مستقرة
  • نظِّف الوكلاء باستخدام client.agents.delete_agent(agent.id) عند عدم الحاجة إليها لتجنب تسرب الموارد

تجنب

  • لا تُضمِّن بيانات الاعتماد في الكود - استخدم دائمًا DefaultAzureCredential أو متغيرات البيئة
  • لا تستخدم AgentsClient منخفض المستوى عندما تحتاج إلى ميزات Foundry المحددة مثل الاتصالات وعمليات النشر
  • تجنب إنشاء العديد من الوكلاء دون تنظيف - احذف الوكلاء دائمًا عند الانتهاء

الأسئلة المتكررة

ما الفرق بين AIProjectClient و AgentsClient؟
AIProjectClient هو عميل عالي المستوى لتكامل Foundry الكامل مع الاتصالات وعمليات النشر ومجموعات البيانات والإصدار. AgentsClient هو عميل منخفض المستوى لتطبيقات الوكلاء المستقلة دون ميزات Foundry.
كيف أصادق على Azure AI Projects؟
استخدم DefaultAzureCredential الذي يتعامل تلقائيًا مع المصادقة من خلال Azure AD أو الهويات المُدارة أو متغيرات البيئة.
هل يمكنني استخدام OpenAI API مباشرة مع هذه الحزمة؟
نعم، استخدم client.get_openai_client() للحصول على عميل متوافق مع OpenAI ل استدعاءات OpenAI API القياسية.
ما الأدوات التي يمكنني إضافتها إلى وكلائي؟
يمكنك إضافة CodeInterpreterTool و FileSearchTool و BingGroundingTool و AzureAISearchTool و FunctionTool و OpenApiTool و McpTool و MemorySearchTool و SharepointGroundingTool.
كيف أنشئ وكلاء مُصدَّرين؟
استخدم client.agents.create_version() مع PromptAgentDefinition لإنشاء وكلاء مُصدَّرين بواجهات برمجة تطبيقات مستقرة للإنتاج.
هل يدعم هذا العمليات غير المتزامنة؟
نعم، استخدم AIProjectClient من azure.ai.projects.aio للعمليات غير المتزامنة مع أنماط async/await.

تفاصيل المطور

بنية الملفات

📄 SKILL.md