Azure AI 持久化智能体 Java SDK
帮助 Java 开发者构建、运行和管理带线程、消息与工具的持久化 Azure AI 智能体。
文档采用 DefaultAzureCredential，并将端点、模型和凭据配置放在环境变量中，未见凭据窃取、恶意外传或红线风险；但创建、上传、运行和删除云端资源会产生外部影响，未说明最小权限、用户确认、数据流、敏感文件处理、回滚或操作前检查，因此扣分。
安装、认证、同步/异步客户端、线程、消息、运行、流式响应和错误处理路径均有示例，且列出多种运行状态；但文档未提供该技能专属测试或执行证据，轮询没有超时/取消策略，工具调用处理不完整，API 与 beta 版本兼容性也未验证，因此静态评分受限并扣分。
触发词、Java SDK 目标和主要使用场景较明确，覆盖持久代理、线程、消息、运行、流式响应及工具；但未明确非适用范围、输入输出边界、语义误触发条件或中文使用指导，且依赖 Azure 项目、模型部署和云端网络环境，因此扣分。
SKILL.md 结构清晰，包含安装、环境变量、认证、核心工作流、最佳实践、错误处理和参考链接；具备 MIT 许可、作者和 1.0.0 版本元数据，但实际依赖为 beta.1，缺少技能专属变更记录、维护责任、更新路径、已知限制、FAQ 和完整安装前提，因此扣分。
示例覆盖较多常见 SDK 操作，核心代码可作为实现起点，具有明显的上下文价值；但示例未静态验证，部分代码可能缺少导入或依赖版本适配，轮询、工具执行和响应选择仍需工程补充，输出不能视为直接可交付，因此扣分。
提供 Maven、GitHub 源码和官方文档链接，仓库还展示了通用 CI 与测试基础设施；但没有该技能路径的专属测试、验收结果或第三方执行证据，无法静态确认示例可编译运行，因此仅给有限分数并扣分。
- 使用前应核对 azure-ai-agents-persistent beta.1 与示例 API 的实际兼容性，并补充该技能的编译/集成测试。
- 创建、上传、运行和删除云资源或上传文件前，应明确授权范围、数据流、文件敏感性、成本影响和恢复方案。
- 轮询应增加超时、取消、重试/退避和异常状态处理；工具调用不得在未确认的情况下执行高影响外部操作。
- 文档缺少中文说明和中国大陆网络可达性验证，用户需自行确认 Azure 服务、依赖仓库和文档访问条件。
它能做什么 & 适用场景
该技能面向 Azure AI Agents Persistent SDK for Java，提供低级 Java SDK 使用指导。它覆盖客户端创建、身份验证、智能体与线程管理、消息发送、运行轮询、响应读取和资源清理。内容还包括同步与异步客户端的选择、运行状态处理及 HTTP 错误捕获。适合需要直接控制持久化智能体工作流的 Azure Java 项目。
指导编码代理添加 Maven 依赖，读取 PROJECT_ENDPOINT、MODEL_DEPLOYMENT_NAME 和 Azure 身份验证相关环境变量，使用 PersistentAgentsClient 创建客户端。它展示如何创建智能体和线程、添加用户消息、启动运行、以 500 毫秒间隔轮询状态、读取消息响应、处理 RequiresAction、Failed 和 Cancelled 状态，并删除线程和智能体。
- Java 开发者需要在 Azure AI 项目中创建可跨会话复用的持久化智能体。
- 后端工程师需要实现线程、消息和运行组成的智能体对话流程。
- 团队需要使用 DefaultAzureCredential 或托管身份连接 Azure 服务。
- 高并发 Java 应用需要评估 PersistentAgentsAsyncClient 以提高吞吐量。
- 开发者需要为智能体运行添加状态轮询、失败处理和资源清理。
优缺点一览
- 覆盖从创建智能体到清理资源的完整低级工作流。
- 同时说明同步客户端和异步客户端。
- 包含身份验证、运行状态和 HTTP 错误处理示例。
- 提供可直接复制的 Maven 依赖和 Java 代码片段。
- 定位是低级 SDK 指导，不提供高层应用框架或完整项目模板。
- 源材料未指定 Java 版本、构建工具配置细节或测试套件。
- 示例使用 1.0.0-beta.1，属于 beta 版本。
- 需要自行准备 Azure 项目端点、模型部署和身份凭据。
如何安装
安装整个技能集合：运行 npx skills add microsoft/skills，在安装向导中选择需要的技能。将 Maven 依赖加入 Java 项目：<dependency><groupId>com.azure</groupId><artifactId>azure-ai-agents-persistent</artifactId><version>1.0.0-beta.1</version></dependency>。源材料未说明如何单独通过该命令指定此技能的安装路径。
如何使用
安装后，可向编码代理输入：“使用 PersistentAgentsClient 为 Java 创建一个持久化智能体，包含线程、用户消息、运行轮询和响应读取。”也可使用触发词 “PersistentAgentsClient”、“persistent agents java”、“agent threads java”、“agent runs java” 或 “streaming agents java”。配置 PROJECT_ENDPOINT 和 MODEL_DEPLOYMENT_NAME；若使用 DefaultAzureCredential，还需配置 AZURE_TOKEN_CREDENTIALS=prod。