Partilhar via


Azure AI Fundição Modelos Agentes

O Microsoft Agent Framework dá suporte à criação de agentes usando modelos implantados com o Azure AI Foundry Models por meio de uma API compatível com OpenAI Chat Completion e, portanto, as bibliotecas de cliente OpenAI podem ser usadas para acessar modelos do Foundry.

O Azure AI Foundry suporta a implementação de uma vasta gama de modelos, incluindo modelos de código aberto.

Observação

As capacidades destes modelos podem limitar a funcionalidade dos agentes. Por exemplo, muitos modelos de código aberto não suportam chamada de função e, portanto, qualquer agente baseado em tais modelos não poderá usar ferramentas de função.

Introdução

Adicione os pacotes NuGet necessários ao seu projeto.

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

Criando um agente OpenAI ChatCompletion com modelos de fundição

Como primeiro passo, você precisa criar um cliente para se conectar ao serviço OpenAI.

Como o código não está usando o serviço OpenAI padrão, o URI do serviço Foundry compatível com OpenAI precisa ser fornecido via 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);

Um cliente para completamento de chat pode ser criado usando o nome de implementação do modelo.

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

Finalmente, o agente pode ser criado usando o CreateAIAgent método de extensão no 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."));

Usando o agente

O agente é um padrão AIAgent e suporta todas as operações padrão AIAgent .

Consulte os tutoriais de introdução ao agente para obter mais informações sobre como executar e interagir com agentes.

Mais documentos em breve.

Próximos passos