Agent skill · software engineering · sickn33
azure-ai-agents-persistent-java
Azure AI Agents Persistent SDK for Java. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools.
Why this skill is useful
Adds executable scripts for managing persistent AI agents that extend the AI's capabilities in Java environments.
What it needs
Requires maven installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Azure AI Agents Persistent SDK for Java Low-level SDK for creating and managing persistent AI agents with threads, messages, runs, and tools. Installation Environment Variables Authentication Key Concepts The Azure AI Agents Persistent SDK provides a low-level API for managing persistent agents that can be reused across sessions. Client Hierarchy Client Purpose -------- --------- PersistentAgentsClient Sync client for agent operations PersistentAgentsAsyncClient Async client for agent operations Core Workflow 1. Create Agent 2. Create Thread 3. Add Message 4. Run Agent Check the resulting status before reading a final response: requiresaction needs an authorized tool-output handler; failed, cancelled, expired or other non-success states must be reported explicitly. A polling timeout does not cancel the cloud run. 5. Get Response 6. Cleanup Best Practices 1. Use DefaultAzureCredential for production authentication 2. Poll with appropriate delays — 500ms recommended between status checks 3. Clean up resources — Delete threads and agents when done 4. Handle all run statuses — Check for RequiresAction, Failed, Cancelled 5. Use async client for better throughput in high-concurrency scenarios Error Handling Reference Links Resource URL ---------- ----- Maven Package https://central.sonatype.com/artifact/com.azure/azure-ai-agents-persistent GitHub Source https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/ai/azure-ai-agents-persistent When to Use Use when implementing or maintaining Java persistent-agent threads, messages, runs and administration with the preview SDK. The reviewed example uses beta.2 subclients, not direct CRUD methods on PersistentAgentsClient. Limitations Operations create billable cloud resources, send prompts and retain thread data. Use an authorized project/model and explicit budgets; delete only resources created for the current run, preserve IDs on failure, and redact message/credential logs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/azure-ai-agents-persistent-java