view --main azure-ai-agents-persistent-java-upravlenie-postoyannym-sostoyaniem-ai-agentov-dlya-java.md

azure-ai-agents-persistent-java — Управление постоянным состоянием AI-агентов для Java

Name: azure-ai-agents-persistent-java — Управление постоянным состоянием AI-агентов для Java
Author: sickn33/antigravity-awesome-skills

Разработка сложных интерактивных приложений, включая разработку игр и использование игрового движка, часто требует сохранения контекста взаимодействия с искусственным интеллектом. Этот SDK для Java предоставляет низкоуровневый API для создания и управления постоянными AI-агентами, обеспечивая возможность сохранения состояния, потоков, сообщений и инструментов между сеансами. Это позволяет значительно упростить геймдев и другие приложения, требующие сохранения истории взаимодействия.

Модуль azure-ai-agents-persistent-java позволяет эффективно управлять жизненным циклом AI-агентов, включая их создание, обновление и удаление. Предоставляется детальный контроль над обработкой потоков и сообщений, а также интеграция с инструментами, что открывает широкие возможности для кастомизации и расширения функциональности. Использование DefaultAzureCredential упрощает аутентификацию в Azure AI.

В основе работы SDK лежит REST API, доступ к которому осуществляется через удобный интерфейс. Он предназначен для опытных разработчиков, которым требуется максимальная гибкость и контроль над взаимодействием с сервисами Azure AI Agents. Поддерживается аутентификация через DefaultAzureCredential и требует настройки переменных окружения, таких как PROJECT_ENDPOINT.

$ git log --oneline --stat

⭐ звёзды: 28,101

форки: 4,718

обновлено: 28 марта 2026 года в 16:54

Проводник файлов

1 файлы

SKILL.md

readonly --- lines

--- name: azure-ai-agents-persistent-java description: Azure AI Agents Persistent SDK for Java. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools. risk: unknown source: community date_added: '2026-02-27' --- # Azure AI Agents Persistent SDK for Java Low-level SDK for creating and managing persistent AI agents with threads, messages, runs, and tools. ## Installation ```xml <dependency> <groupId>com.azure</groupId> <artifactId>azure-ai-agents-persistent</artifactId> <version>1.0.0-beta.1</version> </dependency> ``` ## Environment Variables ```bash PROJECT_ENDPOINT=https://<resource>.services.ai.azure.com/api/projects/<project> MODEL_DEPLOYMENT_NAME=gpt-4o-mini ``` ## Authentication ```java 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 ```java // Create agent with tools PersistentAgent agent = client.createAgent( modelDeploymentName, "Math Tutor", "You are a personal math tutor." ); ``` ### 2. Create Thread ```java PersistentAgentThread thread = client.createThread(); ``` ### 3. Add Message ```java client.createMessage( thread.getId(), MessageRole.USER, "I need help with equations." ); ``` ### 4. Run Agent ```java 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 ```java PagedIterable<PersistentThreadMessage> messages = client.listMessages(thread.getId()); for (PersistentThreadMessage message : messages) { System.out.println(message.getRole() + ": " + message.getContent()); } ``` ### 6. Cleanup ```java client.deleteThread(thread.getId()); client.deleteAgent(agent.getId()); ``` ## 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 ```java 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 | ## When to Use This skill is applicable to execute the workflow or actions described in the overview.

Инициализация мануала...