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

아티클
12/09/2024

참고

이 문서에는 Copilot Studio 기존 챗봇에만 적용되는 정보가 포함되어 있습니다. 이 기능은 새로운 Copilot Studio 환경에서는 사용할 수 없습니다.

기술 와 Bot Framework 봇를 사용하여 클래식 챗봇을 사용할 경우, Bot Framework 봇는 사용자가 말하는 내용이 클래식 챗봇의 트리거 문구와 일치하는지 여부를 판별합니다. 일치하는 것이 있으면 Bot Framework 봇 가 대화를 클래식 챗봇으로 전달합니다. 클래식 챗봇은 모든 엔터티 를 추출하고 일치하는 토픽를 트리거합니다.

또한 Composer에서 입력으로 기술 토픽에 변수를 전달하고 Copilot Studio 반환되는 출력을 사용할 수도 있습니다. Bot Framework

중요

기술와 같은 클래식 챗봇을 사용하려면 평가판 또는 전체 Copilot Studio 라이선스가 필요합니다. 이 기능은 Teams Copilot Studio 라이선스에서는 사용할 수 없습니다.

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

클래식 챗봇의 허용 목록에 Bot Framework 봇를 추가하세요.
클래식 챗봇용 기술 매니페스트를 다운로드하세요.
Composer에서 다운로드한 기술 매니페스트를 사용하여 봇 간의 연결을 만듭니다. Bot Framework
Bot Framework 에뮬레이터를 사용하여 봇가 기술로 작동하는지 확인하세요.

전제 조건

클래식 챗봇의 허용 목록에 Bot Framework 봇를 추가하세요.

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

Bot Framework Composer에서 기술을 사용할 봇을 엽니다. 구성을 선택한 다음 개발 리소스를 선택합니다. ID를 Microsoft 앱 ID에 복사합니다.
Copilot Studio에서 기술로 사용하고 싶은 클래식 챗봇을 엽니다.
탐색 메뉴에서 설정으로 이동하여 보안을 선택합니다. 그런 다음 허용 목록을 선택합니다.
허용된 발신자 추가를 선택합니다.
Bot Framework 봇의 앱 ID를 붙여넣고 다음을 선택합니다.

주의

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

Copilot Studio Bot Framework 봇의 앱 ID를 검증하고 동일한 테넌트의 봇에 속하는지 확인합니다.
(선택 사항) 허용 목록에 추가한 봇에 표시 이름을 추가합니다.
저장을 선택합니다.

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

노트

허용 목록에 추가된 Bot Framework 봇은 봇 콘텐츠의 일부로 내보내지 않습니다.

클래식 챗봇을 위한 클래식 챗봇 기술 매니페스트를 다운로드하세요

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

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

Bot Framework 봇 기술 매니페스트를 사용하면 클래식 챗봇을 언제 트리거 해야 하는지 알 수 있습니다(예: 응답 사용자가 말한 내용).

Copilot Studio 기술는 따라와 버전 2.2의 기술 매니페스트 스키마 Bot Framework 를 매니페스트로 만들고, intents.lu 와 manifest.json 파일로 구성됩니다.

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

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

테스트 매니페스트: 클래식 챗봇의 테스트 버전에 봇~연결를 허용합니다. Bot Framework 테스트 매니페스트를 사용하여 게시하기 전에 기술의 변경 사항을 검증합니다.
- 테스트 매니페스트는 새로 생성된 모든 클래식 챗봇에서 즉시 사용할 수 있습니다.
- 클래식 챗봇을 저장 할 때마다 변경 사항을 반영하도록 자동으로 업데이트됩니다.
게시된 매니페스트: 클래식 챗봇의 게시된 버전에 봇~연결를 허용합니다. Bot Framework
- 게시된 매니페스트는 최소한 한 번 게시된 클래식 챗봇에서만 사용할 수 있습니다.
- 여러분이 에이전트 를 게시할 때마다 자동으로 업데이트되어 변경 사항이 반영됩니다.

참고

게시된 매니페스트 는 게시된 적이 없는 기존 챗봇에는 사용할 수 없습니다.

봇의 게시된 매니페스트를 생성하려면 클래식 챗봇을 게시하세요.

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

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

매니페스트를 다운로드하려면 선택하세요. 해당 파일은 게시된 매니페스트의 경우 _<봇 이름>매니페스트 이라는 라벨이 붙은 .zip 파일로 다운로드되거나, 테스트 매니페스트의 경우 봇 이름test__manifest <이라는 라벨이 붙은 .zip 파일로 다운로드됩니다.>

참고

기술 매니페스트에는 클래식 챗봇에 추가된 시스템 토픽과 Composer 대화 상자가 포함되어 있지 않습니다. Copilot 작성자가 생성한 토픽 및 작성자가 봇에 추가한 Composer 인텐트 트리거만 포함됩니다.

연결에서 Composer의 기술로 Copilot Studio

Composer의 봇에서 기술 연결을 생성하려면 Copilot Studio 기술 매니페스트를 사용하세요. Bot Framework 봇

Bot Framework Composer 프로젝트에서 + 추가를 선택한 다음 기술에 연결을 선택합니다.
Copilot Studio manifest .zip 아카이브를 찾아서 선택한 다음 다음을 선택합니다.
Bot Framework 봇에 추가하려는 클래식 챗봇의 주제나 의도를 선택한 후 다음을 선택하세요.
클래식 챗봇의 트리거 문구를 검토하고 편집한 후 다음을 선택하세요.
멀티봇 프로젝트에 오케스트레이터 사용을 선택한 다음 계속을 선택합니다.
Copilot Studio 기술가 Bot Framework 봇에 올바르게 추가되었는지 확인하고, 클래식 챗봇의 이름이 지정된 새로운 트리거가 Composer의 프로젝트에 나타나는지 확인하세요.

기술 매니페스트에서 토픽 찾기

기술에서 이벤트를 사용하여 트리거 a Copilot Studio 토픽를 실행하세요. Composer에서 특정 토픽을 호출하려면 기술 매니페스트에서 관련된 이벤트의 이름으로 토픽을 참조하세요.

기술에 연결 작업을 선택합니다.
기술 대화 이름 아래에서 기술 매니페스트 표시를 선택합니다.
매니페스트에서 활동을 찾습니다. 이 속성에는 클래식 챗봇에서 사용할 수 있는 주제를 나타내는 중첩된 속성이 포함되어 있습니다.
호출하려는 토픽을 찾아 이름 속성을 찾습니다. Copilot Studio 기술가 이 이름의 이벤트를 수신하면 토픽가 트리거됩니다.

이 예에서 이벤트 활동 이름은 dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d입니다.

Copilot Studio 기술 토픽에 전화하세요

사용자가 트리거 a Copilot Studio 기술 토픽,라고 말하는 것에 의존하는 대신 직접 호출할 수 있습니다. 기술 매니페스트에 나열된 주제만 직접 호출할 수 있습니다. Copilot Studio

Composer 제작 캔버스에서 추가를 선택한 후 외부 리소스 액세스를 선택한 다음 기술에 연결을 선택합니다.
기술 대화 상자 이름 목록에서 클래식 챗봇을 선택하세요.
호출하고 싶은 클래식 챗봇 토픽 에 대한 이벤트 활동 이름을 찾으세요. 따옴표를 생략하고 값을 복사하고 저장하여 다음 단계에서 사용합니다.
닫기를 선택합니다.
활동 섹션에서 코드 표시 옵션을 선택합니다.
다음 코드를 입력하거나 붙여넣습니다. TOPIC_ACTIVITY_NAME을(를) 토픽의 이벤트 활동 이름으로 바꿉니다. name 속성에 따옴표가 없어야 합니다.
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```

Copilot Studio 기술 토픽에 입력 변수를 전달합니다.

Bot Framework Composer는 변수를 Copilot Studio 기술 토픽에 입력으로 전달할 수 있습니다. 입력 변수를 허용하는 주제를 만드는 방법을 알아보려면 Copilot Studio 변수 사용을 참조하세요. ...

입력 변수를 받을 수 있는 Copilot Studio 토픽가 기술 매니페스트에 나열되어 있는 경우, 여기에 Composer 변수를 전달할 수 있습니다.

Composer 제작 캔버스에서 추가를 선택한 후 외부 리소스 액세스를 선택한 다음 기술에 연결을 선택합니다.
기술 대화 상자 이름 목록에서 클래식 챗봇을 선택하세요.
호출하고 싶은 클래식 챗봇 토픽 에 대한 이벤트 활동 이름을 찾으세요. 따옴표를 생략하고 값을 복사하고 저장하여 다음 단계에서 사용합니다.
토픽의 값 속성을 찾습니다. value 속성에는 $ref 속성이 포함되어 있습니다. 그 값을 복사하고 다음 단계에서 사용할 수 있도록 저장합니다.

경고

Copilot Studio 토픽에 입력이 없으면 값 속성이 없습니다.
definitions 속성을 찾은 다음 이전 단계에서 찾은 $ref 값과 일치하는 중첩 속성을 찾습니다. Copilot Studio 토픽의 입력 이름과 유형을 주목하세요. 다음 단계에서 사용하게 됩니다.
닫기를 선택합니다.
활동 섹션에서 코드 표시 옵션을 선택합니다.
다음 코드를 입력하거나 붙여넣습니다. 다음 값을 바꿉니다.
1. TOPIC_ACTIVITY_NAME을(를) 토픽의 이벤트 활동 이름으로 바꿉니다.
2. PVA_INPUT_VARIABLE을(를) 토픽의 입력 변수로 바꿉니다.
3. COMPOSER_INPUT_VARIABLE을(를) 값을 제공할 Composer 변수로 바꿉니다.
```
[Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]
```
이 예에서 Composer 변수 dialog.storeLocation 는 클래식 챗봇 토픽 pva_StoreLocation 의 입력 변수 dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16에 값을 제공합니다.

Copilot Studio 기술 토픽에서 출력 변수를 받습니다.

Composer에서는 Copilot Studio 기술 토픽에서 출력을 수신하는 것이 가능합니다. 출력을 반환하는 주제를 만드는 방법을 알아보려면 Copilot Studio 변수 사용 을 참조하세요.

Composer 제작 캔버스에서 추가를 선택한 후 외부 리소스 액세스를 선택한 다음 기술에 연결을 선택합니다.
기술 대화 상자 이름 목록에서 클래식 챗봇을 선택하세요.
호출하려는 클래식 챗봇 토픽 에 대한 이벤트 활동 이름을 찾으세요. 따옴표를 생략하고 값을 복사하고 저장하여 다음 단계에서 사용합니다.
토픽의 resultValue 속성을 찾습니다. resultValue 속성에는 $ref 속성이 포함되어 있습니다. 그 값을 복사하고 다음 단계에서 사용할 수 있도록 저장합니다.

경고

Copilot Studio 토픽에 출력이 없으면 resultValue 속성이 없습니다.
definitions 속성을 찾은 다음 이전 단계에서 찾은 $ref 값과 일치하는 중첩 속성을 찾습니다. Copilot Studio 토픽의 출력 변수의 이름과 유형을 기록해 보세요. 다음 단계에서 사용하게 됩니다.

이 예에서, Copilot Studio 토픽는 문자열 유형의 두 가지 출력, pva_State 와 pva_Item을 반환합니다.
닫기를 선택합니다.
활동 섹션에서 코드 표시 옵션을 선택합니다.
다음 코드를 입력하거나 붙여넣습니다. TOPIC_ACTIVITY_NAME을(를) 토픽의 이벤트 활동 이름으로 바꿉니다. name 속성에 따옴표가 없어야 합니다.
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```
코드 영역에서 Property 를 Composer 변수로 설정하여 Copilot Studio 기술 토픽.에서 출력 값을 수신하고 저장합니다.
Composer 제작 캔버스에서 추가를 선택하고 속성 관리를 선택한 다음 속성 설정을 선택합니다.
속성을 추출된 값을 저장해야 하는 Composer 값으로 설정합니다. 그런 다음 값을 토픽의 출력을 저장한 Composer 변수로 설정합니다.

이 예에서 dialog.skillResult.pvaState 와 dialog.skillResult.pvaItem 의 출력 값은 새로운 Composer 변수인 dialog.State 와 dialog.Item으로 추출됩니다.

기술로 클래식 챗봇을 테스트해보세요. Bot Framework 봇

Bot Framework 에뮬레이터 를 사용하여 Bot Framework 봇가 클래식 챗봇을 기술로 제대로 호출하는지 테스트하세요.

중요

기술 연결이 작동하려면 Bot Framework 봇를 클래식 챗봇의 허용 목록에 추가해야 합니다.

다음을 통해 공유