OpenAI do Azure

Introdução

Adicione os pacotes NuGet necessários ao seu projeto.

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

Todos os tipos de cliente do Azure OpenAI começam criando um 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());

Cliente de Respostas

O cliente de Respostas é o cliente primário recomendado e fornece o suporte de ferramenta mais avançado, incluindo interpretador de código, pesquisa de arquivo, pesquisa na Web e MCP hospedado.

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

Ferramentas com suporte: Ferramentas de funções, aprovação da ferramenta, interpretador de código, pesquisa de arquivo, pesquisa na Web, MCP hospedado, ferramentas MCP locais.

Cliente de conclusão de chat

O cliente de Conclusão de Chat fornece uma maneira simples de criar agentes usando a API de Conclusões de Chat. Use-o quando precisar de ampla compatibilidade com modelos ou já tiver uma integração existente com o Chat Completions.

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

Ferramentas com suporte: Ferramentas de funções, pesquisa na Web, ferramentas MCP locais.

Cliente de Assistentes

Ferramentas de Funções

Você pode fornecer ferramentas de função personalizadas para qualquer agente do 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?"));

Respostas de transmissão contínua

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

Usando o agente

Ambos os tipos de cliente produzem um AIAgent padrão que dá suporte às mesmas operações de agente (streaming, threads, middleware).

Para obter mais informações, consulte os tutoriais de Introdução.

Tools

Os clientes .NET do Azure OpenAI compartilham o mesmo conjunto de ferramentas dos clientes OpenAI correspondentes. Consulte a página do provedor OpenAI para obter a matriz completa por cliente — as variantes do Azure de Responses e Chat Completion espelham seus equivalentes diretos da OpenAI.

Diretrizes do Python

Tools

Python Azure OpenAI usa os mesmos clientes agent_framework.openai que o OpenAI direto, portanto, a superfície da ferramenta é idêntica. Consulte a seção Ferramentas na página do provedor OpenAI para obter a matriz completa por cliente.

OpenAI do Azure

No Go, o OpenAI do Azure usa o mesmo pacote openaiprovider que o OpenAI direto, com inicialização de cliente específica do Azure.

Installation

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

Criar um agente 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()

Usar a API de Respostas

Use openaiprovider.NewResponsesAgent com o mesmo cliente OpenAI configurado para o Azure quando sua implantação do OpenAI do Azure oferecer suporte à API Responses:

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

Variáveis de ambiente