AdaptiveDialog class
적응형 대화는 이벤트 및 이벤트를 사용하여 대화를 모델로 하여 변화하는 대화 흐름에 동적으로 적응합니다.
- Extends
-
DialogContainer<O>
생성자
| Adaptive |
새 |
속성
| $kind | |
| auto |
실행할 작업이 없을 때 대화 상자를 종료할지 여부입니다. |
| condition |
|
| default |
더 이상 작업 및 |
| generator | 선택적. 언어 생성기를 재정의합니다. |
| recognizer | 선택적. 메시지 발화를 분석하는 데 사용되는 인식기입니다. |
| schema | 대화 상자의 JSON 스키마를 설정합니다. 대화 상자의 JSON 스키마를 가져옵니다. |
| selector | 선택적. 실행할 수 있는 이벤트를 선택하기 위한 선택기입니다. |
| triggers | 실행 계획을 수정하는 조건에 응답하도록 처리기를 트리거합니다. |
상속된 속성
| dialogs | 컨테이너 대화 상자 집합입니다. |
| End |
기본 턴 종료 결과를 가져옵니다. |
| id | |
| telemetry |
메서드
| begin |
대화 상자가 시작되고 대화 스택으로 푸시될 때 호출됩니다. |
| continue |
대화 상자가 활성 대화이고 사용자가 새 활동으로 회신하는계속되면 호출됩니다. |
| create |
지정된 컨텍스트에 대한 자식 DialogContext 만듭니다. |
| end |
대화 상자가 끝날 때 호출됩니다. |
| get |
|
| get |
대화 열거형 종속성을 가져옵니다. |
| reprompt |
사용자를 다시 프롬프트합니다. |
| resume |
자식 대화 상자가 턴을 완료하면 호출되어 이 대화 상자로 컨트롤을 반환합니다. |
상속된 메서드
| configure(Record<string, unknown>) | 개체를 구성하기 위한 Fluent 메서드입니다. |
| find |
이전에 컨테이너에 추가된 자식 대화 상자를 찾습니다. |
| get |
다시 배포할 때 봇 변경 내용을 검색하는 데 사용되는 인코딩된 문자열입니다. |
| on |
현재 대화 상자 또는 현재 대화 상자가 시작된 대화 상자에서 |
생성자 세부 정보
AdaptiveDialog(string)
새 AdaptiveDialog 인스턴스를 만듭니다.
new AdaptiveDialog(dialogId?: string)매개 변수
- dialogId
-
string
(선택 사항) 부모 대화 상자 집합 내 구성 요소의 고유 ID입니다.
속성 세부 정보
$kind
static $kind: string속성 값
string
autoEndDialog
실행할 작업이 없을 때 대화 상자를 종료할지 여부입니다.
autoEndDialog: BoolExpression속성 값
BoolExpression
설명
true이면 실행할 작업이 없으면 현재 대화 상자가 종료됩니다. false이면 실행할 작업이 없으면 현재 대화 상자가 단순히 턴을 종료하고 활성 상태가 됩니다. 기본값은 true입니다.
conditionTracker
static conditionTracker: string속성 값
string
defaultResultProperty
더 이상 작업 및 AutoEndDialog = true없을 때 대화 상자가 종료될 때 결과로 반환할 속성입니다.
defaultResultProperty: string속성 값
string
설명
기본값은 dialog.result.
generator
recognizer
선택적. 메시지 발화를 분석하는 데 사용되는 인식기입니다.
recognizer?: Recognizer속성 값
Recognizer
schema
대화 상자의 JSON 스키마를 설정합니다. 대화 상자의 JSON 스키마를 가져옵니다.
object schema속성 값
object
대화 상자 스키마입니다.
selector
triggers
상속된 속성 세부 정보
dialogs
컨테이너 대화 상자 집합입니다.
dialogs: DialogSet속성 값
DialogSet
DialogContainer.dialogs에서 상속된
EndOfTurn
기본 턴 종료 결과를 가져옵니다.
static EndOfTurn: DialogTurnResult속성 값
DialogTurnResult
설명
이 결과는 대화 상자(또는 대화 상자 내의 논리적 단계)가 현재 턴에 대한 처리를 완료했으며 여전히 활성 상태이며 더 많은 입력을 기다리고 있음을 나타냅니다.
dialog.EndOfTurn에서 상속된
id
id: string속성 값
string
Dialog.id 상속된
telemetryClient
telemetryClient: BotTelemetryClient속성 값
BotTelemetryClient
DialogContainer.telemetryClient에서 상속된
메서드 세부 정보
beginDialog(DialogContext, O)
대화 상자가 시작되고 대화 스택으로 푸시될 때 호출됩니다.
function beginDialog(dc: DialogContext, options?: O): Promise<DialogTurnResult>매개 변수
- dc
-
DialogContext
현재 대화 전환에 대한 DialogContext.
- options
-
O
대화 상자에 전달할 선택적 초기 정보입니다.
반환
Promise<DialogTurnResult>
비동기 작업을 나타내는 Promise입니다.
continueDialog(DialogContext)
대화 상자가 활성 대화이고 사용자가 새 활동으로 회신하는계속되면 호출됩니다.
function continueDialog(dc: DialogContext): Promise<DialogTurnResult>매개 변수
- dc
-
DialogContext
현재 대화 전환에 대한 DialogContext.
반환
Promise<DialogTurnResult>
비동기 작업을 나타내는 Promise입니다.
createChildContext(DialogContext)
지정된 컨텍스트에 대한 자식 DialogContext 만듭니다.
function createChildContext(dc: DialogContext): DialogContext매개 변수
- dc
-
DialogContext
현재 대화 전환에 대한 DialogContext.
반환
DialogContext
지정된 컨텍스트에 대해 AdaptiveDialogState.actions 없는 경우 자식 DialogContext 또는 null입니다.
endDialog(TurnContext, DialogInstance, DialogReason)
대화 상자가 끝날 때 호출됩니다.
function endDialog(turnContext: TurnContext, instance: DialogInstance, reason: DialogReason): Promise<void>매개 변수
- turnContext
-
TurnContext
이 턴의 컨텍스트 개체입니다.
- instance
-
DialogInstance
대화 상자 스택에서 이 대화 상자의 인스턴스와 연결된 상태 정보입니다.
- reason
-
DialogReason
대화 상자가 종료된 이유입니다.
반환
Promise<void>
비동기 작업을 나타내는 Promise입니다.
getConverter(Object)
function getConverter(property: Object): Converter | ConverterFactory매개 변수
- property
-
Object
조건부 선택기 구성의 키입니다.
반환
Converter | ConverterFactory
선택기 구성의 변환기입니다.
getDependencies()
대화 열거형 종속성을 가져옵니다.
function getDependencies(): Dialog[]반환
Dialog[]
(xref:botbuilder-dialogs. Dialog)의 열거형 종속성입니다.
repromptDialog(DialogContext | TurnContext, DialogInstance)
사용자를 다시 프롬프트합니다.
function repromptDialog(context: DialogContext | TurnContext, instance: DialogInstance): Promise<void>매개 변수
- context
-
DialogContext | TurnContext
순서에 대한 컨텍스트 개체입니다.
- instance
-
DialogInstance
이 대화 상자의 현재 상태 정보입니다.
반환
Promise<void>
비동기 작업을 나타내는 Promise입니다.
resumeDialog(DialogContext, DialogReason, any)
자식 대화 상자가 턴을 완료하면 호출되어 이 대화 상자로 컨트롤을 반환합니다.
function resumeDialog(dc: DialogContext, _reason?: DialogReason, _result?: any): Promise<DialogTurnResult>매개 변수
- dc
-
DialogContext
대화의 현재 전환에 대한 대화 컨텍스트입니다.
- _reason
-
DialogReason
대화 상자가 다시 시작된 이유입니다.
- _result
-
any
선택 사항으로, 호출된 대화 상자에서 반환된 값입니다. 반환되는 값의 형식은 자식 대화 상자에 따라 달라집니다.
반환
Promise<DialogTurnResult>
비동기 작업을 나타내는 Promise입니다.
상속된 메서드 세부 정보
configure(Record<string, unknown>)
개체를 구성하기 위한 Fluent 메서드입니다.
function configure(config: Record<string, unknown>): this매개 변수
- config
-
Record<string, unknown>
적용할 구성 설정입니다.
반환
this
작업이 완료된 후 구성 가능한.
Configurable.configure에서 상속된
findDialog(string)
이전에 컨테이너에 추가된 자식 대화 상자를 찾습니다.
function findDialog(dialogId: string): Dialog | undefined매개 변수
- dialogId
-
string
조회할 대화 상자의 ID입니다.
반환
Dialog | undefined
대화 상자(있는 경우)입니다. 그렇지 않으면 null입니다.
DialogContainer.findDialog에서 상속된
getVersion()
다시 배포할 때 봇 변경 내용을 검색하는 데 사용되는 인코딩된 문자열입니다.
function getVersion(): string반환
string
대화 상자를 다시 시작해야 하는 방식으로 대화 상자가 변경된 경우에만 변경해야 하는 고유 문자열입니다.
설명
기본적으로 id 대화 상자를 반환하지만 보다 정확한 변경 검색 논리를 제공하도록 재정의할 수 있습니다. 스택의 버전이 변경된 대화 상자는 versionChanged 이벤트가 발생합니다. 이 이벤트가 봇에서 처리되지 않으면 오류가 throw되어 봇 오류 처리기 논리가 실행됩니다.
빈 문자열을 반환하면 구성 요소에 대한 버전 추적이 모두 함께 사용하지 않도록 설정됩니다.
Dialog.getVersion에서 상속된
onDialogEvent(DialogContext, DialogEvent)
현재 대화 상자 또는 현재 대화 상자가 시작된 대화 상자에서 DialogContext.emitEvent()사용하여 이벤트가 발생할 때 호출됩니다.
function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>매개 변수
- dc
-
DialogContext
현재 대화 전환에 대한 대화 컨텍스트입니다.
- e
-
DialogEvent
발생 중인 이벤트입니다.
반환
Promise<boolean>
True이면 현재 대화 상자에서 이벤트를 처리하고 버블링을 중지해야 합니다.
DialogContainer.onDialogEvent에서 상속된