用途:面向 Java 开发者的 Azure AI Foundry 项目管理 SDK,通过一组子客户端完成连接、数据集、索引、部署与评估等操作。
主要能力:ConnectionsClient 枚举已连接的 Azure 资源;DatasetsClient 上传文档并管理数据集;DeploymentsClient 枚举 AI 模型部署;IndexesClient 创建和管理搜索索引;EvaluationsClient 运行模型评估;EvaluatorsClient 管理评估器配置;SchedulesClient 管理计划任务。SDK 还暴露 OpenAI 官方 SDK 的评估接口(EvalService evalService = evaluationsClient.getOpenAIClient();)。
安装与配置:Maven 依赖 com.azure:azure-ai-projects,版本 1.0.0-beta.1。需设置环境变量 PROJECT_ENDPOINT=https://<resource>.services.ai.azure.com/api/projects/<project>。认证建议使用 DefaultAzureCredential:new AIProjectClientBuilder().endpoint(System.getenv("PROJECT_ENDPOINT")).credential(new DefaultAzureCredentialBuilder().build()),再通过 builder 构建各子客户端。
适用场景:需要以 Java 编程方式枚举连接与部署、上传数据集、创建/更新搜索索引(如 AzureAISearchIndex 指定 connectionName 与 indexName)、执行模型评估或管理计划任务的项目。
限制与注意事项:版本为 1.0.0-beta.1,资料未提供稳定性与正式版信息。列举资源时需处理 PagedIterable 分页;访问凭据前应先检查连接类型。错误处理可捕获 ResourceNotFoundException 与 HttpResponseException。资料提示:仅当任务明确匹配上述范围时使用,输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。官方文档见 https://learn.microsoft.com/azure/ai-studio/ 与 https://learn.microsoft.com/rest/api/aifoundry/aiprojects/。