Microsoft 365 에이전트 도구 키트를 사용하여 Visual Studio에서 .NET 에이전트 만들기

이 문서에서는 Microsoft 365 에이전트 도구 키트를 사용하여 Visual Studio에서 새 에이전트 SDK .NET 프로젝트를 만드는 방법을 알아봅니다.

비고

시작하기 전에 Visual Studio용 에이전트 도구 키트 확장을 설치 해야 합니다.

새 프로젝트 만들기

에이전트 도구 키트는 에이전트 빌드를 시작하는 데 도움이 되는 프로젝트 템플릿을 제공합니다. 도구 키트의 템플릿 또는 에이전트 SDK의 샘플에서 시작할 수 있습니다. 이 문서에서는 에이전트 도구 키트에서 사용할 수 있는 템플릿에 중점을 둡니다.

비고

다음 절차는 현재 .NET에 대해서만 작동합니다.

새 에이전트 프로젝트를 빌드하려면 Visual Studio를 열고 새 프로젝트 만들기를 선택합니다. Microsoft 365 에이전트 도구 키트 및 에이전트 SDK를 사용하여 "에이전트"를 검색하여 새 템플릿을 찾습니다.다음으로> 선택합니다.

에이전트 이름을 지정할 수 있도록 대화 상자가 나타납니다. 원하는 경우 위치 및 솔루션 이름을 변경할 수도 있습니다.
완료되면 다음을 선택합니다.
다음 대화 상자는 선택할 에이전트 유형을 묻는 메시지를 표시합니다. 도구 키트에서 에이전트를 만들기 위해 제공하는 몇 가지 다른 옵션을 선택할 수 있습니다. Microsoft 365 에이전트 SDK를 사용하려면 날씨 에이전트 샘플을 선택해야 합니다. 이 미리 빌드된 샘플은 Azure AI Foundry 또는 Azure OpenAI 모델을 사용하여 오케스트레이션을 위한 의미 체계 커널을 구현합니다. 모델 또는 오케스트레이터를 설정하지 않고 시작하려는 경우 빈 에이전트 샘플을 사용할 수도 있습니다.
이 연습에서는 Azure AI Foundry를 선택하고 필요한 입력을 완료합니다. 키, 엔드포인트 및 배포 이름을 포함합니다. 이 정보는 모델 및 엔드포인트의 Azure AI Foundry에서 찾을 수 있습니다.
선택하고생성합니다. 도구 키트는 시작할 준비가 된 템플릿에서 프로젝트를 만듭니다.
짧은 시간 안에 에이전트 SDK를 활용하는 새 프로젝트를 만들어야 합니다.

Microsoft 365 에이전트 플레이그라운드에서 에이전트 테스트

시작하려면 도구 키트에서 Microsoft 365 에이전트 플레이그라운드를 사용하여 로컬로 테스트할 수 있습니다.

테스트를 시작하려면 프로젝트에서 디버그 대상을 Microsoft 365 에이전트 플레이그라운드로 선택합니다."

로컬 호스트를 사용하여 새 브라우저 창에서 테스트할 수 있는 플레이그라운드가 열리고 테스트할 준비가 된 놀이터가 표시됩니다. 에이전트에 메시지 보내기를 시작하여 동작을 테스트합니다.

Microsoft Teams 또는 Microsoft 365 Copilot에서 에이전트 디버그 및 테스트

Microsoft Teams 또는 Microsoft 365 Copilot에서 직접 디버그 대상을 설정할 수도 있습니다.

대상 목록에서 디버깅 옵션 중 하나를 디버그 대상으로 선택합니다.

Microsoft Teams에 몇 분 정도 걸립니다. 열리는 Teams 클라이언트에 에이전트를 추가하라는 메시지가 표시됩니다.
추가를 선택합니다 . 에이전트가 성공적으로 추가되었음을 나타내는 알림 창이 나타납니다.
새 에이전트에서 열기 를 선택하여 Teams에서 엽니다. Teams에서 직접 에이전트에 대한 질문을 할 수 있습니다. 필요한 경우 환경 디버깅을 통해 작동하도록 중단점을 설정할 수 있습니다.