Microsoft Agent Framework는 OpenAI Chat Completion 호환 API를 통해 Azure AI Foundry 모델과 함께 배포된 모델을 사용하여 에이전트를 만들도록 지원하므로 OpenAI 클라이언트 라이브러리를 사용하여 Foundry 모델에 액세스할 수 있습니다.
Azure AI Foundry는 오픈 소스 모델을 포함하여 다양한 모델 배포를 지원합니다.
비고
이러한 모델의 기능은 에이전트의 기능을 제한할 수 있습니다. 예를 들어 많은 오픈 소스 모델은 함수 호출을 지원하지 않으므로 이러한 모델을 기반으로 하는 에이전트는 함수 도구를 사용할 수 없습니다.
시작하기
필요한 NuGet 패키지를 프로젝트에 추가합니다.
dotnet add package Azure.Identity
dotnet add package Microsoft.Agents.AI.OpenAI --prerelease
Foundry 모델을 사용하여 OpenAI ChatCompletion 에이전트 만들기
첫 번째 단계로 OpenAI 서비스에 연결할 클라이언트를 만들어야 합니다.
코드는 기본 OpenAI 서비스를 사용하지 않으므로 OpenAI 호환 Foundry 서비스의 URI를 통해 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);
그러면 모델 배포 이름을 사용하여 채팅 완료를 위한 클라이언트를 만들 수 있습니다.
var chatCompletionClient = client.GetChatClient("gpt-4o-mini");
마지막으로 CreateAIAgent에서 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."));
에이전트 사용
에이전트는 표준 AIAgent 이며 모든 표준 AIAgent 작업을 지원합니다.
에이전트를 실행하고 상호 작용하는 방법에 대한 자세한 내용은 에이전트 시작 자습서 를 참조하세요.
더 많은 문서가 곧 제공될 예정입니다.