المهارات Azure AI Agents Persistent SDK for Java
📦

Azure AI Agents Persistent SDK for Java

آمن

إنشاء وكلاء ذكاء اصطناعي persistent باستخدام Azure SDK

بناء وكلاء ذكاء اصطناعي persistent يحافظون على الحالة عبر الجلسات. يوفر هذا SDK تحكماً منخفض المستوى في محادثات الوكلاء والرسائل والتشغيلات في تطبيقات Java.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "Azure AI Agents Persistent SDK for Java". إنشاء وكيل مدرس رياضيات يساعد الطلاب في الجبر

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

  • تم إنشاء الوكيل 'Math Tutor' بنجاح مع المعرف: agent_abc123
  • تم إنشاء المحادثة مع المعرف: thread_xyz789
  • تمت إضافة الرسالة إلى المحادثة
  • تم بدء التشغيل واكتماله
  • المساعد: لحل 2x + 5 = 15، اطرح أولاً 5 من كلا الطرفين...

استخدام "Azure AI Agents Persistent SDK for Java". تنفيذ كود لحل معادلة تربيعية

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

  • حالة التشغيل: RequiresAction
  • استدعاء الأداة: code_interpreter
  • تم تنفيذ الكود: numpy.roots([1, -5, 6])
  • المساعد: الحلول هي x = 2 و x = 3

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

آمن
v1 • 2/24/2026

Static analysis scanned 0 files with 0 lines. Risk score: 0/100. This skill contains only documentation (SKILL.md) describing the Azure AI Agents Persistent SDK for Java. No executable code, scripts, or security-sensitive patterns detected. The documentation describes standard Azure authentication patterns using DefaultAzureCredential which is the recommended secure approach.

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

درجة الجودة

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

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

دمج وكيل دعم العملاء

تضمين وكيل دعم persistent في الـ Java backend الخاص بك يحافظ على سجل المحادثات عبر جلسات العملاء.

نظام التدريس التعليمي

بناء وكيل تدريس مخصص يتتبع تقدم الطالب ويكيف أسلوب التدريس عبر جلسات متعددة.

سير عمل المساعد المؤسسي

إنشاء مثيلات وكيل قابلة لإعادة الاستخدام للمهام المؤسسية الشائعة مثل معالجة المستندات أو تحليل البيانات.

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

إعداد الوكيل الأساسي
ساعدني في إنشاء وكيل Azure AI persistent أساسي باستخدام Java. أظهر لي كيفية إعداد المصادقة باستخدام DefaultAzureCredential، وإنشاء وكيل بتعليمات مخصصة، وإرسال رسالة بسيطة.
محادثة متعددة الجولات
أظهر لي كيفية بناء تدفق محادثة متعددة الجولات مع وكلاء Azure AI persistent. يتضمن إنشاء المحادثات، إضافة الرسائل، تشغيل الوكيل، الاستطلاع للاكتمال، واسترجاع جميع الرسائل من المحادثة.
وكيل بأدوات مخصصة
أحتاج إلى إنشاء وكيل Azure AI يستخدم أدوات مخصصة. أظهر لي كيفية تعريف الأدوات، إرفاقها بوكيل، معالجة حالة RequiresAction، وإرسال مخرجات الأدوات مرة أخرى إلى التشغيل.
سير عمل الوكيل للإنتاج
أنشئ مثالاً كاملاً جاهزاً للإنتاج لوكلاء Azure AI persistent في Java. يتضمن معالجة أخطاء مناسبة لجميع حالات التشغيل، استخدام عميل غير متزامن للإنتاجية العالية، تنظيف الموارد في كتل finally، وتكوين قائم على البيئة.

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

  • استخدم DefaultAzureCredential للمصادقة الآمنة في الإنتاج بدلاً من المفاتيح المضمنة في الكود
  • نفذ فترات استطلاع مناسبة (500ms موصى بها) بين فحوصات حالة التشغيل لتجنب حدود المعدل
  • قم دائماً بتنظيف الموارد بحذف المحادثات والوكلاء عند عدم الحاجة إليها

تجنب

  • تخطي الاستطلاع بين فحوصات حالة التشغيل مما يسبب فقدان انتقالات الحالة
  • تضمين بيانات الاعتماد في الكود بدلاً من استخدام متغيرات البيئة وهويات Azure المدارة
  • عدم معالجة جميع حالات التشغيل (RequiresAction, Failed, Cancelled) مما يؤدي إلى سير عمل عالقة

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

ما هو Azure AI Agents Persistent SDK؟
يوفر Azure AI Agents Persistent SDK لـ Java API منخفض المستوى لإنشاء وإدارة وكلاء ذكاء اصطناعي persistent. على عكس APIs عديمة الحالة، يحافظ الوكلاء persistent على المحادثات وسجل المحادثات عبر جلسات متعددة، مما يمكّن تفاعلات معقدة متعددة الجولات.
كيف أصادق مع Azure AI Agents؟
استخدم DefaultAzureCredential الذي يتعامل تلقائياً مع المصادقة من خلال متغيرات البيئة، أو الهويات المدارة، أو بيانات اعتماد Azure CLI. اضبط متغير البيئة PROJECT_ENDPOINT على عنوان URL لنقطة نهاية مشروع Azure AI الخاص بك.
ما الفرق بين الوكيل والمحaphore والتشغيل؟
الوكيل هو مثيل الذكاء الاصطناعي المكون بتعليمات وأدوات محددة. المحادثة هي حاوية المحادثة التي تحتوي على الرسائل. التشغيل هو تنفيذ الوكيل ضد المحادثة، معالجة الرسائل وإنشاء الاستجابات.
هل الوكلاء persistent يبقون بعد إعادة تشغيل التطبيق؟
نعم، يتم تخزين الوكلاء والمحادثات على جانب الخادم في Azure. يمكنك استرجاع الوكلاء والمحادثات الموجودة بواسطة معرفاتها عبر جلسات التطبيق، مما يمكّن الاستمرارية الحقيقية للمحادثات وتكوينات الوكلاء.
كيف أتعامل مع استدعاءات الأدوات مع الوكلاء؟
عندما يتطلب الوكيل تنفيذ أداة، تصبح حالة التشغيل RequiresAction. يجب عليك إرسال مخرجات الأداة باستخدام submitToolOutputsToRun، ثم الاستمرار في استطلاع حالة التشغيل حتى الاكتمال.
هل يوجد إصدار غير متزامن من SDK؟
نعم، استخدم PersistentAgentsAsyncClient بدلاً من PersistentAgentsClient للعمليات غير المتزامنة. يوصى بالعميل غير المتزامن لسيناريوهات الإنتاجية العالية واستخدام أفضل للموارد.

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

بنية الملفات

📄 SKILL.md