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

Azure AI Agents Persistent SDK for Java

آمن

Créez des agents IA persistants avec le SDK Azure

Construisez des agents IA persistants qui maintiennent un état entre les sessions. Ce SDK fournit un contrôle de bas niveau sur les threads, messages et exécutions d'agents dans les applications Java.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "Azure AI Agents Persistent SDK for Java". Créer un agent tuteur de mathématiques qui aide les étudiants en algèbre

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

  • Agent 'Math Tutor' créé avec succès avec l'ID : agent_abc123
  • Thread créé avec l'ID : thread_xyz789
  • Message ajouté au thread
  • Run initié et terminé
  • Assistant : Pour résoudre 2x + 5 = 15, soustrayez d'abord 5 des deux côtés...

استخدام "Azure AI Agents Persistent SDK for Java". Exécuter du code pour résoudre une équation quadratique

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

  • Statut du run : RequiresAction
  • Appel d'outil : code_interpreter
  • Code exécuté : numpy.roots([1, -5, 6])
  • Assistant : Les solutions sont x = 2 et 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
الامتثال للمواصفات

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

Intégration d'Agent de Support Client

Intégrez un agent de support persistant dans votre backend Java qui maintient l'historique des conversations entre les sessions clients.

Système de Tutorat Éducatif

Construisez un agent de tutorat personnalisé qui suit les progrès des étudiants et adapte le style d'enseignement sur plusieurs sessions.

Flux de Travail d'Assistant Entreprise

Créez des instances d'agents réutilisables pour les tâches d'entreprise courantes comme le traitement de documents ou l'analyse de données.

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

Configuration de Base d'Agent
Aidez-moi à créer un agent persistant Azure AI de base en Java. Montrez-moi comment configurer l'authentification avec DefaultAzureCredential, créer un agent avec des instructions personnalisées et envoyer un message simple.
Conversation Multi-tours
Montrez-moi comment construire un flux de conversation multi-tours avec des agents persistants Azure AI. Incluez la création de thread, l'ajout de messages, l'exécution de l'agent, l'interrogation pour la complétion et la récupération de tous les messages du thread.
Agent avec Outils Personnalisés
Je dois créer un agent Azure AI qui utilise des outils personnalisés. Montrez-moi comment définir des outils, les attacher à un agent, gérer le statut RequiresAction et soumettre les sorties d'outil au run.
Flux de Travail d'Agent de Production
Créez un exemple complet prêt pour la production d'agents persistants Azure AI en Java. Incluez une gestion d'erreur appropriée pour tous les statuts de run, l'utilisation du client async pour un haut débit, le nettoyage des ressources dans les blocs finally et une configuration basée sur l'environnement.

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

  • Utilisez DefaultAzureCredential pour une authentification sécurisée en production au lieu de clés codées en dur
  • Implémentez des délais d'interrogation appropriés (500ms recommandé) entre les vérifications de statut de run pour éviter la limitation de débit
  • Toujours nettoyer les ressources en supprimant les threads et agents lorsqu'ils ne sont plus nécessaires

تجنب

  • Ignorer l'interrogation entre les vérifications de statut de run, ce qui cause des transitions d'état manquées
  • Coder en dur les identifiants au lieu d'utiliser des variables d'environnement et des identités managées Azure
  • Ne pas gérer tous les statuts de run (RequiresAction, Failed, Cancelled) menant à des flux de travail bloqués

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

Qu'est-ce que le SDK Azure AI Agents Persistent ?
Le SDK Azure AI Agents Persistent pour Java fournit une API de bas niveau pour créer et gérer des agents IA persistants. Contrairement aux APIs sans état, les agents persistants maintiennent des threads et un historique de conversation entre plusieurs sessions, permettant des interactions complexes multi-tours.
Comment m'authentifier avec Azure AI Agents ?
Utilisez DefaultAzureCredential qui gère automatiquement l'authentification via des variables d'environnement, des identités managées ou des identifiants Azure CLI. Définissez la variable d'environnement PROJECT_ENDPOINT sur l'URL du point de terminaison de votre projet Azure AI.
Quelle est la différence entre un agent, un thread et un run ?
Un agent est l'instance IA configurée avec des instructions et outils spécifiques. Un thread est le conteneur de conversation qui contient les messages. Un run est l'exécution de l'agent contre un thread, traitant les messages et générant des réponses.
Les agents persistants survivent-ils aux redémarrages d'application ?
Oui, les agents et threads sont stockés côté serveur dans Azure. Vous pouvez récupérer des agents et threads existants par leurs IDs entre les sessions d'application, permettant une véritable persistance des conversations et configurations d'agents.
Comment gérer les appels d'outils avec les agents ?
Quand un agent nécessite une exécution d'outil, le statut du run devient RequiresAction. Vous devez soumettre les sorties d'outil en utilisant submitToolOutputsToRun, puis continuer à interroger le statut du run jusqu'à complétion.
Existe-t-il une version async du SDK ?
Oui, utilisez PersistentAgentsAsyncClient au lieu de PersistentAgentsClient pour des opérations non-bloquantes. Le client async est recommandé pour les scénarios à haut débit et une meilleure utilisation des ressources.

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

بنية الملفات

📄 SKILL.md