Azure OpenAI

Getting Started

Lägg till nödvändiga NuGet-paket i projektet.

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

Alla Azure OpenAI-klienttyper börjar med att skapa en 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());

Svarsklient

Responses-klienten är den rekommenderade primära klienten och erbjuder det mest omfattande verktygsstödet, inklusive kodtolkning, filsökning, webbsökning och hostad 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."));

Verktyg som stöds: Funktionsverktyg, verktygsgodkännande, kodtolkare, filsökning, webbsökning, värdbaserad MCP, lokala MCP-verktyg.

Klient för chattens slutförande

Klienten för Chat Completion är ett enkelt sätt att skapa agenter med hjälp av Chat Completions-API:et. Använd den när du behöver bred modellkompatibilitet eller har en befintlig Chat Completions-integrering.

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."));

Verktyg som stöds: Funktionsverktyg, webbsökning, lokala MCP-verktyg.

Assistentklient

Funktionsverktyg

Du kan tillhandahålla anpassade funktionsverktyg till valfri Azure OpenAI-agent:

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?"));

Direktuppspelningssvar

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

Använda agenten

Båda klienttyperna skapar en standard AIAgent som stöder samma agentåtgärder (direktuppspelning, trådar, mellanprogram).

Mer information finns i kom igång-handledningarna.

Tools

Azure OpenAI-.NET klienter delar sin verktygsyta med matchande OpenAI-klienter. Se sidan om OpenAI-providern för den fullständiga matrisen för varje klient – Azure-varianterna av Responses och Chat Completions speglar sina direkta OpenAI-motsvarigheter.

Python-vägledning

Tools

Python Azure OpenAI använder samma agent_framework.openai klienter som direkt OpenAI, så verktygsytan är identisk. Se avsnittet Verktyg på sidan OpenAI-provider för den fullständiga matrisen per klient.

Azure OpenAI

I Go använder Azure OpenAI samma openaiprovider-paket som för direkt OpenAI, med Azure-specifik klientinitialisering.

Installation

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

Skapa en Azure OpenAI-agent

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()

Använda svars-API:et

Använd openaiprovider.NewResponsesAgent med samma Azure konfigurerade OpenAI-klient när din Azure OpenAI-distribution har stöd för svars-API:et:

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())

Miljövariabler