Тестирование и отладка ленты на локальном компьютереTest and debug your bot locally

При тестировании программы Bot необходимо принимать во внимание как те контексты, в которых должен работать Bot, так и любые функциональные возможности, которые могут быть добавлены в систему робота, требующие данных, относящихся к Microsoft Teams.When testing your bot you need to take into consideration both the context(s) you want your bot to run in, as well as any functionality you may have added to your bot that requires data specific to Microsoft Teams. Убедитесь, что метод, выбранный для проверки поправки ленты, соответствует функциональным возможностям.Make sure that the method you chose to test your bot aligns with its functionality.

Тестирование при отправке в TeamsTest by uploading to Teams

Наиболее полный способ тестирования программы Bot заключается в создании пакета приложения и его отправке в Teams.The most comprehensive way to test your bot is by creating an app package and uploading it to Teams. Это единственный способ протестировать все функции, доступные в интерфейсе Bot, во всех областях.This is the only method to test the full functionality available to your bot, across all scopes.

Существует два метода отправки приложения.There are two methods for uploading your app. Вы можете использовать Приложение App Studio , чтобы помочь вам, или вручную создать пакет приложения и отправить приложение.You can either use App Studio to help you, or you can manually create an app package and upload your app. Если требуется изменить манифест и повторно отправить приложение, необходимо Удалить Bot перед отправкой измененного пакета приложений.If you need to alter your manifest and re-upload your app, you should delete your bot before uploading your altered app package.

Отладка ленты на локальном компьютереDebug your bot locally

Если вы размещаете Bot на локальном этапе разработки, вам потребуется использовать службу туннелирования, такую как ngrok , чтобы протестировать ваш робот.If you are hosting your bot locally during development you'll need to use a tunneling service like ngrok in order to test your bot. После загрузки и установки ngrok выполните приведенную ниже команду, чтобы запустить службу туннелирования (возможно, потребуется добавить ngrok в ваш путь).Once you've downloaded and installed ngrok, run the below command to start the tunneling service (you may need to add ngrok to your path).

ngrok http <port> -host-header=localhost:<port>

Используйте конечную точку HTTPS, предоставленную ngrok, в манифесте приложения.Use the https endpoint provided by ngrok in your app manifest. Если вы закроете командное окно и перезапуститее, вы получите новый URL-адрес, и вам потребуется обновить адрес конечной точки ленты, чтобы использовать ее.If you close your command window and restart you'll get a new URL, and you'll need to update your bot endpoint address to use that one as well.

Тестирование ленты без отправки в TeamsTesting your bot without uploading to Teams

Иногда может потребоваться тестирование программы Bot, не устанавливая ее как приложение в Teams.Occasionally it may be necessary to test your bot without installing it as an app in Teams. Мы предоставляем два способа, описанных ниже.We provide two methods for doing so below. Тестирование программы-робота без ее установки в качестве приложения может пригодиться для обеспечения доступности и ответа ленты, но не позволит вам протестировать все функции Microsoft Teams, которые могут быть добавлены в систему.Testing your bot without installing it as an app can be useful to ensure your bot is available and responding, however it will not allow you to test the full breadth of Microsoft Teams functionality you may have added to your bot. Если вам нужно полностью протестировать робот, следуйте инструкциям по тестированию, выполнив отправку.If you need to fully test your bot, please follow the instructions for testing by uploading.

Использование эмулятора лентыUse the Bot Emulator

Эмулятор ленты Bot является классом для настольных ПК, который позволяет разработчикам-роботам тестировать и отлаживать свои Боты, как локально, так и удаленно.The Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots, either locally or remotely. С помощью эмулятора можно общаться с программой Bot и проверять сообщения, отправляемые и получаемые с помощью ленты.Using the emulator, you can chat with your bot and inspect the messages that your bot sends and receives. Это может быть полезно для проверки доступности ленты и реагирования на них, но эмулятор не позволит вам протестировать все функции, которые вы добавили в интерфейс пользователя, а также не отправит ответ от робота к точному визуальному представлению того, как они будут отображаться в Teams.This can be useful for verifying that your bot is available and responding, however the emulator will not allow you to test any Teams-specific functionality you've added to your bot, nor will responses from your bot be an accurate visual representation of how they will be rendered in Teams. Если вам нужно протестировать любую из этих возможностей, лучше всего загрузить робот.If you need to test either of those things it is best to upload your bot.

Полные инструкции на эмуляторе Bot Framework можно найти здесь.Complete instructions on the Bot Framework Emulator can be found here.

Обращение к Bot непосредственно по идентификаторуTalk to your bot directly by Id

Важно!

Обращение к Bot по идентификатору предназначено только для основных целей тестирования.Talking to your bot by Id is intended for basic testing purposes only. Все функции, связанные с Teams, которые вы добавили в Bot, не будут работать.Any Teams-specific functionality you've added to your bot will not work.

Кроме того, вы можете начать беседу с роботом с помощью идентификатора. Ниже приведены два способа.You can also initiate a conversation with your bot by using its Id. Two methods for doing so are given below. При добавлении ленты с помощью одного из этих методов он не будет поддерживаться в беседах канала, и вы не сможете использовать другие возможности приложений Microsoft Teams, такие как вкладки или расширения обмена сообщениями.When a bot has been added through one of these methods it will not be addressable in channel conversations, and you cannot take advantage of other Microsoft Teams app capabilities like tabs or messaging extensions.

  1. На странице панели мониторинга Bot для ленты в разделе каналывыберите команду Добавить в Microsoft Teams.On the Bot Dashboard page for your bot, under Channels, select Add to Microsoft Teams. Microsoft Teams запустится с помощью персонального чата с помощью программы Bot.Microsoft Teams will launch with a personal chat with your bot.
  2. Непосредственное обращение к ИДЕНТИФИКАТОРу приложения Bot в Microsoft teams:Directly reference your bot's app ID from within Microsoft Teams:
    • На странице панели мониторинга Bot для ленты в разделе Details (сведения) скопируйте идентификатор приложения Microsoft для ленты.On the Bot Dashboard page for your bot, under Details, copy the Microsoft App ID for your bot.

      Извлечение AppID для Bot

    • В области чата в Microsoft Teams выберите значок Добавить чат .From within Microsoft Teams, on the Chat pane, select the Add chat icon. В папке кому: вставьте идентификатор приложения для Bot.For To:, paste your bot's Microsoft App ID.

      Извлечение AppID для Bot

      Идентификатор приложения должен разрешаться в имя пользователя Bot.The app ID should resolve to your bot name.

    • Выберите робота и отправьте сообщение, чтобы начать беседу.Select your bot and send a message to initiate a conversation.

    • Кроме того, вы можете вставить идентификатор приложения Bot в поле поиска в левом верхнем углу в Microsoft Teams.Alternatively, you can paste your bot's app ID in the search box in the top left in Microsoft Teams. На странице результатов поиска перейдите на вкладку люди, чтобы увидеть свой робот и начать разговор с ним.In the search results page, navigate to the People tab to see your bot and to start chatting with it.

Ваш робот получит conversationUpdate событие, как боты, добавленный в команду, но без сведений о группе в channelData объекте.Your bot will receive the conversationUpdate event just like bots added to a team, but without the team information in the channelData object.

Блокировка ленты в личном чатеBlocking a bot in personal chat

Обратите внимание, что пользователи могут блокировать отправку сообщений личного чата с ленты.Note that users can choose to block your bot from sending personal chat messages. Это можно сделать, щелкнув правой кнопкой мыши элемент Bot в канале чата и выбрав пункт блокировать приразговор к началу ленты.They may toggle this by right-clicking your bot in the chat channel and choosing Block bot conversation. Это означает, что ваш Боты будет продолжать отправлять сообщения, но пользователь не будет получать эти сообщения.This means your bots will continue to send messages but the user will not receive those messages.

Блокировка Bot

Удаление ленты из командыRemoving a bot from a team

Пользователи могут удалить робота, выбрав значок корзины в списке боты в представлении Teams.Users can delete the bot by choosing the trash-can icon on the bots list in their teams view. Обратите внимание, что это только удаляет Bot из использования в этой команде; отдельные пользователи все еще смогут работать в личном контексте.Note that this only removes the bot from that team's use; individual users will still be able to interact in personal context.

Боты в личном контексте не может быть отключено или удалено пользователем. не удается полностью удалить Bot из Teams.Bots in personal context cannot be disabled or removed by a user, short of completely removing the bot from Teams.

Отключение Bot в TeamsDisabling a bot in Teams

Чтобы остановить получение сообщений от начала работы, перейдите на панель мониторинга Bot и измените канал Microsoft Teams.To stop your bot receiving messages, go to your Bot Dashboard and edit the Microsoft Teams channel. Снимите флажок включить в Microsoft Teams .Clear the Enable on Microsoft Teams option. Это не позволяет пользователям взаимодействовать с Bot, но по-прежнему будет доступно для обнаружения и пользователи смогут добавить его в Teams.This prevents users from interacting with the bot, but it will still be discoverable and users will still be able to add it to teams.

Удаление ленты из TeamsDeleting a bot from Teams

Чтобы полностью удалить Bot из Teams, перейдите на панель управления Bot и измените канал Microsoft Teams.To remove your bot completely from Teams, go to your Bot Dashboard and edit the Microsoft Teams channel. Нажмите кнопку Удалить в нижней части страницы.Choose the Delete button at the bottom. Это не позволяет пользователям обнаруживать, добавлять или взаимодействовать с роботом.This prevents users from discovering, adding, or interacting with your bot. Обратите внимание, что это не приводит к удалению ленты из экземпляров Teams других пользователей, хотя она перестанет работать и для них.Note that this does not remove the bot from other users' Teams instances, although it will cease functioning for them as well.