使用 .NET SDK 管理 Azure 上的 Arize AI 观测与评估资源

通过集成 Azure Resource Manager SDK，让开发者能够使用 C# 自动化管理 Arize AI 的组织资源，实现 LLM 观测与评估环境的快速部署与生命周期管理。

为什么需要这个技能

在构建企业级 AI 应用时，对 LLM 的可观测性（Observability）和评估（Evaluation）至关重要。Arize AI 提供了强大的模型监控能力，而通过 Azure 托管版本，开发者可以使用熟悉的 .NET 生态进行资源调度。

手动在 Azure 门户中创建和配置组织不仅低效且难以版本化。利用本 SDK，你可以将 Arize AI 组织的创建、更新和删除集成到 CI/CD 流水线或管理后台中，实现基础设施即代码（IaC）的自动化管理。

适用场景

• 自动化环境搭建：为不同的开发、测试、生产环境快速创建独立的 Arize AI 组织。
• 动态资源调整：通过代码根据项目需求实时更新组织的标签（Tags）或订阅信息。
• 资源清理与迁移：批量查询并删除不再使用的观测资源，优化成本。
• 集成身份验证：利用 DefaultAzureCredential 实现无密钥的 Azure 安全访问。

核心工作流

1. 安装与环境准备

首先添加 NuGet 包并配置必要的 Azure 环境变量：

dotnet add package Azure.ResourceManager.ArizeAIObservabilityEval --version 1.0.0

AZURE_SUBSCRIPTION_ID=<your-subscription-id>
AZURE_TENANT_ID=<your-tenant-id>
AZURE_CLIENT_ID=<your-client-id>
AZURE_CLIENT_SECRET=<your-client-secret>

2. 身份验证与客户端初始化

使用 DefaultAzureCredential 确保在本地开发和云端部署时都能自动选择正确的认证方式。

using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.ArizeAIObservabilityEval;

var credential = new DefaultAzureCredential();
var armClient = new ArmClient(credential);

3. 创建 Arize AI 组织

定义组织属性（包括 Marketplace 订阅详情和用户信息）并提交创建请求：

using Azure.Core;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.ArizeAIObservabilityEval;
using Azure.ResourceManager.ArizeAIObservabilityEval.Models;

var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var subscription = await armClient.GetSubscriptionResource(
    SubscriptionResource.CreateResourceIdentifier(subscriptionId)).GetAsync();
var resourceGroup = await subscription.Value.GetResourceGroupAsync("my-resource-group");

var collection = resourceGroup.Value.GetArizeAIObservabilityEvalOrganizations();

var data = new ArizeAIObservabilityEvalOrganizationData(AzureLocation.EastUS)
{
    Properties = new ArizeAIObservabilityEvalOrganizationProperties
    {
        Marketplace = new ArizeAIObservabilityEvalMarketplaceDetails
        {
            SubscriptionId = "marketplace-subscription-id",
            OfferDetails = new ArizeAIObservabilityEvalOfferDetails
            {
                PublisherId = "arikimlabs1649082416596",
                OfferId = "arize-liftr-1",
                PlanId = "arize-liftr-1-plan",
                PlanName = "Arize AI Plan"
            }
        },
        User = new ArizeAIObservabilityEvalUserDetails
        {
            FirstName = "John",
            LastName = "Doe",
            EmailAddress = "john.doe@example.com"
        }
    }
};

var operation = await collection.CreateOrUpdateAsync(WaitUntil.Completed, "my-arize-org", data);
Console.WriteLine($"Created: {operation.Value.Data.Name}");

4. 资源维护（查询与更新）

• 获取资源：推荐使用 GetIfExistsAsync 避免 404 异常。
• 更新资源：使用 ArizeAIObservabilityEvalOrganizationPatch 仅提交需要更改的字段。
• 删除资源：通过 DeleteAsync 彻底移除组织资源。

下载和安装

下载 azure-mgmt-arizeaiobservabilityeval-dotnet 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐