TurnContext class

Создает новый экземпляр класса TurnContext .

new TurnContext(adapterOrContext: BotAdapter, request: Partial<Activity>)

Параметры

Создает новый экземпляр класса TurnContext .

new TurnContext(adapterOrContext: TurnContext)

Параметры

Возвращает действие, связанное с этим поворотом.

Activity activity

Значение свойства

Действие, связанное с этим поворотом.

Комментарии

В этом примере показано, как получить обрезанные пользователями речевые фрагменты из действия:

const utterance = (context.activity.text || '').trim();

Возвращает адаптер бота, создавший этот объект контекста.

BotAdapter adapter

Значение свойства

Адаптер бота, создавший этот объект контекста.

Список действий, отправляемых при context.activity.deliveryMode == 'expectReplies'.

bufferedReplyActivities: Partial<Activity>[]

Значение свойства

Возвращает языковой стандарт, хранящийся в параметре turnState. Задает языковой стандарт, хранящийся в turnState.

string | undefined locale

Значение свойства

Языковой стандарт, хранящийся в параметре turnState.

Указывает, ответил ли бот пользователю на этот шаг. Задает флаг ответа в контексте текущего шага.

boolean responded

Значение свойства

Значение true, если для текущего поворота был отправлен хотя бы один ответ; в противном случае — false.

Комментарии

Значение true , если для текущего поворота был отправлен хотя бы один ответ; в противном случае — false. Используйте его, чтобы определить, требуется ли боту выполнять откатную логику после другой обычной обработки.

Действия трассировки не устанавливают этот флаг.

Например:

await routeActivity(context);
if (!context.responded) {
   await context.sendActivity(`I'm sorry. I didn't understand.`);
}

Возвращает службы, зарегистрированные в этом объекте контекста.

TurnContextStateCollection turnState

Значение свойства

Службы, зарегистрированные в этом объекте контекста.

Комментарии

ПО промежуточного слоя, другие компоненты и службы обычно используют это для кэширования сведений, которые бот может запрашивать несколько раз во время выполнения. Этот кэш можно использовать для передачи информации между компонентами бота.

Пример:

const cartKey = Symbol();
const cart = await loadUsersShoppingCart(context);
context.turnState.set(cartKey, cart);

Обновления действие со сведениями о доставке из существующей ссылки на беседу.

static function applyConversationReference(activity: Partial<Activity>, reference: Partial<ConversationReference>, isIncoming?: boolean): Partial<Activity>

Параметры

Возвращаемое значение

Это действие, дополненное сведениями о доставке.

Комментарии

Вызовите метод getConversationReference для входящего действия, чтобы получить ссылку на беседу, которую затем можно использовать для обновления исходящего действия с правильными сведениями о доставке.

Асинхронно удаляет ранее отправленное действие.

function deleteActivity(idOrReference: string | Partial<ConversationReference>): Promise<void>

Параметры

Возвращаемое значение

Обещание, представляющее асинхронную операцию.

Комментарии

Если указан идентификатор, ссылка на беседу для текущего запроса используется для получения остальных необходимых сведений.

Например:

const matched = /approve (.*)/i.exec(context.activity.text);
if (matched) {
   const savedId = await approveExpenseReport(matched[1]);
   await context.deleteActivity(savedId);
}

См. также:

• sendActivity
• updateActivity
• getReplyConversationReference

Копирует справочные сведения о беседе из действия.

static function getConversationReference(activity: Partial<Activity>): Partial<ConversationReference>

Параметры

Возвращаемое значение

Ссылка на беседу для беседы, содержащей это действие.

Комментарии

Вы можете сохранить ссылку на беседу как объект JSON и использовать ее позже для упреждающего сообщения пользователю.

Например:

const reference = TurnContext.getConversationReference(context.request);

См. также:

• BotAdapter.continueConversation

Возвращает все сущности с упоминанием, включенные в действие.

static function getMentions(activity: Partial<Activity>): Mention[]

Параметры

Возвращаемое значение

Все упоминаемые сущности, включенные в действие.

Комментарии

Свойство сущностей действия содержит плоский список объектов метаданных, относящихся к этому действию, и может содержать сущности упоминания . Этот метод возвращает все такие сущности для заданного действия.

Например:

const mentions = TurnContext.getMentions(turnContext.request);

Копирует справочные сведения о беседе из ответа ресурса для отправленного действия.

static function getReplyConversationReference(activity: Partial<Activity>, reply: ResourceResponse): Partial<ConversationReference>

Параметры

Возвращаемое значение

Объект ConversationReference, который можно сохранить и использовать позже для удаления или обновления действия.

Комментарии

Вы можете сохранить ссылку на беседу как объект JSON и использовать ее позже для обновления или удаления сообщения.

Например:

var reply = await context.sendActivity('Hi');
var reference = TurnContext.getReplyConversationReference(context.activity, reply);

См. также:

• deleteActivity
• updateActivity

Добавляет обработчик ответа для операций удаления.

function onDeleteActivity(handler: DeleteActivityHandler): this

Параметры

Возвращаемое значение

Обновленный объект контекста.

Комментарии

Этот метод возвращает ссылку на объект контекста поворота.

При вызове метода deleteActivity зарегистрированные обработчики вызываются в том порядке, в котором они были добавлены в объект контекста перед удалением действия.

В этом примере показано, как прослушивать удаление действий и ведения журнала.

context.onDeleteActivity(async (ctx, reference, next) => {
   // Delete activity
   await next();

   // Log delete
   logDelete(activity);
});

Добавляет обработчик ответа для операций отправки действий.

function onSendActivities(handler: SendActivitiesHandler): this

Параметры

Возвращаемое значение

Обновленный объект контекста.

Комментарии

Этот метод возвращает ссылку на объект контекста поворота.

При вызове метода sendActivity или sendActivities зарегистрированные обработчики вызываются в том порядке, в котором они были добавлены в объект контекста перед отправкой действий.

В этом примере показано, как прослушивать и регистрировать исходящие message действия.

context.onSendActivities(async (ctx, activities, next) => {
   // Log activities before sending them.
   activities.filter(a => a.type === 'message').forEach(a => logSend(a));

   // Allow the send process to continue.
   next();
});

Добавляет обработчик ответа для операций обновления.

function onUpdateActivity(handler: UpdateActivityHandler): this

Параметры

Возвращаемое значение

Обновленный объект контекста.

Комментарии

Этот метод возвращает ссылку на объект контекста поворота.

При вызове метода updateActivity зарегистрированные обработчики вызываются в том порядке, в котором они были добавлены в объект контекста перед обновлением действия.

В этом примере показано, как прослушивать и регистрировать обновления действий.

context.onUpdateActivity(async (ctx, activity, next) => {
   // Replace activity
   await next();

   // Log update
   logUpdate(activity);
});

Удаляет упоминания для заданного идентификатора из текста действия и возвращает обновленный текст. Использовать с осторожностью; Эта функция изменяет текстовое свойство действия.

static function removeMentionText(activity: Partial<Activity>, id: string): string

Параметры

Возвращаемое значение

Текст обновленного действия.

Комментарии

Некоторые каналы, например Microsoft Teams, добавляют упоминания в текст действия сообщения.

Используйте этот вспомогательный метод для изменения текстового свойства действия. Он удаляет все упоминания для заданного бота или идентификатора пользователя, а затем возвращает обновленное значение свойства.

Например, при удалении упоминаний echoBot из действия, содержащего текст "@echoBot Hi Bot", текст действия обновляется, а метод возвращает "Hi Bot".

Формат сущности упоминания зависит от канала. Однако свойство text упоминания должно содержать точный текст для пользователя, который отображается в тексте действия.

Например, независимо от того, использует ли канал "имя пользователя" или "@username", эта строка находится в тексте действия, и этот метод удалит все вхождения этой строки из текста.

Например:

const updatedText = TurnContext.removeMentionText(activity, activity.recipient.id);

См. также:

• removeRecipientMention

Удаляет упоминания получателя действия из текста действия и возвращает обновленный текст. Использовать с осторожностью; Эта функция изменяет текстовое свойство действия.

static function removeRecipientMention(activity: Partial<Activity>): string

Параметры

Возвращаемое значение

Текст обновленного действия.

Комментарии

Некоторые каналы, например Microsoft Teams, добавляют сведения об упоминании в текст действия сообщения.

Используйте этот вспомогательный метод для изменения текстового свойства действия. Он удаляет все при упоминаниях получателя действия, а затем возвращает обновленное значение свойства.

Например:

const updatedText = TurnContext.removeRecipientMention(turnContext.request);

См. также:

• removeMentionText

Асинхронно отправляет набор действий отправителю входящего действия.

function sendActivities(activities: Partial<Activity>[]): Promise<ResourceResponse[]>

Параметры

Возвращаемое значение

Обещание с ResourceResponse.

Комментарии

Если действия успешно отправлены, получается массив объектов ResourceResponse , содержащий идентификаторы, назначенные получающим каналом действиям.

Перед отправкой сведения о доставке каждого исходящего действия обновляются на основе сведений о доставке входящего действия.

Например:

await context.sendActivities([
   { type: 'typing' },
   { type: 'delay', value: 2000 },
   { type: 'message', text: 'Hello... How are you?' }
]);

См. также:

• sendActivity
• updateActivity
• deleteActivity

Асинхронно отправляет действие отправителю входящего действия.

function sendActivity(activityOrText: string | Partial<Activity>, speak?: string, inputHint?: string): Promise<ResourceResponse | undefined>

Параметры

Возвращаемое значение

Обещание с ResourceResponse.

Комментарии

Если действие успешно отправлено, в результате получается объект ResourceResponse , содержащий идентификатор, назначенный принимающему каналу для действия.

Ограничения, накладываемые на содержимое параметра activityOrText , см. в документации канала.

Чтобы управлять различными характеристиками речи бота, такими как голос, скорость, громкость, произношение и шаг, укажите язык речи в формате SSML.

Например:

await context.sendActivity(`Hello World`);

См. также:

• SendActivities
• updateActivity
• deleteActivity

Асинхронно отправляет действие отправителю входящего действия.

function sendTraceActivity(name: string, value?: any, valueType?: string, label?: string): Promise<ResourceResponse | undefined>

Параметры

Возвращаемое значение

Обещание с ResourceResponse.

Комментарии

Создает и отправляет действие трассировки. Действия трассировки отправляются только в том случае, если каналом является эмулятор.

Например:

await context.sendTraceActivity(`The following exception was thrown ${msg}`);

См. также:

• SendActivities

Асинхронно обновляет ранее отправленное действие.

function updateActivity(activity: Partial<Activity>): Promise<ResourceResponse | void>

Параметры

Возвращаемое значение

Обещание с ResourceResponse.

Комментарии

Идентификатор действия замены указывает действие в беседе, которое нужно заменить.

Например:

const matched = /approve (.*)/i.exec(context.activity.text);
if (matched) {
   const update = await approveExpenseReport(matched[1]);
   await context.updateActivity(update);
}

См. также:

• sendActivity
• deleteActivity
• getReplyConversationReference