에이전트 배포 및 게시

에이전트를 빌드하고 로컬에서 테스트했습니다. 이제 클라우드에서 사용할 수 있습니다. 에이전트를 배포하고 게시하면 조직 전체에서 에이전트를 사용할 수 있으므로 팀이 Microsoft 365를 통해 에이전트를 검색, 고용 및 상호 작용할 수 있습니다.

이 가이드에서는 Azure에 에이전트 코드를 배포하고 Microsoft Admin Center에 게시하는 방법을 안내합니다. 여기서 에이전트 코드는 조직의 검색 가능한 자산이 됩니다.

개요

배포 및 게시 프로세스에는 다음 두 가지 주요 단계가 포함됩니다.

1. 배포 - Azure Web App에 에이전트 배포
2. 게시 - Microsoft 365 관리 센터 에이전트 저장소에 에이전트 게시

이러한 단계를 완료하면 조직에서 에이전트를 검색하고 고용할 수 있는 Microsoft Admin Center에서 에이전트를 사용할 수 있습니다.

필수 구성 요소

이 작업을 시작하기 이전에 다음 사항이 있는지 확인합니다:

필수 권한 및 액세스

• 다음 역할 중 하나를 가진 Microsoft Entra 사용자 계정:
  • 전역 관리자
  • 에이전트 ID 관리자
  • 에이전트 ID 개발자
• Azure 구독에 대한 기여자 액세스를 갖는 사용자

필요한 도구

• Azure CLI 설치 및 인증(Azure CLI 설치)
• A365 CLI 설치(에이전트 365 CLI)

필수 설정 단계

배포 및 게시하기 전에 다음 단계를 순서대로 완료해야 합니다.

1. 만든 에이전트 ID - 에이전트 등록의 모든 단계를 완료하여 에이전트 청사진 및 인스턴스 만들기
2. 로컬로 테스트된 에이전트 - 에이전트가 에이전트 플레이그라운드에서 제대로 작동하는지 확인합니다(로컬로 테스트 에이전트 참조).
3. 구성 파일 준비 - 최신 상태인지 a365.generated.config.json 확인 a365.config.json

1단계: Azure에 배포

이 a365 deploy 명령은 설치 중에 만든 Azure Web App에 에이전트를 배포합니다. 이렇게 하면 에이전트 코드를 Azure에 업로드하여 클라우드에서 실행하고 Microsoft 365의 요청을 처리할 수 있습니다.

에이전트 배포

배포 명령은 다음과 같습니다.

a365 deploy

배포 확인

배포가 완료된 후:

1. Azure Portal에서 해당 웹앱으로 이동합니다.
2. 앱에서 설정>고급 설정으로 이동하세요.
3. 배포 센터에서 배포 로그 확인

2단계: Microsoft 관리 센터에 게시

이 a365 publish 명령은 에이전트를 Microsoft 365 관리 센터 에이전트 저장소에 게시하여 검색 가능하고 설치할 수 있도록 합니다. 이 마지막 단계를 통해 조직에서 Microsoft 365 환경 내에서 에이전트를 고용하고 사용할 수 있습니다.

4. 게시 에이전트

게시 명령을 실행합니다.

a365 publish

명령 게시.

• 포함된 리소스에서 매니페스트 템플릿을 추출합니다(폴더가 없는 경우 manifest ).
• 에이전트 청사진 ID를 사용하여 manifest.json 업데이트
• 매니페스트 필드(버전, 이름, 설명, 개발자 정보, 아이콘)를 사용자 지정할 수 있도록 일시 중지
• 패키지 앱 번들(manifest.zip)
• Microsoft 365 관리 센터 에이전트 저장소에 업로드
• Teams 통합을 위한 페더레이션 ID를 만듭니다.
• 필요한 그래프 권한 할당

매니페스트 사용자 지정

게시하는 동안 CLI가 일시 중지되어 에이전트 매니페스트를 사용자 지정할 수 있습니다.

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

수동 단계:

1. 텍스트 편집기에서 manifest.json 파일을 엽니다.
2. 필요한 필드를 사용자 지정합니다.
   • 버전 번호를 업데이트합니다. 다시 업로드하는 경우 이전 버전에서 증가합니다.
   • 의미 있는 에이전트 이름을 설정합니다. 이름은 30자 미만이어야 합니다.
   • PR 설명 작성
   • 개발자 정보
   • 선택적으로 아이콘 파일 바꾸기
3. 매니페스트 파일 업데이트
4. CLI로 돌아가서 Enter 키를 입력 continue 하거나 c 누릅니다.

배포된 에이전트 테스트

에이전트를 배포하고 게시한 후 Microsoft 365에서 테스트하여 프로덕션 환경에서 제대로 작동하는지 확인할 수 있습니다. 에이전트가 배포되면 Teams(채팅, 채널, 모임), 전자 메일 및 일정(보내기/받기, 일정), SharePoint 및 OneDrive(문서 액세스, 파일 공유) 및 공동 작업 도구(조직의 현재 상태, Planner 작업, 문서 주석)를 포함한 Microsoft 365 서비스와 통합됩니다.

관리 센터에서 배포된 에이전트 보기

게시한 후 에이전트가 고용을 위해 Microsoft 관리 센터에 표시됩니다. 전파하는 데 다소 시간이 걸릴 수 있습니다.

Microsoft 365 관리 센터로 이동합니다.

• 게시된 에이전트 보기
• 앱 설정 관리
• 에이전트 사용량 모니터링
• 권한 구성

Teams의 테스트 에이전트

에이전트를 배포하고 게시한 후 Microsoft Teams에서 직접 테스트할 수 있습니다.

1. 개발자 포털 열기

   • 개발자 포털로 이동합니다.
   • 이름으로 에이전트 검색
   • 이 포털에 액세스할 수 없는 경우 테넌트 관리자에게 문의하세요.

2. 에이전트 청사진 구성

   • 에이전트 유형을 봇 기반으로 설정
   • 출력에서 a365 config display -g 봇 ID 설정(값 사용agentBlueprintId)
   • 구성 저장

3. Teams에서  사용 시작

   • 계정을 사용하여 Microsoft Teams 열기
   • 새로 만든 에이전트 사용자와 새 채팅 시작
   • 테스트 메시지를 보내 에이전트 기능 확인

4. 테스트 메시지 예제

   전자 메일 기능을 테스트하기 위해 이 메시지를 보냅니다(필요에 따라 받는 사람 전자 메일 업데이트).

   Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"
   

   에이전트는 더 많은 확인 없이 요청을 처리하고 이메일을 보내야 합니다.

다음 단계:

축하합니다! 이제 에이전트가 클라우드에 있으며 Microsoft 365의 팀과 함께 작업할 준비가 되었습니다. 로컬 코드로 시작한 것은 이제 조직 전체에서 고용할 수 있는 검색 가능한 엔터프라이즈 지원 도우미입니다.

에이전트가 실제 요청을 처리할 때 다음 단계를 고려합니다.

• 성능 모니터링: 관찰 기능을 사용하여 에이전트 동작 추적 및 응답 최적화
• 도구 추가: 도구 카탈로그를 탐색하여 에이전트의 기능을 확장합니다.
• 반복 및 개선: 에이전트 코드를 업데이트하고, 다시 배포하고, 다시 게시합니다(버전 번호를 늘려야 합니다.)
• 조직 전체에서 크기 조정: 에이전트의 성공 사례를 공유하여 채택 추진

개발에서 배포에 이르는 에이전트의 여정은 완료되었지만 그 영향은 이제 막 시작되었습니다.

관련 콘텐츠

• 에이전트 청사진 및 인스턴스 설정
• 에이전트 365 CLI 참조
• 에이전트 테스트
• 관찰 가능성에 대해 알아보기
• 개발자 샘플