다음을 통해 공유

Microsoft 에이전트 프레임워크 Quick-Start 가이드

이 가이드는 에이전트 프레임워크 및 Azure OpenAI를 사용하여 기본 에이전트를 빠르게 시작하고 실행하는 데 도움이 됩니다.

필수 조건

시작하기 전에 다음이 있는지 확인합니다.

비고

Microsoft 에이전트 프레임워크는 적극적으로 지원되는 모든 .NET 버전에서 지원됩니다. 이 샘플에서는 .NET 8 SDK 이상 버전을 사용하는 것이 좋습니다.

비고

이 데모에서는 인증에 Azure CLI 자격 증명을 사용합니다. 로그인하고 az login Azure OpenAI 리소스에 액세스할 수 있는지 확인합니다. 자세한 내용은 Azure CLI 설명서를 참조하세요. 또한 api 키가 있고 역할 기반 인증을 사용하지 않으려는 경우 이 값을 api 키로 AzureCliCredential 바꿀 ApiKeyCredential 수도 있습니다. 이 경우 az login 필요하지 않습니다.

프로젝트 만들기

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

패키지 설치

패키지가 NuGet 갤러리에 게시됨 | MicrosoftAgentFramework.

먼저 다음 명령을 사용하여 다음 Microsoft Agent Framework NuGet 패키지를 애플리케이션에 추가합니다.

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

기본 에이전트 샘플 실행

이 샘플에서는 Azure OpenAI 채팅 완료를 백 엔드로 사용하여 간단한 AI 에이전트를 만들고 사용하는 방법을 보여 줍니다. 사용자 지정 지침과 함께 AzureOpenAIClient 사용하여 gpt-4o-mini 기본 에이전트를 만듭니다.

샘플 코드

Azure OpenAI 리소스의 엔드포인트로 https://your-resource.openai.azure.com/를 바꿔야 합니다.

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

AIAgent agent = new AzureOpenAIClient(
  new Uri("https://your-resource.openai.azure.com/"),
  new AzureCliCredential())
    .GetChatClient("gpt-4o-mini")
    .CreateAIAgent(instructions: "You are good at telling jokes.");

Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

(선택 사항) 야간 패키지 설치

최신 개선 사항 또는 수정 사항이 포함된 패키지를 가져와야 하는 경우 에이전트 프레임워크의 야간 빌드를 사용할 https://github.com/orgs/microsoft/packages?repo_name=agent-framework수 있습니다.

야간 빌드를 다운로드하려면 다음 단계를 수행합니다.

  1. 이러한 단계를 완료하려면 GitHub 계정이 필요합니다.

  2. read:packages 범위로 GitHub 개인용 액세스 토큰을 다음 지침을 사용하여 만듭니다.

  3. 계정이 Microsoft 조직의 일부인 경우, 조직을 싱글 사인온(SSO) 조직으로 승인해야 합니다 Microsoft.

    1. 방금 만든 개인용 액세스 토큰 옆에 있는 "SSO 구성"을 클릭한 다음 권한을 부여합니다 Microsoft.

  4. 다음 명령을 사용하여 NuGet 구성에 Microsoft GitHub 패키지 원본을 추가합니다.

    dotnet nuget add source --username GITHUBUSERNAME --password GITHUBPERSONALACCESSTOKEN --store-password-in-clear-text --name GitHubMicrosoft "https://nuget.pkg.github.com/microsoft/index.json"

  5. 파일을 NuGet.Config 수동으로 만들 수도 있습니다.

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <add key="github" value="https://nuget.pkg.github.com/microsoft/index.json" />
  </packageSources>

  <packageSourceMapping>
    <packageSource key="nuget.org">
      <package pattern="*" />
    </packageSource>
    <packageSource key="github">
      <package pattern="*nightly"/>
      <package pattern="Microsoft.Agents.AI" />
    </packageSource>
  </packageSourceMapping>

  <packageSourceCredentials>
    <github>
        <add key="Username" value="<Your GitHub Id>" />
        <add key="ClearTextPassword" value="<Your Personal Access Token>" />
      </github>
  </packageSourceCredentials>
</configuration>
    • 이 파일을 프로젝트 폴더에 배치하는 경우 Git(또는 사용하는 소스 제어)이 무시되도록 해야 합니다.
    • 이 파일을 저장할 위치에 대한 자세한 내용은 nuget.config 참조를 참조하세요.

  6. 이제 야간 빌드의 패키지를 프로젝트에 추가할 수 있습니다.

    예를 들어 이 명령을 사용합니다. dotnet add package Microsoft.Agents.AI --prerelease

  7. 또한 다음과 같이 프로젝트에서 최신 패키지 릴리스를 참조할 수 있습니다.

    <PackageReference Include="Microsoft.Agents.AI" Version="*-*" />

자세한 내용은 https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry를 참조하세요.

필수 조건

시작하기 전에 다음이 있는지 확인합니다.

  • Python 3.10 이상
  • 배포된 모델을 사용하는 Azure AI 프로젝트(예: gpt-4o-mini
  • Azure CLI 설치 및 인증(az login)
  • 에이전트 프레임워크 패키지를 설치합니다.
pip install -U agent-framework --pre

비고

설치하면 agent-framework과 agent-framework-core 및 다른 모든 공식 패키지가 설치됩니다. Azure AI 패키지만 설치하려는 경우 다음을 실행할 수 있습니다: pip install agent-framework-azure-ai --pre 모든 공식 패키지는 agent-framework-azure-ai을 포함하는, 대부분의 경우 agent-framework-core를 별도로 지정할 필요가 없습니다. 공식 패키지의 전체 목록은 에이전트 프레임워크 GitHub 리포지토리에서 찾을 수 있습니다.

비고

이 샘플에서는 인증에 Azure CLI 자격 증명을 사용합니다. 로그인하고 az login Azure AI 프로젝트에 액세스할 수 있는지 확인합니다. 자세한 내용은 Azure CLI 설명서를 참조하세요.

기본 에이전트 샘플 실행

이 샘플에서는 Azure AI를 백 엔드로 사용하여 간단한 AI 에이전트를 만들고 사용하는 방법을 보여 줍니다. 사용자 지정 지침과 함께 ChatAgent 사용하여 AzureAIAgentClient 기본 에이전트를 만듭니다.

다음 환경 변수를 설정해야 합니다.

  • AZURE_AI_PROJECT_ENDPOINT: 귀하의 Azure AI 프로젝트 엔드포인트
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: 모델 배포의 이름

샘플 코드

import asyncio
from agent_framework.azure import AzureAIClient
from azure.identity.aio import AzureCliCredential

async def main():
    async with (
        AzureCliCredential() as credential,
        AzureAIClient(async_credential=credential).create_agent(
            instructions="You are good at telling jokes."
        ) as agent,
    ):
        result = await agent.run("Tell me a joke about a pirate.")
        print(result.text)

if __name__ == "__main__":
    asyncio.run(main())

추가 예제

자세한 예제 및 고급 시나리오는 Azure AI 예제를 참조하세요.

다음 단계

에이전트 만들기 및 실행

  • Last updated on