Build Persistent Azure AI Agents in Java Skill 技能

在生产环境中运行AI Agent需要完整的生命周期管理——创建客户端、管理线程、发送消息、触发执行轮次、处理响应、清理资源。这套Skill为Claude、Codex和Claude Code提供了一套Java实现模式，覆盖从原型搭建到生产集成的全流程。

Skill围绕Azure AI Agents Java SDK设计，包含六个核心模块。

第一，Maven依赖管理。Skill提供精确的pom.xml配置片段，自动引入Persistent Java SDK 1.0.0-beta.1及其传递依赖，确保项目从第一天起就能正确编译。

第二，同步客户端配置。展示如何用环境变量ENDPOINT和DefaultAzureCredential初始化同步客户端，避免硬编码密钥。DefaultAzureCredential会自动依次尝试环境变量、托管身份、Azure CLI凭据，适合在本地开发和生产部署之间切换。

第三，完整生命周期操作。Skill覆盖Agent、Thread、Message、Run四个实体的创建、查询和删除操作。每段代码都是独立可运行的片段，可以直接复制到项目中使用。

第四，执行轮次轮询。Run提交后不会同步等待结果，需要客户端主动查询状态。Skill提供了带终端状态检测、超时处理、适当轮询间隔和失败报告的完整轮询模板，规避beta SDK中缺少超时机制的陷阱。

第五，并发设计模式。设计使用PersistentAgentsAsyncClient的高并发Java服务时，需要明确生命周期所有权、错误传播、资源清理逻辑，以及针对不同环境的配置验证方案。

第六，HTTP错误处理。Azure SDK底层通过HTTP通信，Skill演示了如何捕获和处理非200响应码，帮助开发者在生产环境中快速定位认证失败、限速、资源不存在等问题。

使用前提：需要拥有Azure项目访问权限、已部署的AI模型、有效的Azure凭据，以及JDK 17+开发环境。该Skill为MIT许可证，代码片段为工作流片段而非完整应用程序，需根据实际业务场景组装。