Создание расширений сообщений с помощью Bot Framework

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

См. следующее видео, чтобы узнать, как определить команды поиска расширений сообщений:

Команда поиска в расширении сообщения настраивается с помощью composeExtensions.commands свойства и типа в манифесте query приложения (ранее называемого манифестом приложения Teams). Описания команд и параметров повышают удобство использования и эффективность расширения сообщений. Хорошее описание команды содержит четкую и краткую сводку функций приложения.

Следующий код является примером свойства, composeExtensions определяющего команду поиска:

{
 "composeExtensions": [
    {
      "botId": "eccdf132-0900-4d36-936b-dec5e6357f11",
      "commands": [
        {
          "id": "Dev",
          "type": "query",
          "title": "Jedi",
          "description": "May the force be with you",
          "initialRun": true,
          "fetchTask": false,
          "context": [
            "commandBox",
            "compose",
            "message"
          ],
          "parameters": [
            {
              "name": "Luke",
              "title": "Skywalker",
              "description": "Jedi master",
              "inputType": "text"
            }
          ]
        }
      ],
      "canUpdateConfiguration": true
    }
  ],

Параметры

В массив объектов необходимо добавить следующие параметры composeExtensions.commands :

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

Дополнительные сведения см. в разделе Схема манифеста приложения.

Следующее действие

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

Команда действия в расширении сообщения настраивается с помощью composeExtensions.commands свойства и action типа в манифесте приложения.

Следующий код является примером свойства, composeExtensions определяющего команду действия:

"composeExtensions": [
        {
            "botId": "xxxxxx-xxx-bot-ID-xxxxxxxx}",
            "commands": [
                {
                    "id": "createCard",
                    "context": [
                        "compose",
                        "message",
                        "commandBox"
                    ],
                    "description": "Command to run action to create a Card from Compose Box",
                    "title": "Create Card",
                    "type": "action",
                    "parameters": [
                        {
                            "name": "title",
                            "title": "Card title",
                            "description": "Title for the card",
                            "inputType": "text"
                        },
                        {
                            "name": "subTitle",
                            "title": "Subtitle",
                            "description": "Subtitle for the card",
                            "inputType": "text"
                        },
                        {
                            "name": "text",
                            "title": "Text",
                            "description": "Text for the card",
                            "inputType": "textarea"
                        }
                    ]
                }
            ]
        }
    ]

Параметры

В массив объектов необходимо добавить следующие параметры composeExtensions.commands :

Если вы используете статический список параметров, необходимо также добавить следующие параметры:

Если вы используете внедренное веб-представление, при необходимости можно добавить taskInfo объект для получения веб-представления без вызова бота напрямую. В этом случае использование аналогично использованию статического списка параметров. В том смысле, что первое взаимодействие с ботом представляет собой ответ на действие отправки модуля задачи. Если вы используете taskInfo объект , необходимо задать для fetchTask параметра значение false.

Дополнительные сведения см. в разделе Схема манифеста приложения.

Следующее действие