Azure OpenAI

はじめに

必要な NuGet パッケージをプロジェクトに追加します。

dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
dotnet add package Microsoft.Agents.AI.OpenAI --prerelease

すべての Azure OpenAI クライアントの種類は、最初に AzureOpenAIClientを作成します。

using System;
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;

AzureOpenAIClient client = new AzureOpenAIClient(
    new Uri("https://<myresource>.openai.azure.com"),
    new DefaultAzureCredential());

レスポンスクライアント

Responses クライアントは推奨されるプライマリ クライアントであり、コード インタープリター、ファイル検索、Web 検索、ホステッド MCP など、豊富なツールサポートを提供します。

var responsesClient = client.GetResponsesClient();

AIAgent agent = responsesClient.AsAIAgent(
    model: "gpt-4o-mini",
    instructions: "You are a helpful coding assistant.",
    name: "CodeHelper");

Console.WriteLine(await agent.RunAsync("Write a Python function to sort a list."));

サポートされているツール: 関数ツール、ツール承認、コード インタープリター、ファイル検索、Web 検索、ホストされた MCP、ローカル MCP ツール。

チャット完了クライアント

チャット完了クライアントは、Chat Completions API を使用してエージェントを簡単に作成する方法を提供します。 広範なモデル互換性が必要な場合や、既存のチャット補完の統合が必要な場合に使用します。

var chatClient = client.GetChatClient("gpt-4o-mini");

AIAgent agent = chatClient.AsAIAgent(
    instructions: "You are good at telling jokes.",
    name: "Joker");

Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

サポートされているツール: 関数ツール、Web 検索、ローカル MCP ツール。

アシスタントクライアント

関数ツール

カスタム関数ツールは、任意の Azure OpenAI エージェントに提供できます。

using System.ComponentModel;
using Microsoft.Extensions.AI;

[Description("Get the weather for a given location.")]
static string GetWeather([Description("The location to get the weather for.")] string location)
    => $"The weather in {location} is cloudy with a high of 15°C.";

AIAgent agent = new AzureOpenAIClient(
    new Uri(endpoint),
    new DefaultAzureCredential())
     .GetChatClient(deploymentName)
     .AsAIAgent(instructions: "You are a helpful assistant", tools: [AIFunctionFactory.Create(GetWeather)]);

Console.WriteLine(await agent.RunAsync("What is the weather like in Amsterdam?"));

ストリーミング応答

await foreach (var update in agent.RunStreamingAsync("Tell me a joke about a pirate."))
{
    Console.Write(update);
}

エージェントの使用

どちらのクライアントの種類でも、同じエージェント操作 (ストリーミング、スレッド、ミドルウェア) をサポートする標準の AIAgent が生成されます。

詳細については、 作業の開始に関するチュートリアルを参照してください。

Tools

Azure OpenAI .NET クライアントは、一致する OpenAI クライアントとツール サーフェイスを共有します。 クライアントごとの完全なマトリックスについては、OpenAI プロバイダー ページを参照してください。Responses と Chat Completion Azureバリアントは、直接 OpenAI に相当するものを反映しています。

Python ガイダンス

Tools

Python Azure OpenAI では、直接 OpenAI と同じ agent_framework.openai クライアントが使用されるため、ツール サーフェイスは同じです。 クライアントごとの完全なマトリックスについては、「 OpenAI プロバイダー」ページの「ツール」セクション を参照してください。

Azure OpenAI

Go では、Azure OpenAI は、直接 OpenAI と同じopenaiprovider パッケージを使用し、Azure固有のクライアント初期化を行います。

Installation

go get github.com/microsoft/agent-framework-go

Azure OpenAI エージェントを作成する

import (
    "cmp"
    "fmt"
    "os"

    "github.com/microsoft/agent-framework-go/agent"
    "github.com/microsoft/agent-framework-go/provider/openaiprovider"

    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
    openai "github.com/openai/openai-go/v3"
    "github.com/openai/openai-go/v3/azure"
)

endpoint := os.Getenv("AZURE_OPENAI_ENDPOINT")
deployment := os.Getenv("AZURE_OPENAI_DEPLOYMENT_NAME")
apiVersion := cmp.Or(os.Getenv("AZURE_OPENAI_API_VERSION"), "2025-01-01-preview")

token, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
    panic(err)
}

a := openaiprovider.NewChatCompletionsAgent(
    openai.NewClient(
        azure.WithEndpoint(endpoint, apiVersion),
        azure.WithTokenCredential(token),
    ),
    openaiprovider.AgentConfig{
        Model: deployment,
        Instructions: "You are a helpful assistant.",
        Config: agent.Config{
            Name:         "AzureAgent",
        },
    },
)

resp, err := a.RunText(ctx, "Hello!").Collect()

Responses API を使用する

Azure OpenAI デプロイで Responses API がサポートされている場合は、同じAzure構成済みの OpenAI クライアントでopenaiprovider.NewResponsesAgentを使用します。

responsesAgent := openaiprovider.NewResponsesAgent(
    openai.NewClient(
        azure.WithEndpoint(endpoint, apiVersion),
        azure.WithTokenCredential(token),
    ),
    openaiprovider.AgentConfig{
        Model: deployment,
        Instructions: "You are a helpful assistant.",
        Config: agent.Config{
            Name: "AzureResponsesAgent",
        },
    },
)

response, err := responsesAgent.RunText(ctx, "Summarize the latest deployment status.").Collect()
if err != nil {
    return err
}
fmt.Println(response.String())

環境変数