Compartir a través de


Modelos y agentes de Azure AI Foundry

Microsoft Agent Framework admite la creación de agentes mediante modelos Foundry de Azure AI implementados a través de una API compatible con la finalización de chat de OpenAI. Por lo tanto, las bibliotecas cliente de OpenAI se pueden utilizar para acceder a los Modelos de Foundry.

Azure AI Foundry admite la implementación de una amplia gama de modelos, incluidos los modelos de código abierto.

Nota:

Las funcionalidades de estos modelos pueden limitar la funcionalidad de los agentes. Por ejemplo, muchos modelos de código abierto no admiten llamadas a funciones y, por tanto, ningún agente basado en estos modelos no podrá usar herramientas de función.

Introducción

Agregue los paquetes NuGet necesarios al proyecto.

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

Creación de un agente de ChatCompletion de OpenAI con modelos de Foundry

Como primer paso, debe crear un cliente para conectarse al servicio OpenAI.

Dado que el código no usa el servicio OpenAI predeterminado, el URI del servicio Foundry compatible con OpenAI debe proporcionarse a través de OpenAIClientOptions.

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

var clientOptions = new OpenAIClientOptions() { Endpoint = new Uri("https://<myresource>.services.ai.azure.com/openai/v1/") };

#pragma warning disable OPENAI001 // Type is for evaluation purposes only and is subject to change or removal in future updates.
OpenAIClient client = new OpenAIClient(new BearerTokenPolicy(new AzureCliCredential(), "https://ai.azure.com/.default"), clientOptions);
#pragma warning restore OPENAI001
// You can optionally authenticate with an API key
// OpenAIClient client = new OpenAIClient(new ApiKeyCredential("<your_api_key>"), clientOptions);

A continuación, se puede crear un cliente para finalizaciones de chat mediante el nombre de implementación del modelo.

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

Por último, el agente se puede crear mediante el método de extensión CreateAIAgent en el ChatCompletionClient.

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

// Invoke the agent and output the text result.
Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

Uso del agente

El agente es un AIAgent estándar y admite todas las operaciones estándar AIAgent.

Consulte los tutoriales de introducción del agente para obtener más información sobre cómo ejecutar e interactuar con agentes.

Más documentos próximamente.

Pasos siguientes