Создание виртуального помощника
Виртуальный помощник — это шаблон Майкрософт с открытым исходным кодом, позволяющий создать надежное диалоговое решение, сохраняя полный контроль над взаимодействием с пользователем, фирменной символикой организации и необходимыми данными. Базовый шаблон виртуального помощника представляет собой основной "строительный кубик", объединяющий технологии Майкрософт, необходимые для создания виртуального помощника, в том числе SDK Bot Framework, Распознавание речи (LUIS) и QnA Maker. Он также объединяет в себе основные возможности, включая регистрацию навыков, связанные учетные записи, базовое намерение общения, чтобы предложить пользователям целый ряд простых взаимодействий и взаимодействия. Кроме того, возможности шаблона включают в себя множество примеров многократно используемых навыков общения. Отдельные навыки интегрированы в виртуальный помощник, чтобы реализовать сразу несколько сценариев. С помощью пакета SDK Bot Framework навыки представлены в форме исходного кода, что позволяет настраивать и расширять их по мере необходимости. Дополнительные сведения о навыках, реализованных в Bot Framework, см. в разделе Что такое навык Bot Framework. В этом документе приведены рекомендации по реализации виртуальных помощников для организаций, описано создание специализированных виртуальных помощников для Teams, примеры программного кода и ограничения виртуальных помощников. На следующем рисунке показан обзор виртуального помощника:
Ядро виртуального помощника перенаправляет действия с текстовыми сообщениями привязанным навыкам по модели диспетчеризации.
Рекомендации по реализации
Решение о добавлении виртуального помощника строится на множестве факторов и отличается для каждой организации. Ниже приведены факторы, позволяющие принять решение о реализации виртуального помощника для вашей организации.
- Центральная группа управляет всем взаимодействием сотрудников. Она позволяет создавать новые виртуальные помощники и управлять обновлениями основного интерфейса, включая добавление новых навыков.
- В организации существует несколько бизнес-функций, у каждой из них несколько приложений, и ожидается, что их число в будущем увеличится.
- Существующие приложения принадлежат организации, их можно настраивать и преобразовать в навыки для виртуального помощника.
- Центральная группа по взаимодействию сотрудников может влиять на настройки существующих приложений. Она также предоставляет необходимые рекомендации по интеграции существующих приложений в качестве навыков в интерфейсы виртуального помощника.
На следующем рисунке показаны бизнес-функции виртуального помощника.
Создание специализированного виртуального помощника для Teams
Корпорация Майкрософт опубликовала шаблон Майкрософт для создания виртуальных помощников и навыков. С помощью шаблона можно создать виртуальный помощник на основе текста с поддержкой ограниченных форматированных карточек с действиями. Мы улучшили шаблон, включив возможности платформы Microsoft Teams и широкие возможности приложений Teams. Некоторые возможности включают поддержку многофункциональных адаптивных карточек, диалогов (называемых модулями задач в TeamsJS версии 1.x), команд или групповых чатов и расширений сообщений. Дополнительные сведения о расширении виртуального помощника для Microsoft Teams см. в документе: Руководство по расширению виртуального помощника для взаимодействия с Microsoft Teams. На следующем рисунке показана высокоуровневая схема решения виртуального помощника.
Добавление адаптивных карточек в виртуальный помощник
Чтобы правильно перенаправлять запросы, виртуальный помощник должен определить нужную модель LUIS и соответствующий навык, связанный с ней. Однако механизм диспетчеризации не может использоваться для действий с карточками, так как модель LUIS, связанная с навыком, обучается для текста действий с карточками. Текст действия карточки - это набор фиксированных, предопределенных ключевых слов, и пользователь не добавляет туда своих комментариев.
Этот пробел устраняется путем внедрения сведений о навыках в полезную нагрузку действия карточки. Каждый навык должен внедряться skillId в value поле действий с карточками. Обеспечьте наличие в каждом действии карточки соответствующих сведений о навыках, Виртуальный помощник использует эти сведения для диспетчеризации.
Необходимо указать skillId в конструкторе, чтобы гарантировать присутствие сведений о навыке в действиях карточки.
Пример программного кода данных действия карточки показан в следующем разделе:
public class CardActionData
{
public CardActionData(string skillId)
{
this.SkillId = skillId;
}
[JsonProperty("skillId")]
public string SkillId { get; set; }
}
...
var button = new CardAction
{
Type = ActionTypes.MessageBack,
Title = "Card action button",
Text = "card action button text",
Value = new CardActionData(<SkillId>),
};
Затем вводится класс SkillCardActionData в шаблоне виртуального помощника для извлечения skillId из полезной нагрузки действия карточки.
Фрагмент кода для извлечения skillId из полезных данных действия карточки показан в следующем разделе:
// Skill Card action data should contain skillId parameter
// This class is used to deserialize it and get skillId
public class SkillCardActionData
{
/// <summary>
/// Gets the ID of the skil that should handle this card
/// </summary>
[JsonProperty("skillId")]
public string SkillId { get; set; }
}
Реализация выполняется методом расширения в классе Activity.
Фрагмент кода для извлечения skillId из данных действия карточки показан в следующем разделе:
public static class ActivityExtensions
{
// Fetches skillId from CardAction data if present
public static string GetSkillId(this Activity activity)
{
string skillId = string.Empty;
try
{
if (activity.Type.Equals(ActivityTypes.Message) && activity.Value != null)
{
var data = JsonConvert.DeserializeObject<SkillCardActionData>(activity.Value.ToString());
skillId = data.SkillId;
}
else if (activity.Type.Equals(ActivityTypes.Invoke) && activity.Value != null)
{
var data = JsonConvert.DeserializeObject<SkillCardActionData>(JObject.Parse(activity.Value.ToString()).SelectToken("data").ToString());
skillId = data.SkillId;
}
}
catch
{
// If not able to retrive skillId, empty skillId should be returned
}
return skillId;
}
}
Обработка прерываний
Виртуальный помощник может обрабатывать прерывания в тех случаях, когда пользователь пытается вызвать навык, пока активен другой навык. Затем вводятся TeamsSkillDialog и TeamsSwitchSkillDialogна основе SkillDialog и SwitchSkillDialog платформы Bot Framework. Они позволяют пользователям переключать навыки между действиями с карточками. Для обработки этого запроса виртуальный помощник запросит у пользователя подтверждение для переключения навыков:
Обработка запросов диалога
Чтобы добавить возможности диалога в виртуальный помощник, в обработчик действий Виртуального помощника включены два дополнительных метода: OnTeamsTaskModuleFetchAsync и OnTeamsTaskModuleSubmitAsync. Эти методы прослушивают действия, связанные с диалогом, от Виртуального помощника, определяют навык, связанный с запросом, и перенаправляют запрос на указанный навык.
Переадресация запросов выполняется с помощью метода SkillHttpClient, PostActivityAsync. Он возвращает ответ в виде InvokeResponse, который анализируется и преобразуется в TaskModuleResponse .
public static TaskModuleResponse GetTaskModuleRespose(this InvokeResponse invokeResponse)
{
if (invokeResponse.Body != null)
{
return new TaskModuleResponse()
{
Task = GetTask(invokeResponse.Body),
};
}
return null;
}
private static TaskModuleResponseBase GetTask(object invokeResponseBody)
{
JObject resposeBody = (JObject)JToken.FromObject(invokeResponseBody);
var task = resposeBody.GetValue("task");
var taskType = task.SelectToken("type").ToString();
return taskType switch
{
"continue" => new TaskModuleContinueResponse()
{
Type = taskType,
Value = task.SelectToken("value").ToObject<TaskModuleTaskInfo>(),
},
"message" => new TaskModuleMessageResponse()
{
Type = taskType,
Value = task.SelectToken("value").ToString(),
},
_ => null,
};
}
Аналогичный подход применяется для отправки действий карточек и диалоговых ответов. Диалоговое окно выборки и отправки данных о действии обновляется, включив в них skillId.
Метод GetSkillId расширения действий извлекает из полезных skillId данных, которые предоставляют сведения о навыке, который необходимо вызвать.
Фрагмент кода для методов OnTeamsTaskModuleFetchAsync и OnTeamsTaskModuleSubmitAsync приведен в следующем разделе:
// Invoked when a "task/fetch" event is received to invoke dialog.
protected override async Task<TaskModuleResponse> OnTeamsTaskModuleFetchAsync(ITurnContext<IInvokeActivity> turnContext, TaskModuleRequest taskModuleRequest, CancellationToken cancellationToken)
{
try
{
string skillId = (turnContext.Activity as Activity).GetSkillId();
var skill = _skillsConfig.Skills.Where(s => s.Value.AppId == skillId).First().Value;
// Forward request to correct skill
var invokeResponse = await _skillHttpClient.PostActivityAsync(this._appId, skill, _skillsConfig.SkillHostEndpoint, turnContext.Activity as Activity, cancellationToken);
return invokeResponse.GetTaskModuleResponse();
}
catch (Exception exception)
{
await turnContext.SendActivityAsync(_templateEngine.GenerateActivityForLocale("ErrorMessage"));
_telemetryClient.TrackException(exception);
return null;
}
}
// Invoked when a 'task/submit' invoke activity is received for dialog submit actions.
protected override async Task<TaskModuleResponse> OnTeamsTaskModuleSubmitAsync(ITurnContext<IInvokeActivity> turnContext, TaskModuleRequest taskModuleRequest, CancellationToken cancellationToken)
{
try
{
string skillId = (turnContext.Activity as Activity).GetSkillId();
var skill = _skillsConfig.Skills.Where(s => s.Value.AppId == skillId).First().Value;
// Forward request to correct skill
var invokeResponse = await _skillHttpClient.PostActivityAsync(this._appId, skill, _skillsConfig.SkillHostEndpoint, turnContext.Activity as Activity, cancellationToken).ConfigureAwait(false);
return invokeResponse.GetTaskModuleRespose();
}
catch (Exception exception)
{
await turnContext.SendActivityAsync(_templateEngine.GenerateActivityForLocale("ErrorMessage"));
_telemetryClient.TrackException(exception);
return null;
}
}
Кроме того, необходимо включить все домены навыков в validDomains раздел в файле манифеста приложения Виртуального помощника, чтобы диалоги, вызываемые с помощью навыка, правильно отображались.
Обработка областей приложения для совместной работы
Приложения Teams могут существовать в нескольких областях, в том числе в приватных чатах, групповых чатах и каналах. Основной шаблон виртуального помощника предназначен для приватных чатов. В рамках процесса подключения виртуальный помощник запрашивает имя пользователя и сохраняет его состояние. Так как интерфейс подключения не подходит для областей группового чата или канала, он был удален.
Навыки должны обрабатывать действия в нескольких областях, таких как приватный чат, групповой чат и беседа в канале. Если какая-либо из этих областей не поддерживается, навыки должны отвечать соответствующим сообщением.
В ядро Виртуального помощника добавлены следующие функции обработки:
- Виртуальный помощник можно вызвать без текстовых сообщений из группового чата или канала.
- Артикуляции следует очистить перед отправкой сообщения в модуль диспетчеризации. Например, удалите необходимый @mention объект бота.
if (innerDc.Context.Activity.Conversation?.IsGroup == true)
{
// Remove bot atmentions for teams/groupchat scope
innerDc.Context.Activity.RemoveRecipientMention();
// If bot is invoked without any text, reply with FirstPromptMessage
if (string.IsNullOrWhiteSpace(innerDc.Context.Activity.Text))
{
await innerDc.Context.SendActivityAsync(_templateEngine.GenerateActivityForLocale("FirstPromptMessage"));
return EndOfTurn;
}
}
Обработка расширений для сообщений
Команды расширения для сообщений нужно объявить в файле манифеста приложения. Этими командами поддерживается пользовательский интерфейс расширения сообщений. Чтобы виртуальный помощник обрабатывал команду расширения для сообщений в качестве присоединенного навыка, собственный манифест виртуального помощника должен содержать эти команды. Необходимо добавить команды из манифеста отдельного навыка в манифест виртуального помощника. Идентификатор команды предоставляет сведения о привязанном навыке путем добавления идентификатора приложения навыка через разделитель :.
Фрагмент кода из файла манифеста навыка показан в следующем разделе:
"composeExtensions": [
{
"botId": "<Skil_App_Id>",
"commands": [
{
"id": "searchQuery",
"context": [ "compose", "commandBox" ],
"description": "Test command to run query",
....}
]
}
]
Соответствующий фрагмент программного кода из файла манифеста виртуального помощника показан в следующем разделе:
"composeExtensions": [
{
"botId": "<VA_App_Id>",
"commands": [
{
"id": "searchQuery:<skill_id>",
"context": [ "compose", "commandBox" ],
"description": "Test command to run query",
....}
]
}
]
После вызова команд пользователем виртуальный помощник может определить связанный навык, проанализировав идентификатор команды, обновить действие, удалив дополнительный суффикс :<skill_id> из идентификатора команды и перенаправив его в соответствующий навык. Обрабатывать дополнительный суффикс в коде, реализующем навык, не нужно. Таким образом, конфликта идентификаторов команд между навыками можно избежать. При таком подходе все команды поиска и действия навыка во всех контекстах, такие как compose, commandBox и message, реализуются на базе виртуального помощника.
const string MessagingExtensionCommandIdSeparator = ":";
// Invoked when a 'composeExtension/submitAction' invoke activity is received for a messaging extension action command
protected override async Task<MessagingExtensionActionResponse> OnTeamsMessagingExtensionSubmitActionAsync(ITurnContext<IInvokeActivity> turnContext, MessagingExtensionAction action, CancellationToken cancellationToken)
{
return await ForwardMessagingExtensionActionCommandActivityToSkill(turnContext, action, cancellationToken);
}
// Forwards invoke activity to right skill for messaging extension action commands.
private async Task<MessagingExtensionActionResponse> ForwardMessagingExtensionActionCommandActivityToSkill(ITurnContext<IInvokeActivity> turnContext, MessagingExtensionAction action, CancellationToken cancellationToken)
{
var skillId = ExtractSkillIdFromMessagingExtensionActionCommand(turnContext, action);
var skill = _skillsConfig.Skills.Where(s => s.Value.AppId == skillId).First().Value;
var invokeResponse = await _skillHttpClient.PostActivityAsync(this._appId, skill, _skillsConfig.SkillHostEndpoint, turnContext.Activity as Activity, cancellationToken).ConfigureAwait(false);
return invokeResponse.GetMessagingExtensionActionResponse();
}
// Extracts skill Id from messaging extension command and updates activity value
private string ExtractSkillIdFromMessagingExtensionActionCommand(ITurnContext<IInvokeActivity> turnContext, MessagingExtensionAction action)
{
var commandArray = action.CommandId.Split(MessagingExtensionCommandIdSeparator);
var skillId = commandArray.Last();
// Update activity value by removing skill id before forwarding to the skill.
var activityValue = JsonConvert.DeserializeObject<MessagingExtensionAction>(turnContext.Activity.Value.ToString());
activityValue.CommandId = string.Join(MessagingExtensionCommandIdSeparator, commandArray, 0 commandArray.Length - 1);
turnContext.Activity.Value = activityValue;
return skillId;
}
Некоторые действия расширения сообщений не включают идентификатор команды. Например, composeExtensions/selectItem содержит только значение вызова действия касания. Чтобы определить связанный навык, skillId прикрепляется к каждой карточке элемента при формировании ответа для OnTeamsMessagingExtensionQueryAsync. Этот подход аналогичен подходу к добавлению адаптивных карточек в виртуальный помощник.
// Invoked when a 'composeExtension/selectItem' invoke activity is received for compose extension query command.
protected override async Task<MessagingExtensionResponse> OnTeamsMessagingExtensionSelectItemAsync(ITurnContext<IInvokeActivity> turnContext, JObject query, CancellationToken cancellationToken)
{
var data = JsonConvert.DeserializeObject<SkillCardActionData>(query.ToString());
var skill = _skillsConfig.Skills.Where(s => s.Value.AppId == data.SkillId).First().Value;
var invokeResponse = await _skillHttpClient.PostActivityAsync(this._appId, skill, _skillsConfig.SkillHostEndpoint, turnContext.Activity as Activity, cancellationToken).ConfigureAwait(false);
return invokeResponse.GetMessagingExtensionResponse();
}
Пример
В следующем примере показано, как преобразовать шаблон приложения "Книга в комнату" в навык "Виртуальный помощник". Книга в комнате — это Teams, который позволяет пользователям быстро находить и резервировать комнату для собраний в течение 30, 60 или 90 минут, начиная с текущего времени. Длительность резервирования по умолчанию — 30 минут. Бот "Резервирование комнаты" действует в области личных или приватных бесед. На следующем рисунке показан виртуальный помощник с навыком Резервирование комнаты:
Ниже приведены разностные изменения, внесенные для преобразования его в навык, который присоединяется к виртуальному помощнику. Аналогичные шаги нужны для преобразования любого существующего бота версии 4 в навык.
Манифест навыка
Манифест навыка — это JSON-файл, предоставляющий параметры навыка: конечную точку обмена сообщениями, идентификатор, имя и другие соответствующие метаданные. Этот манифест отличается от манифеста, используемого для отправки пользовательских приложений в Teams. Виртуальному помощнику нуже путь к этому файлу в качестве входных данных для прикрепления навыка. Мы добавили следующий манифест в папку wwwroot бота.
botskills connect --remoteManifest "<url to skill's manifest>" ..
{
"$schema": "https://schemas.botframework.com/schemas/skills/skill-manifest-2.1.preview-0.json",
"$id": "microsoft_teams_apps_bookaroom",
"name": "microsoft-teams-apps-bookaroom",
"description": "microsoft-teams-apps-bookaroom description",
"publisherName": "Your Company",
"version": "1.1",
"iconUrl": "<icon url>",
"copyright": "Copyright (c) Microsoft Corporation. All rights reserved.",
"license": "",
"privacyUrl": "<privacy url>",
"endpoints": [
{
"name": "production",
"protocol": "BotFrameworkV3",
"description": "Production endpoint for the skill",
"endpointUrl": "<endpoint url>",
"msAppId": "skill app id"
}
],
"dispatchModels": {
"languages": {
"en-us": [
{
"id": "microsoft-teams-apps-bookaroom-en",
"name": "microsoft-teams-apps-bookaroom LU (English)",
"contentType": "application/lu",
"url": "file://book-a-meeting.lu",
"description": "English language model for the skill"
}
]
}
},
"activities": {
"message": {
"type": "message",
"description": "Receives the users utterance and attempts to resolve it using the skill's LU models"
}
}
}
Интеграция LUIS
Модель диспетчеризации виртуального помощника достраивается поверх моделей LUIS подключенных навыков. Модель диспетчеризации определяет намерение для каждого текстового действия и находит связанный с ним навык.
Виртуальному помощнику требуется модель LUIS навыка в формате .lu в качестве входного параметра при подключении навыка. JSON LUIS преобразуется в .lu формат с помощью инструмента botframework-cli.
botskills connect --remoteManifest "<url to skill's manifest>" --luisFolder "<path to the folder containing your Skill's .lu files>" --languages "en-us" --cs
npm i -g @microsoft/botframework-cli
bf luis:convert --in <pathToLUIS.json> --out <pathToLuFile>
Бот "Резервирование комнаты" имеет две основные команды для пользователей:
Book roomManage Favorites
Мы создали модель LUIS, осмыслив эти две команды. Соответствующие секреты должны быть заполнены в cognitivemodels.json. Соответствующий JSON-файл LUIS можно найти здесь.
Соответствующий файл .lu показан в следующем разделе:
> ! Automatically generated by [LUDown CLI](https://github.com/Microsoft/botbuilder-tools/tree/master/Ludown), Tue Mar 31 2020 17:30:32 GMT+0530 (India Standard Time)
> ! Source LUIS JSON file: book-a-meeting.json
> ! Source QnA TSV file: Not Specified
> ! Source QnA Alterations file: Not Specified
> # Intent definitions
## BOOK ROOM
- book a room
- book room
- please book a room
- reserve a room
- i want to book a room
- i want to book a room please
- get me a room please
- get me a room
## MANAGE FAVORITES
- manage favorites
- manage favorite
- please manage my favorite rooms
- manage my favorite rooms please
- manage my favorite rooms
- i want to manage my favorite rooms
## None
> # Entity definitions
> # PREBUILT Entity definitions
> # Phrase list definitions
> # List entities
> # RegEx entities
При таком подходе любая команда, выданная пользователем виртуальному помощнику и связанная с book room или manage favorites идентифицируется как команда, связанная с ботом Book-a-room, и перенаправляется в этот навык.
С другой стороны, Book-a-room room бот должен использовать модель LUIS, чтобы понять эти команды, если они не заполнены. Пример: I want to manage my favorite rooms.
Поддержка нескольких языков.
Например, создается модель LUIS только с английским языком и региональными параметрами. Вы можете создать модели LUIS, соответствующие другим языкам, и добавить запись в cognitivemodels.json.
{
"defaultLocale": "en-us",
"languageModels": {
"en-us": {
"luisAppId": "",
"luisApiKey": "",
"luisApiHost": ""
},
"<your_language_culture>": {
"luisAppId": "",
"luisApiKey": "",
"luisApiHost": ""
}
}
}
Параллельно добавьте соответствующий файл .lu в путь luisFolder. Структура папок должна выглядеть следующим образом:
| - luisFolder
| - en-us
| - book-a-meeting.lu
| - your_language_culture
| - book-a-meeting.lu
Чтобы изменить languages параметр, обновите команду навыков бота следующим образом:
botskills connect --remoteManifest "<url to skill's manifest>" --luisFolder "<path to luisFolder>" --languages "en-us, your_language_culture" --cs
Виртуальный помощник использует SetLocaleMiddleware для определения текущего языкового стандарта и вызова соответствующей модели диспетчеризации. Действие платформы бота имеет поле языкового стандарта, которое используется этим ПО промежуточного слоя. Вы можете использовать то же самое для своего навыка. Бот book-a-room не использует это ПО промежуточного слоя и вместо этого получает языковой стандарт из объекта clientInfo действия Bot framework.
Проверка утверждений
Мы добавили claimsValidator , чтобы ограничить вызывающих навыков. Чтобы разрешить виртуальному помощнику вызывать этот навык, заполните массив AllowedCallers на основе appsettings с помощью идентификатора приложения этого виртуального помощника.
"AllowedCallers": [ "<caller_VA1_appId>", "<caller_VA2_appId>" ],
Массив разрешенных вызывающих объектов может ограничить доступ потребителей навыка к навыку. Добавьте одну запись * в этот массив, чтобы принимать вызовы от любого потребителя навыка.
"AllowedCallers": [ "*" ],
Дополнительные сведения о добавлении проверки утверждений в навык см. в разделе Добавление проверки утверждений в навык.
Ограничение обновления карточки
Действие обновления, например обновление карточки, пока не поддерживается через Виртуальный помощник (проблема с GitHub). Таким образом, мы заменили все вызовы UpdateActivityAsync обновления карточек на отправку новых вызовов SendActivityAsyncкарточек .
Действия с карточками и диалоговые потоки
Чтобы перенаправить действие карточки или диалоговые действия в связанный навык, навык должен внедриться skillId в него.
Book-a-room Действия bot card, выборка диалогового окна и отправка полезных данных действия изменяются для их хранения skillId в качестве параметра.
Дополнительные сведения см. в статье Добавление адаптивных карточек в виртуальный помощник.
Обработка действий из области группового чата или канала
Book-a-room bot предназначен для частных чатов, таких как личные или приватные. Так как мы настроили виртуальный помощник для поддержки областей группового чата и каналов, виртуальный помощник нужно вызывать из областей канала, поэтому бот Book-a-room должен получать действия для той же области. Поэтому бот Book-a-room нужно изменить для обработки этих действий. Вы можете найти методы проверки OnMessageActivityAsync обработчика Book-a-room действий бота.
protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
// Check if activities are from groupchat/ teams scope. This might happen when the bot is consumed by Virtual Assistant.
if (turnContext.Activity.Conversation.IsGroup == true)
{
await ShowNotSupportedInGroupChatCardAsync(turnContext).ConfigureAwait(false);
}
else
{
...
}
}
Вы также можете использовать существующие навыки из репозитория решений Bot Framework или создать новый навык полностью с нуля. В создании навыка вам помогут руководства по созданию нового навыка. Документацию по виртуальному помощнику и архитектуре навыков см. в разделе Виртуальный помощник и архитектура навыков.
Ограничения виртуального помощника
-
EndOfConversation: по завершении беседы навык должен отправить действие
endOfConversation. В зависимости от действия виртуальный помощник заканчивает контекст с определенным навыком и возвращается в корневой контекст виртуального помощника. Для бота book-a-room нет четкого состояния, в котором заканчивается беседа. Поэтому мы не отправляли сообщенияendOfConversationотBook-a-roomбота, и когда пользователь хочет вернуться к корневому контексту, он может сделать это с помощьюstart overкоманды . - Обновление карточки. Обновление карточки пока не поддерживается с помощью Виртуального помощника.
-
Расширения для сообщений
- Виртуальный помощник может поддерживать не более 10 команд для расширений сообщений.
- Конфигурация расширений сообщений ограничивается не отдельными командами, а для всего расширения. Это ограничивает конфигурацию для каждого отдельного навыка с помощью виртуального помощника.
- Идентификаторы команд расширений сообщений имеют максимальную длину 64 символа, а для внедрения сведений о навыках используется 37 символов. Таким образом, новое ограничение для идентификатора команды - 27 символов.
Вы также можете использовать существующие навыки из репозитория решений Bot Framework или создать новый навык полностью с нуля. Руководства для последнего можно найти здесь. См. документацию по виртуальному помощнику и архитектуре навыков.
Пример кода
| Название примера | Описание | .NET |
|---|---|---|
| Обновленный шаблон Visual Studio | Настраиваемый шаблон для поддержки возможностей Teams. | View |
| Код навыка бота "Резервирование комнаты" | Позволяет быстро находить и резервировать помещения для совещаний. | Просмотр |
Дополнительные ресурсы
Platform Docs