用途:面向 Java 开发者,提供管理持久化 AI 代理的低层 API,代理可跨会话复用,适合实现或维护线程、消息、运行与代理管理的场景。
主要能力:客户端层级包括同步 PersistentAgentsClient、异步 PersistentAgentsAsyncClient,以及通过 getPersistentAgentsAdministrationClient、getThreadsClient、getMessagesClient、getRunsClient 获取的子客户端。核心流程为创建代理、创建线程、添加消息、运行代理、获取响应、清理资源。
必要用法:在 Maven 中引入 <dependency><groupId>com.azure</groupId><artifactId>azure-ai-agents-persistent</artifactId><version>1.0.0-beta.2</version></dependency>,并设置环境变量 PROJECT_ENDPOINT 与 MODEL_DEPLOYMENT_NAME。使用 PersistentAgentsClientBuilder 配合 DefaultAzureCredentialBuilder 构建客户端。运行后需轮询状态,建议每次间隔 500ms,并处理 RequiresAction、Failed、Cancelled 等状态,超时不等于取消云端运行。完成后删除线程与代理。
限制:属预览版 beta.2,示例使用子客户端而非 PersistentAgentsClient 上的直接 CRUD 方法。操作会产生可计费云资源、发送提示词并保留线程数据,需使用已授权的项目与模型并控制预算,仅删除本次运行创建的资源,失败时保留 ID,并脱敏消息与凭据日志。代码片段是应用内的顺序片段,非独立可编译程序;未执行云端运行验证,不能替代针对具体环境的验证与评审。资料未提供价格、更多平台或性能数据。