Добавление чат-бота в Microsoft Teams

Внимание

Возможности и функции Power Virtual Agents теперь являются частью Microsoft Copilot Studio после значительных инвестиций в генеративный искусственный интеллект и расширенную интеграцию с Microsoft Copilot.

Некоторые статьи и снимки экрана могут ссылаться на Power Virtual Agents, пока мы обновляем документацию и учебные материалы.

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

Пользователь может:

  • Настройте внешний вид вашего бота в Microsoft Teams
  • Установите бота для себя в Microsoft Teams
  • Поделитесь ссылкой для установки бота с другими пользователями
  • Отобразите бота в магазине приложений Microsoft Teams.
    • Покажите бота пользователям с общим доступом, добавив его в магазин приложений Microsoft Teams в раздел Создано коллегами.
    • Поделитесь ботом со своей организацией, отправив бота на утверждение администратором, чтобы он был размещен в магазине приложений Microsoft Teams в разделе Создано вашей организацией.
  • Добавьте бота в канал команды.
  • Загрузите предварительно созданный манифест приложения Teams, чтобы распространить его в своем клиенте Microsoft Teams.

Когда вы добавляете бота в Microsoft Teams, некоторые из ваших данных, такие как контент бота и контент чата конечного пользователя, будут переданы в Microsoft Teams. Ваши данные могут передаваться за пределы области соблюдения требований вашей организации и географические или региональные границы. Дополнительные сведения см. в документе Политика конфиденциальности приложения Microsoft Teams.

Предварительные условия

Подключите своего бота к каналу Microsoft Teams

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

Заметка

Мы рекомендуем вам включить настройки безопасности для ботов, созданных для Microsoft Teams или внутреннего использования сотрудниками, чтобы вы могли гарантировать, что бот не будет доступен для лиц за пределами вашей организации.

Подключение к Microsoft Teams:

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Включить Teams.

    Во всплывающем меню Microsoft Teams выберите «Включить Teams», чтобы сделать возможным общий доступ

    Заметка

    Если вы не видите этот вариант, значит канал Microsoft Teams может уже быть включен.

Настройте внешний вид бота в Microsoft Teams

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

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Изменить сведения для изменения значка, цвета и описания бота. Они будут показаны в магазине приложений Microsoft Teams и на вкладку «О приложении» после того, как пользователь установит бота. Ознакомьтесь с рекомендациями по форматам значков Microsoft Teams.

    Вы можете изменить значок, цвет фона и описания

    Внимание

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

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

  4. Выберите Дополнительно для добавления дополнительной информации:

  5. Выберите Сохранить, чтобы вернуться на экран, где вы можете сделать своего бота доступным в Teams. Вы увидите, что обновления цвета, значка и описания.

Заметка

Настройка значков в этом разделе применяется только к аватару ботов для ботов, которые утверждены администратором, и не распространяется на пользователей, которые устанавливают бота по прямой ссылке на установку или из магазина приложений Microsoft Teams из раздела Создано коллегами. Вы можете настроить аватар бота в разделе Настройка внешнего вида бота.

Значок аватара бота в чате Teams.

Установите бота как приложение в Microsoft Teams

После того, как вы опубликовали бота, вы можете добавить его в свою версию Microsoft Teams прямо из приложения Microsoft Copilot Studio.

Внимание

Новый контент в недавно опубликованном боте не будет отображаться в текущих разговорах. Через 30 минут простоя бот обновится.

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

Вам следует добавить своего бота в свою версию Teams, прежде чем поделиться им с другими.

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Открыть бота, чтобы запустить запрос установки в Microsoft Teams. Выберите Добавить, чтобы добавить как приложение в Teams. Бот будет установлен только для вас.

    Установите бота для себя на панели Teams

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Параметры доступности и выберите Копировать ссылку

    Внимание

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

    Скопируйте ссылку из параметров доступности Teams.

  4. Поделитесь скопированной ссылкой с пользователями, чтобы они могли установить бота в Microsoft Teams.

Отобразите бота в магазине приложений Microsoft Teams

После того, как вы опубликовали своего бота, вы можете показать его в магазине приложений Microsoft Teams, чтобы пользователи могли его найти и установить.

Показать пользователям с общим доступом

Вы можете поделиться своим ботом, добавив его в магазин приложений Microsoft Teams, раздел Создано для вашей организации>Создано коллегами. Только пользователи с общим доступом увидят там бота.

Внимание

Только пользователи, которым вы предоставили доступ, могут найти бота магазине приложений Microsoft Teams в разделе Создано коллегами. Бот не будет отображаться для всех в организации, даже если он настроен так, чтобы все могли использовать его. Чтобы показать бота своей организации, отправьте бота на утверждение администратором, чтобы разместить его в магазине приложений Microsoft Teams в разделе Создано вашей организацией.

Бот может отображаться только в магазине приложений Microsoft Teams, в разделе Создано коллегами, когда общее количество пользователей с общим доступом не превышает политику обнаружения магазина приложений Teams для клиента. Чтобы показать бота за пределами политики вашей организации, обратитесь к администратору, чтобы показать бота организации.

Раздел Создано коллегами находится внизу раздела Создано для вашей организации в магазине приложений Teams.

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Параметры доступности.

  4. Выберите Показывать моим коллегам и пользователям, которым предоставлен доступ и проверьте, у кого есть доступ к боту.

    Показать бота в магазине приложений Teams в разделе Создано коллегами.

  5. Убедитесь, что установлен флажок Показывать в разделе "Создано коллегами" и выберите Поделиться.

    Установите флажок Создано коллегами в пользовательском интерфейсе общего доступа.

  6. Это автоматически добавит бота в раздел Создано коллегами, будет отображаться зеленая метка Добавлено в Teams на странице параметров доступности.

    Всплывающее меню показывает, что бот добавлен в Teams.

Заметка

Если ваше приложение не отображается в разделе Создано коллегами, ваше приложение Teams может кэшировать информацию.

Попробуйте выйти и снова войти (если вы используете настольное приложение) или обновить страницу в браузере (если вы используете веб-приложение Teams).

Удаление бота из раздела "Создано коллегами"

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

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Параметры доступности.

  4. Выберите флажки Показывать моим коллегам и пользователям, которым предоставлен доступ и Показывать в разделе "Создано коллегами".

    Снимите флажок Создано коллегами в пользовательском интерфейсе общего доступа.

  5. Выберите Предоставить общий доступ. Теперь бот больше не будет отображаться в магазине приложений Microsoft Teams в разделе Создано коллегами.

Показать организации

Можно поделиться ботом со своей организацией, отправив бота на утверждение администратором, чтобы он был размещен в разделе Создано вашей организацией>Создано коллегами. Это отличный способ широко распространить своего бота, сотрудничая с вашим администратором, чтобы развернуть бота для всех в организации или для группы пользователей.

Раздел Создано вашей организацией находится вверху раздела Создано для вашей организации в магазине приложений Teams.

Администраторы также могут предварительно установить и закрепить бота для пользователей в организации, чтобы они могли получить к нему доступ прямо из панели приложений в Microsoft Teams.

Перед отправкой бота в вашу организацию убедитесь, что:

  • Бот готов к выпуску и соответствует стандартам, правилам и политикам компании.
  • Вы координируете свои действия с другими менеджерами ботов: после того, как бот был отправлен, он не может быть повторно отправлен другим пользователем, пока предыдущая отправка не будет одобрена или отклонена администратором.
  • Вы удалили бота, если применимо, из раздела Создано коллегами. Отправка вашего бота на одобрение администратором может привести к тому, что он появится в двух местах. См. инструкции по удалению вашего бота.

Заметка

После утверждения бота администратором его доступность в разделе Создано вашей организацией будет полностью управляться вашим администратором. Только администратор может удалить бота из раздела Создано вашей организацией.

Отправьте заявку для раздела "Создано вашей организацией"

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Параметры доступности.

  4. Убедитесь, что бот не отображается для коллег по команде и пользователей с общим доступом. Удалите его, если есть метка Добавлено в Teams.

  5. Выберите Показывать всем в моей организации.

    Показывать бота организации в параметрах доступности панели Teams.

  6. Ознакомьтесь с требованиями для отправки и выберите Отправить на утверждение администратором.

    Заметка

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

    После утверждения все новые и существующие пользователи бота в Teams получат обновление.

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

  7. Появится окончательное подтверждение. Щелкните Да, чтобы продолжить. Бот будет отправлен вашему администратору для утверждения, и вы увидите примечание с состоянием вашей отправки.

    Статус имеет оранжевую заметку с информацией о статусе отправки, включая имя бота, номер версии и текущий статус ожидания утверждения

    Заметка

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

    Иначе пользователи в организации не смогут общаться с ботом после его установки из магазина приложений Microsoft Teams в разделе Создано вашей организацией.

    Работайте со своим администратором по вопросам политики приложения Microsoft Teams для тех, кто может найти и установить бота.

  8. Вам нужно будет дождаться одобрения вашего администратора. Вы можете проверить последний статус, выбрав Обновить или открыв окно Сделать бота доступным для других пользователей на странице Опубликовать.

  9. После того, как ваш администратор одобрит бота, статус будет обновлен на Утверждено. Вы можете напрямую открыть бота и поделиться ссылкой на одобренную версию с другими пользователями.

  10. Или же обратитесь к администратору, чтобы предварительно закрепить или установить приложение для пользователей с политикой приложения Microsoft Teams, чтобы они могли найти бота прямо в своем списке приложений Microsoft Teams.

Заметка

Если ваше приложение не отображается в разделе Создано вашей организацией, даже если есть состояние Утверждено, ваше приложение Teams может кэшировать информацию.

Попробуйте выйти и снова войти (если вы используете классическое приложение) или обновить страницу в браузере (если вы используете веб-приложение Teams).

Добавить бота в рабочую группу

В Microsoft Teams можно добавить ботов в команды. Когда вы добавляете ботов, члены команды могут @mention бота в любых каналах рабочей группы, и все сотрудники группы увидят ответ от бота. Эта функция полезна для сценариев, в которых:

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

Разрешить пользователям добавлять бота в рабочую группу

Этот параметр позволяет пользователям добавлять бота в любую команду, частью которой они являются, при добавлении бота в Microsoft Teams.

После включения этого параметра любой пользователь, который устанавливает бота из магазина приложений Teams или по ссылке для установки, увидит возможность добавить бота в команду в Microsoft Teams. Члены команды также могут удалить бота из команды.

Внимание

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

Чтобы разрешить пользователям добавлять бота в рабочую группу:

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Изменить сведения.

  4. Выберите Разрешить пользователям добавлять этого бота в рабочую группу.

    Флажок установлен, чтобы разрешить пользователю добавлять бота в команды, частью которых он является

  5. Выберите Сохранить.

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

Если вы ранее отправили бота на одобрение администратора, вам нужно будет отправить повторно после включения этого параметра. Администратор должен одобрить эти изменения, прежде чем пользователи смогут добавить бота в свои команды из магазина приложений Microsoft Teams в разделе «Создано вашей организацией».

Запретить пользователям добавлять бота в команду

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

Чтобы запретить пользователям добавлять бота в команду:

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Изменить сведения.

  4. Снимите флажок Разрешить пользователям добавлять этого бота в рабочую группу.

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

  5. Выберите Сохранить.

Настройка поведения личного приветствия

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

Заметка

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

Если этот параметр включен, ваш бот автоматически начнет разговор с членами команды. Чтобы настроить приветственное сообщение бота, измените тему системного приветствия.

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

Чтобы настроить, когда бот отправляет личное приветствие:

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Параметры.

    Точка входа в настройки для настройки поведения личного приветствия бота

  4. Настройте параметры личного приветствия.

    Параметры личного приветствия пользователя

  5. Выберите Сохранить.

Загрузите манифест приложения Teams бота (дополнительно)

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

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Параметры доступности.

  4. Выберите Загрузить ZIP.

    Загрузите ZIP-файл манифеста приложения Teams из параметров доступности панели Teams.

  5. Манифест будет создан как файл ZIP и сохранен в соответствии с настройками сохранения вашего браузера.

Отключение своего бота от Teams

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

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

Для ботов, одобренных администратором, они по-прежнему будут отображаться в магазине приложений Microsoft Teams в разделе Создано вашей организацией. Вам нужно будет связаться со своим администратором, чтобы удалить бота

  1. В меню навигации в разделе Параметры выберите Каналы.

  2. Выберите параметр Microsoft Teams.

  3. Выберите Отключить бота от Teams.

    Отключите канал Teams на панели каналов Teams.

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

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

Известные ограничения

  • Конфигурация частного приветствия не поддерживается для ботов, использующих обновленный единый холст разработки.
  • В настоящее время только области Личный и Рабочая группа поддерживаются для Microsoft Teams. Групповой чат не поддерживается.
  • Установка значка аватара бота на странице сведений не будет отображаться для ботов, одобренных администратором. У ботов, одобренных администратором, в качестве аватара бота будет использоваться значок приложения.
  • Teams имеют ограничение скорости для ботов. В зависимости от потребностей вашего бизнеса, вы, возможно, захотите, чтобы содержимое вашего бота было кратким для ботов, добавляемых в Microsoft Teams.
  • В настоящее время если ваш бот поддерживает аутентификацию конечного пользователя, пользователь не сможет явно выйти из системы. Если вы опубликуете свой бот на панели мониторинга продавца, это нарушит сертификацию Microsoft Teams AppSource. Это не относится к личному использованию бота или использованию в рамках клиента. Узнайте больше в разделе Публикация приложения Microsoft Teams и Политика проверки AppSource.
  • Отключение вашего бота от Teams может занять несколько минут, прежде чем бот станет недоступен для пользователей Microsoft Teams.