수동으로 Azure에 에이전트 배포

Azure에서 Microsoft 365 에이전트 SDK 에이전트를 실행하려면 다음 단계가 필요합니다.

이 문서는 생성한 에이전트를 Azure와 Teams 또는 Microsoft Copilot에 배포하는 방법에 대해 다룹니다.

에이전트를 아직 만들지 않은 경우 빠른 시작: C#을 사용하여 기본 에이전트 만들기 및 테스트로 시작합니다.

Azure에 웹앱으로 에이전트 게시

  1. Azure에 에이전트 코드를 배포합니다. 에이전트 SDK 에이전트는 웹 애플리케이션입니다. 에이전트를 게시하려면 일반적으로 Azure에 웹 애플리케이션을 배포하는 데 사용하는 방법을 사용할 수 있습니다.

    • Azure App Service 앱에 ZIP 패키지로 배포
    • Visual Studio Azure App Service 앱 또는 컨테이너에 게시
    • Azure에서 지원하는 기타 컨테이너 배포
    • Microsoft 365 에이전트 도구 킷 배포

Important

Azure App Service 앱과 페더레이션된 자격 증명 또는 User-Assigned 관리 ID를 사용하는 경우 해당 ID를 Settings>Identity 아래에 추가해야 합니다.

에이전트 코드가 배포되면 기본 URL이example.azurewebsites.net 같습니다.

  1. Azure에서 Azure 봇 리소스로 이동합니다. 구성에서 메시징 엔드포인트를 https://{yourwebsite}/api/messages로 변경합니다. 웹 앱의 기본 URL로 {yourwebsite}을(를) 바꿉니다.

웹 채팅에서 테스트

웹 채팅에서 메시지를 보려면 Azure Bot 리소스의 웹 채팅 테스트를 선택하고 에이전트에 메시지를 보냅니다.

Teams와 Microsoft Copilot 명단을 준비하세요

Microsoft Teams와 Microsoft Copilot의 경우, 매니페스트를 생성하고 업로드해야 합니다. Teams나 Microsoft Copilot의 모든 요구사항을 아우르는 명단 예시를 제공하는 것은 불가능합니다. Teams 기능에는 특정 매니페스트 콘텐츠가 필요합니다.

이러한 단계는 기본 "채팅" 스타일 Teams 에이전트에 대한 개요를 제공합니다.

  1. 프로젝트에 빈 폴더를 만듭니다.
  2. Teams 매니페스트 파일의 내용을 폴더에 복사합니다.
  3. 폴더에서 manifest.json을(를) 열고 다음 내용을 편집합니다.
    • 모든 위치에서 자리 표시자 문자열 <<AAD_APP_CLIENT_ID>>을(를) Azure Bot 리소스의 ClientId(으)로 교체합니다.
    • 에이전트 기본 URL을 <<BOT_DOMAIN>>(으)로 바꿉니다.
    • 폴더의 내용을 압축하여 다음 내용이 있는 manifest.zip을(를) 만듭니다.
      • manifest.json
      • outline.png
      • color.png

Microsoft 365에 배포

  1. Azure Bot 리소스에 채널 아래 Microsoft Teams 채널이 추가되어 있는지 확인하세요.

  2. MAC(Microsoft 관리 포털)로 이동합니다.

  3. 설정 및 통합 앱에서 사용자 지정 앱 업로드를 선택합니다.

  4. 이전 섹션에서 만든 manifest.zip을(를) 선택하고 파일을 업로드합니다.

잠시 후 에이전트가 Microsoft Teams와 Microsoft Copilot에 나타납니다.

  • Last updated on