BeginSkill class
Начните навык.
- Extends
-
SkillDialog
Конструкторы
| Begin |
Создает новый экземпляр BeginSkillDialog. |
Свойства
| $kind | |
| activity | Шаблон действия. |
| activity |
Значение, указывающее, должен ли новый диалог обрабатывать действие. |
| allow |
Политика прерывания. |
| bot |
Идентификатор приложения Майкрософт, который будет вызывать навык. |
| connection |
Необязательный. Имя подключения OAuth для родительского бота. |
| disabled | Необязательное выражение, которое, если имеет значение true, отключит это действие. |
| result |
Необязательный путь к свойству для хранения диалогового окна. |
| skill |
Идентификатор приложения Майкрософт для навыка. |
| skill |
Конечная точка |
| skill |
URL-адрес обратного вызова для узла навыка. |
Унаследованные свойства
| End |
Возвращает результат конца по умолчанию. |
| id | |
| telemetry |
Методы
| begin |
Вызывается при запуске диалогового окна |
| continue |
Вызывается, когда диалогового окна |
| end |
Вызывается, когда заканчивается диалоговое окно |
| get |
|
| reprompt |
Вызывается, когда диалоговое окно должно повторно запрашивать ввод пользователем. |
| resume |
Вызывается, когда дочерний диалог завершил свою очередь, возвращая элемент управления в это диалоговое окно. |
Наследуемые методы
| configure(Record<string, unknown>) | Метод Fluent для настройки объекта. |
| get |
Кодированная строка, используемая для обнаружения изменений бота при повторном развертывании. |
| on |
Вызывается при возникновении события, используя |
Сведения о конструкторе
BeginSkill(SkillDialogOptions)
Создает новый экземпляр BeginSkillDialog.
new BeginSkill(options?: SkillDialogOptions)
Параметры
- options
-
SkillDialogOptions
Необязательные параметры, используемые для настройки диалогового окна навыка.
Сведения о свойстве
$kind
static $kind: string
Значение свойства
string
activity
Шаблон действия.
activity: TemplateInterface<Partial<Activity>, DialogStateManager>
Значение свойства
TemplateInterface<Partial<Activity>, DialogStateManager>
activityProcessed
Значение, указывающее, должен ли новый диалог обрабатывать действие.
activityProcessed: BoolExpression
Значение свойства
BoolExpression
Комментарии
Значение по умолчанию для этого будет true, что означает, что новое диалоговое окно не должно рассматривать действие. Для этого можно задать значение false, чтобы отправить действие в новое диалоговое окно.
allowInterruptions
Политика прерывания.
allowInterruptions: BoolExpression
Значение свойства
BoolExpression
botId
Идентификатор приложения Майкрософт, который будет вызывать навык.
botId: StringExpression
Значение свойства
StringExpression
Комментарии
Отложите значение =settings.MicrosoftAppId, которое извлекает идентификатор ботов из параметров.
connectionName
Необязательный. Имя подключения OAuth для родительского бота.
connectionName: StringExpression
Значение свойства
StringExpression
disabled
Необязательное выражение, которое, если имеет значение true, отключит это действие.
disabled?: BoolExpression
Значение свойства
BoolExpression
resultProperty
Необязательный путь к свойству для хранения диалогового окна.
resultProperty?: StringExpression
Значение свойства
StringExpression
skillAppId
Идентификатор приложения Майкрософт для навыка.
skillAppId: StringExpression
Значение свойства
StringExpression
skillEndpoint
Конечная точка /api/messages для навыка.
skillEndpoint: StringExpression
Значение свойства
StringExpression
skillHostEndpoint
URL-адрес обратного вызова для узла навыка.
skillHostEndpoint: StringExpression
Значение свойства
StringExpression
Комментарии
Отложите значение =settings.SkillHostEndpoint, которое извлекает конечную точку из параметров.
Сведения об унаследованном свойстве
EndOfTurn
Возвращает результат конца по умолчанию.
static EndOfTurn: DialogTurnResult
Значение свойства
DialogTurnResult
Комментарии
Этот результат указывает, что диалоговое окно (или логический шаг в диалоговом окне) завершило обработку текущего шага, по-прежнему активно и ожидает дополнительных входных данных.
унаследован от диалогового окна.EndOfTurn
id
id: string
Значение свойства
string
унаследован от Dialog.id
telemetryClient
telemetryClient: BotTelemetryClient
Значение свойства
BotTelemetryClient
наследуется от Dialog.telemetryClient
Сведения о методе
beginDialog(DialogContext, BeginSkillDialogOptions)
Вызывается при запуске диалогового окна
function beginDialog(dc: DialogContext, options?: BeginSkillDialogOptions): Promise<DialogTurnResult>
Параметры
- dc
-
DialogContext
DialogContext для текущей очереди беседы.
- options
-
BeginSkillDialogOptions
Необязательный. Начальные сведения для передачи в диалоговое окно.
Возвращаемое значение
Promise<DialogTurnResult>
Promise, представляющий асинхронную операцию.
continueDialog(DialogContext)
Вызывается, когда диалогового окна
function continueDialog(dc: DialogContext): Promise<DialogTurnResult>
Параметры
- dc
-
DialogContext
DialogContext для текущей очереди беседы.
Возвращаемое значение
Promise<DialogTurnResult>
Promise, представляющий асинхронную операцию.
endDialog(TurnContext, DialogInstance, DialogReason)
Вызывается, когда заканчивается диалоговое окно
function endDialog(turnContext: TurnContext, instance: DialogInstance, reason: DialogReason): Promise<void>
Параметры
- turnContext
-
TurnContext
(xref:botbuilder-core. TurnContext), объект контекста для этого поворота.
- instance
-
DialogInstance
(xref:botbuilder-dialogs. DialogInstance), сведения о состоянии, связанные с экземпляром этого диалогового окна в стеке диалогов.
- reason
-
DialogReason
(xref:botbuilder-dialogs. DialogReason), причина окончания диалога.
Возвращаемое значение
Promise<void>
Promise, представляющий асинхронную операцию.
getConverter(Object)
function getConverter(property: Object): Converter | ConverterFactory
Параметры
- property
-
Object
Ключ конфигурации условного селектора.
Возвращаемое значение
Converter | ConverterFactory
Преобразователь конфигурации селектора.
repromptDialog(TurnContext, DialogInstance)
Вызывается, когда диалоговое окно должно повторно запрашивать ввод пользователем.
function repromptDialog(turnContext: TurnContext, instance: DialogInstance): Promise<void>
Параметры
- turnContext
-
TurnContext
(xref:botbuilder-core. TurnContext), объект контекста для этого поворота.
- instance
-
DialogInstance
(xref:botbuilder-dialogs. DialogInstance), сведения о состоянии для этого диалогового окна.
Возвращаемое значение
Promise<void>
Promise, представляющий асинхронную операцию.
resumeDialog(DialogContext, DialogReason, any)
Вызывается, когда дочерний диалог завершил свою очередь, возвращая элемент управления в это диалоговое окно.
function resumeDialog(dc: DialogContext, reason: DialogReason, result?: any): Promise<DialogTurnResult<any>>
Параметры
- dc
-
DialogContext
DialogContext для текущей очереди беседы.
- reason
-
DialogReason
(xref:botbuilder-dialogs. DialogReason), причина возобновления диалога.
- result
-
any
Необязательный. Значение, возвращаемое из вызываемого диалогового окна. Тип возвращаемого значения зависит от дочернего диалогового окна.
Возвращаемое значение
Promise<DialogTurnResult<any>>
Promise, представляющий асинхронную операцию.
Сведения о наследуемом методе
configure(Record<string, unknown>)
Метод Fluent для настройки объекта.
function configure(config: Record<string, unknown>): this
Параметры
- config
-
Record<string, unknown>
Параметры конфигурации для применения.
Возвращаемое значение
this
После завершения операции настраиваемый.
наследуется от Configurable.configure
getVersion()
Кодированная строка, используемая для обнаружения изменений бота при повторном развертывании.
function getVersion(): string
Возвращаемое значение
string
Уникальная строка, которая должна изменяться только при изменении диалогового окна таким образом, чтобы перезапустить диалоговое окно.
Комментарии
По умолчанию возвращается диалоговое окно идентификатор, но его можно переопределить, чтобы обеспечить более точную логику обнаружения изменений. Любое диалоговое окно в стеке с изменением версии приведет к возникновению события versionChanged. Если это событие не обрабатывается ботом, возникает ошибка, в результате чего выполняется логика обработчика ошибок ботов.
Возврат пустой строки отключит отслеживание версий для компонента вместе.
унаследован от Dialog.getVersion
onDialogEvent(DialogContext, DialogEvent)
Вызывается при возникновении события, используя DialogContext.emitEvent(), текущим диалогом или диалогом, запущенным текущим диалогом.
function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>
Параметры
- dc
-
DialogContext
Контекст диалогового окна для текущей очереди беседы.
- e
-
DialogEvent
Возникает событие.
Возвращаемое значение
Promise<boolean>
Значение True, если событие обрабатывается текущим диалогом, а пузырьк должен остановиться.
унаследован от диалогового окна.onDialogEvent