Bot Service 봇에서 클래식 챗봇을 기술로 사용

Bot Service 봇에서 클래식 챗봇을 기술 로 사용하는 경우 Bot Service 봇은 사용자가 말하는 것이 클래식 챗봇의 트리거 구와 일치하는지 여부를 결정합니다. 일치하는 항목이 있는 경우 Bot Service 봇은 대화를 클래식 챗봇에 전달할 수 있습니다. 기존 챗봇은 모든 엔터티를 추출하고 일치하는 토픽을 트리거합니다.

클래식 챗봇을 기술로 설정하려면:

1. 클래식 챗봇의 허용 목록에 Bot Service 봇을 추가합니다.

2. 클래식 챗봇용 기술 매니페스트 다운로드.

3. 봇에서 Copilot Studio 기술에 연결합니다.

4. 봇이 기술로 작동하는지 확인합니다.

전제 조건

• Bot Service 기술의 작동 방식을 이해합니다.
• Bot Service 봇의 앱 ID를 가져옵니다.

클래식 챗봇의 허용 목록에 Bot Service 봇 추가

기술로 사용하려는 클래식 챗봇의 허용 목록에 Bot Service 봇의 앱 ID를 추가합니다. 봇은 동일한 테넌트에 있어야 합니다.

1. Bot Services 봇에 대한 Microsoft 앱 ID를 가져옵니다. 이 정보는 Azure Portal 또는 봇 구성에서 찾을 수 있습니다.

2. Copilot Studio에서 기술로 사용하려는 클래식 챗봇을 엽니다.

3. 탐색 메뉴에서 설정으로 이동하여 보안을 선택합니다. 그런 다음 허용 목록을 선택합니다.

4. 허용된 발신자 추가를 선택합니다.

5. Bot Service 봇의 앱 ID 를 붙여넣고 다음을 선택합니다.

   주의

   클래식 챗봇은 다른 클래식 챗봇의 기술 역할을 할 수 없습니다. Power Virtual Agent 봇에 속한 앱 ID를 허용 목록에 추가하려고 하면 오류가 발생합니다. 봇 봇에 대한 앱 ID만 추가할 수 있습니다.

   Copilot Studio는 Bot Service 봇의 앱 ID의 유효성을 검사하고 동일한 테넌트의 봇에 속하는지 확인합니다.

6. (선택 사항) 허용 목록에 추가한 봇에 표시 이름을 추가합니다.

7. 저장을 선택합니다.

Bot Service 봇은 표시 이름을 입력한 경우 표시 이름으로 표시되고, 표시 이름을 입력하지 않은 경우 앱 ID로 표시됩니다. 언제든지 삭제하거나 편집하려면 봇의 토픽 또는 앱 ID 오른쪽에 있는 아이콘을 선택하세요.

클래식 챗봇용 클래식 챗봇 기술 매니페스트 다운로드

Bot Service 봇은 Copilot Studio 기술 매니페스트를 사용하여 매니페스트를 생성한 클래식 챗봇에 대한 연결을 구성할 수 있습니다.

모든 클래식 챗봇에는 기술 매니페스트가 있습니다. 기술 매니페스트는 기술의 이름, 인터페이스, 트리거 문구가 포함된 JSON 파일입니다.

Bot Service 봇은 기술 매니페스트를 사용하여 클래식 챗봇을 트리거할 시기를 알 수 있습니다(예: 사용자가 말하는 내용에 대한 응답).

Copilot Studio 기술 매니페스트는 Bot Service 기술 매니페스트 스키마 버전 2.2 를 따르며 intents.lu 및 manifest.json 파일로 구성됩니다.

Bot Service 봇은 클래식 챗봇이 매니페스트 데이터에 따라 사용자의 요청을 처리해야 한다고 결정할 수 있습니다. 사용자가 클래식 챗봇에 말한 모든 것을 전달합니다. 그런 다음 클래식 챗봇은 사용자가 말한 내용을 Copilot Studio 토픽과 매칭하고, 슬롯 채우기에 필요한 엔터티를 추출한 다음 Copilot Studio 토픽을 트리거합니다.

Copilot Studio 기술 매니페스트가 자동으로 생성 및 업데이트됩니다. 클래식 챗봇에는 두 가지 기술 매니페스트가 있습니다.

• 테스트 매니페스트: Bot Service 봇이 클래식 챗봇의 테스트 버전에 연결할 수 있습니다. 테스트 매니페스트를 사용하여 게시하기 전에 기술의 변경 사항을 검증합니다.

  • 테스트 매니페스트는 새로 생성된 모든 클래식 챗봇에 대해 즉시 사용할 수 있습니다.
  • 클래식 챗봇을 저장할 때마다 변경 사항을 반영하도록 자동으로 업데이트됩니다.

• 게시된 매니페스트: Bot Service 봇이 게시된 버전의 클래식 챗봇에 연결할 수 있습니다.

  • 게시된 매니페스트는 한 번 이상 게시된 클래식 챗봇에만 사용할 수 있습니다.
  • 에이전트를 게시할 때마다 변경 사항을 반영하도록 자동으로 업데이트됩니다.

두 기술 매니페스트 모두 허용 목록 관리 패널에 표시됩니다.

기술 명세서는 챗봇의 상세 정보 페이지에도 표시됩니다. 탐색 메뉴에서 설정을 선택한 다음 세부 정보를 선택합니다. 세부정보 페이지에는 환경 ID, 테넌트 ID, 봇 앱 ID 등의 기타 메타데이터가 표시됩니다.

매니페스트를 다운로드하려면 선택하세요. <의 경우 _>봇 이름매니페스트 또는 <의 경우 >봇 이름test__manifest 레이블이 지정된 .zip 파일로 다운로드됩니다.

봇에서 Copilot Studio 기술에 연결

Copilot Studio 기술 매니페스트의 정보를 사용하여 Bot Service 봇에서 기술 연결을 만들 수 있습니다.

기술 매니페스트의 구조에 대한 자세한 내용은 기술 매니페스트를 참조하세요.

기술 매니페스트의 활동 섹션에는 클래식 챗봇에서 사용할 수 있는 항목이 포함되어 있습니다.

Bot Service 봇에서 기술 소비자를 구현 하여 클래식 챗봇을 기술로 호출할 수 있습니다.

Bot Service 봇을 사용하여 클래식 챗봇을 기술로 테스트

Bot Service Emulator를 사용하여 Bot Service 봇이 클래식 챗봇을 기술로 제대로 호출하고 있는지 테스트할 수 있습니다.

다중 테넌트 Bot Service 봇을 단일 테넌트 봇으로 업데이트

다음 그림에서는 Bot Service 봇이 클래식 챗봇을 호출하여 기술로 사용하는 시나리오를 보여 줍니다.

Bot Service 봇과 클래식 챗봇에는 모두 Azure Bot 인스턴스에서 참조하는 Microsoft Entra ID 앱 등록이 있습니다. 이러한 Microsoft Entra ID 앱 등록은 다중 테넌트로 생성되었습니다. Bot Service 봇은 Bot Service 테넌트에서 토큰을 요청하고 이 토큰을 사용하여 Azure Bot Service를 사용하여 Copilot Studio에 인증합니다. Copilot Studio는 동일한 메커니즘을 사용하여 Bot Service 봇에 연결합니다.

Copilot Studio 챗봇의 애플리케이션 등록은 이제 단일 테넌트로 생성되므로 이 통신이 더 이상 작동하지 않습니다. Microsoft Entra ID는 동일한 테넌트에 없는 단일 테넌트 애플리케이션 등록에 대한 토큰을 만드는 것을 거부합니다.

또한 Copilot Studio는 들어오는 토큰의 유효성을 검사하고 클래식 챗봇의 애플리케이션 등록이 생성된 테넌트 ID와 같이 예상하지 않는 테넌트의 요청을 거부합니다.

이 문제를 해결하기 위해 두 가지 가능한 수정 사항이 있습니다.

Bot Service 봇과 동일한 테넌트에 있는 클래식 챗봇

Copilot Studio 챗봇이 이미 Bot Service 봇과 동일한 테넌트에 배포되어 있고 이 봇에서만 사용되는 시나리오에서는 봇을 단일 테넌트 구성으로 업데이트한 다음 Bot Service 봇을 다시 배포합니다. 단일 테넌트에 대한 Bot Service 봇을 구성하는 방법에 대한 자세한 내용은 봇 프로비전 및 게시를 참조하세요.

단일 테넌트로 업데이트할 수 없는 Copilot Studio 챗봇

Copilot Studio 챗봇이 이미 Bot Service 봇과 동일한 테넌트에 배포되어 있지만 봇을 단일 테넌트로 업데이트할 수 없는 시나리오에서는 Bot Service 봇의 코드를 업데이트하여 Copilot Studio 챗봇과 통신할 토큰을 만들어야 합니다. Copilot Studio 챗봇도 생성된 테넌트에 대해 토큰을 만들어야 합니다. 또한, 응답을 수락해야 하며, 이를 위해서는 기존 기술을 다중 테넌트에서 단일 테넌트로 변환의 단계를 따라야 합니다.

자세한 정보

• 스킬 개요
• 스킬 매니페스트
• 에뮬레이터에서 기술 테스트