봇 등록 설정 구성
적용 대상: SDK v4
표시 이름, 아이콘 및 설명과 같은 Azure Bot 리소스 설정은 봇 프로필 창에서 보고 수정할 수 있습니다. 메시징 엔드포인트, Microsoft 앱 ID 및 Application Insights와 같은 Azure Bot 리소스 설정은 구성 창에서 보고 수정할 수 있습니다.
봇 프로필
다음은 봇 프로필 필드 목록입니다.
| 필드 | 설명 |
|---|---|
| 아이콘 | 채널에서 봇을 시각적으로 식별하고 Microsoft Teams 또는 기타 서비스에서 봇의 아이콘으로 식별하는 사용자 지정 아이콘입니다. |
| 표시 이름 | 채널 및 디렉터리에서 봇의 이름입니다. 나중에 이 값을 변경할 수 있습니다. |
| 봇 핸들 | 봇에 대한 고유 식별자입니다. Bot Service를 사용하여 봇을 만든 후에는 이 값을 변경할 수 없습니다. |
| 설명 | 봇에 대한 설명입니다. 일부 채널은 설명을 표시합니다. 나중에 이 값을 변경할 수 있습니다. |
변경 내용을 저장하려면 블레이드 아래쪽에서 적용을 선택합니다.
구성
다음은 구성 필드 목록입니다.
| 필드 | 설명 |
|---|---|
| 메시징 엔드포인트 | 봇과 통신할 엔드포인트입니다. |
| Microsoft 앱 ID | 봇의 고유 식별자입니다. 이 값은 변경할 수 없습니다. 관리 링크를 클릭하여 새 암호를 생성할 수 있습니다. |
| 스키마 변환 버전 | 이 봇에 사용할 봇 스키마 변환 버전입니다. 자세한 내용은 채널에 봇 커넥트 참조하세요. |
| Application Insights 계측 키 | 봇 원격 분석에 대한 고유 키입니다. 이 봇에 대한 봇 원격 분석을 수신하려면 Azure Application Insights 키를 이 필드에 복사합니다. 이 값은 선택 사항입니다. 이 필드에 대한 자세한 내용은 Application Insights 키를 참조하세요. |
| Application Insights API 키 | 봇 분석을 위한 고유 키입니다. 대시보드에서 봇에 대한 분석을 보려면 Azure 애플리케이션 Insights API 키를 이 필드에 복사합니다. 이 값은 선택 사항입니다. 이 필드에 대한 자세한 내용은 Application Insights 키를 참조하세요. |
| Application Insights Application ID | 봇 분석에 대한 고유 ID입니다. 대시보드에서 봇에 대한 분석을 보려면 Azure Insights 애플리케이션 ID 키를 이 필드에 복사합니다. 이 값은 선택 사항입니다. 이 필드에 대한 자세한 내용은 Application Insights 키를 참조하세요. |
변경 내용을 저장하려면 블레이드 아래쪽에서 적용을 선택합니다.
봇 ID 정보
다음 단계에 따라 봇의 구성 파일에 ID 정보를 추가합니다. 파일은 봇을 만드는 데 사용하는 프로그래밍 언어에 따라 다릅니다.
Important
Java 버전의 Bot Framework SDK는 다중 테넌트 봇만 지원합니다. Bot Framework SDK의 Python 버전은 다중 테넌트 및 단일 테넌트 봇을 지원합니다. C# 및 JavaScript 버전은 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다.
| 언어 | 파일 이름 | 주의 |
|---|---|---|
| C# | appsettings.json | 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다. |
| JavaScript | .env | 봇의 ID를 관리하기 위한 세 가지 애플리케이션 유형을 모두 지원합니다. |
| Java | application.properties | 다중 테넌트 봇만 지원합니다. |
| Python | config.py | 다중 테넌트 및 단일 테넌트 봇을 지원합니다. 메서드 호출에 대한 인수 os.environ.get 로 속성을 제공합니다. |
추가해야 하는 ID 정보는 봇의 애플리케이션 유형에 따라 달라집니다. 구성 파일에 다음 값을 제공합니다.
C# 및 JavaScript 봇에만 사용할 수 있습니다.
| 속성 | 값 |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
사용자 할당 관리 ID의 클라이언트 ID입니다. |
MicrosoftAppPassword |
해당 없음. 사용자가 할당한 관리 ID 봇에 대해 이 값을 비워 둡니다. |
MicrosoftAppTenantId |
사용자 할당 관리 ID의 테넌트 ID입니다. |
추가 정보
az bot update를 사용하여 명령줄에서 봇 설정을 업데이트할 수 있습니다.