What is Azure AI Agents Persistent Java?

Azure AI Agents Persistent Java is a free, open-source AI agent skill. |

How do I install Azure AI Agents Persistent Java?

Install Azure AI Agents Persistent Java with a single command: npx mdskills install sickn33/azure-ai-agents-persistent-java. This downloads the skill files into your project and your AI agent picks them up automatically.

What platforms support Azure AI Agents Persistent Java?

Azure AI Agents Persistent Java works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Codex, Gemini Cli, Amp, Roo Code, Goose, Opencode, Trae, Qodo, Command Code. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.

Azure AI Agents Persistent SDK for Java

Name: Azure AI Agents Persistent Java: AI Agent Skill
Rating: 4 (1 reviews)
Author: sickn33

Low-level SDK for creating and managing persistent AI agents with threads, messages, runs, and tools.

Installation


    com.azure
    azure-ai-agents-persistent
    1.0.0-beta.1

Environment Variables

PROJECT_ENDPOINT=https://.services.ai.azure.com/api/projects/
MODEL_DEPLOYMENT_NAME=gpt-4o-mini

Authentication

import com.azure.ai.agents.persistent.PersistentAgentsClient;
import com.azure.ai.agents.persistent.PersistentAgentsClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;

String endpoint = System.getenv("PROJECT_ENDPOINT");
PersistentAgentsClient client = new PersistentAgentsClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

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

// Create agent with tools
PersistentAgent agent = client.createAgent(
    modelDeploymentName,
    "Math Tutor",
    "You are a personal math tutor."
);

2. Create Thread

PersistentAgentThread thread = client.createThread();

3. Add Message

client.createMessage(
    thread.getId(),
    MessageRole.USER,
    "I need help with equations."
);

4. Run Agent

ThreadRun run = client.createRun(thread.getId(), agent.getId());

// Poll for completion
while (run.getStatus() == RunStatus.QUEUED || run.getStatus() == RunStatus.IN_PROGRESS) {
    Thread.sleep(500);
    run = client.getRun(thread.getId(), run.getId());
}

5. Get Response

PagedIterable messages = client.listMessages(thread.getId());
for (PersistentThreadMessage message : messages) {
    System.out.println(message.getRole() + ": " + message.getContent());
}

6. Cleanup

client.deleteThread(thread.getId());
client.deleteAgent(agent.getId());

Best Practices

Use DefaultAzureCredential for production authentication
Poll with appropriate delays — 500ms recommended between status checks
Clean up resources — Delete threads and agents when done
Handle all run statuses — Check for RequiresAction, Failed, Cancelled
Use async client for better throughput in high-concurrency scenarios

Error Handling

import com.azure.core.exception.HttpResponseException;

try {
    PersistentAgent agent = client.createAgent(modelName, name, instructions);
} catch (HttpResponseException e) {
    System.err.println("Error: " + e.getResponse().getStatusCode() + " - " + e.getMessage());
}

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

Azure AI Agents Persistent Java