Соединитель Microsoft 365 Copilot Miro (предварительная версия)

Microsoft 365 Copilot Miro позволяет вашей организации индексировать доски из Miro. После настройки соединителя пользователи могут искать эти доски из Miro в Microsoft 365 Copilot и любом клиенте поиска (Майкрософт).

Эта статья предназначена для администраторов Microsoft 365 или всех, кто настраивает, запускает и отслеживает соединитель Miro Copilot.

Примечание.

Соединитель Miro Copilot доступен в общедоступной предварительной версии. Чтобы получить доступ к соединителю, включите круг целевого выпуска для учетной записи Администратор.

Возможности

• Доступ к доскам в Copilot с помощью функции семантического поиска.
• Настройка частоты обхода контента.
• Создайте агент, используя источник данных подключения из Microsoft Copilot Studio.

Ограничения

• Индексируются только текстовые элементы на доске. Содержимое карточек, заметок, вставок, тегов, кадров, карт разума, предварительных просмотров и фигур не индексируется. Дополнительные сведения см. в документации Miro для разработчиков.
• Не индексирует комментарии или ответы.

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

1. Создание команды разработчиков для учетной записи Miro

Создайте или используйте существующую учетную запись Miro для доступа к Miro и щелкните ссылку , чтобы создать команду разработчиков для вашей активной учетной записи Miro. Если ваша организация использует корпоративный план, перейдите в раздел Команды разработчиков enterprise. Дополнительные сведения см. в разделе Создание команды разработчиков.

2. Создание приложения в Miro

Войдите в Miro и создайте новое приложение в разделе Ваши приложения.

3. Добавление разрешений в приложение

boards:read Read boards you have access to Добавьте план в приложение, созданное в конфигурации приложения

4. Добавление URL-адреса перенаправления в приложение

На странице создания приложения добавьте следующие ссылки в поле "URL-адрес перенаправления для OAuth2.0".

• Для M365 Корпоративный скопируйте и вставьте: https://gcs.office.com/v1.0/admin/oauth/callback

• Для M365 для государственных организаций скопируйте и вставьте: https://gcsgcc.office.com/v1.0/admin/oauth/callback

5. Установка приложения и запись учетных данных

Щелкните Установить приложение, получите токен OAuth и запишите Client IDClient secret и из учетных данных приложения.

Начало работы

1. Настройка отображаемого имени

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

2. Добавление идентификатора команды

Идентификатор команды Miro — это идентификатор конкретной команды на платформе Miro. Чтобы найти идентификатор команды, войдите в Miro в браузере, перейдите в параметры команды на панели мониторинга и скопируйте идентификатор.

Примечание.

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

3. Укажите тип проверки подлинности.

Введите идентификатор клиента и секрет клиента, полученные из приложения Miro. Дополнительные сведения см. в статье Начало работы с OAuth 2.0 и Miro.

4. Развертывание для ограниченной аудитории

Разверните это подключение в ограниченной базе пользователей, если вы хотите проверить его в Copilot и других поверхностях поиска, прежде чем развернуть развертывание для более широкой аудитории. Дополнительные сведения см. в статье Поэтапное развертывание соединителей Microsoft 365 Copilot.

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

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

Пользователи	Описание
Разрешения доступа	Только пользователи, имеющие доступ к содержимому в источнике данных.
Сопоставление удостоверений	Удостоверения источников данных, сопоставленные с помощью идентификаторов Microsoft Entra.

Содержимое	Описание
Управление свойствами	Для проверка свойств по умолчанию и их схемы.

Синхронизация	Описание
Полный обход контента	Частота: каждый день

Настраиваемая настройка

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

Пользователи

Разрешения доступа

Соединитель Miro Copilot поддерживает разрешения на поиск, которые видны всем или только людям с доступом к этому источнику данных. При выборе параметра Все индексированные данные отображаются в результатах поиска для всех пользователей. Если выбрать только людей с доступом к этому источнику данных, индексированные данные будут отображаться в результатах поиска для пользователей, имеющих доступ к нему.

Сопоставление удостоверений

По умолчанию для сопоставления удостоверений источника данных с Microsoft Entra ID является проверка того, что идентификатор электронной почты пользователей Miro совпадает с именем участника-пользователя (UPN) или адресом электронной почты пользователей в Microsoft Entra. Если сопоставление по умолчанию не подходит для вашей организации, можно указать настраиваемую формулу сопоставления. Дополнительные сведения см. в статье Сопоставление удостоверений, отличных от Azure AD.

Чтобы определить, какой вариант лучше всего подходит для вашей организации, выполните следующие действия:

• Выберите параметр Microsoft Entra ID, если идентификатор электронной почты пользователей Miro совпадает с именем участника-пользователя или электронной почтой в Microsoft Entra ID.
• Выберите параметр Не Microsoft Entra ID, если идентификатор электронной почты пользователей Miro отличается от имени участника-пользователя и электронной почты в Microsoft Entra ID.

Содержимое

Управление свойствами

Чтобы добавить или удалить доступные свойства из источника данных Miro, назначьте схему свойству (определите, является ли свойство доступным для поиска, доступным для запросов, извлекаемым или уточняемым), измените семантиковую метку и добавьте псевдоним в свойство . Некоторые свойства выбираются по умолчанию.

Свойство Source	Метка	Описание	Схема
Текст	Недоступно	Недоступно	Поиск
CreatedAt	Дата создания	Дата и время создания элемента в источнике данных	Запрос, получение.
CreatedBy	Автор	Пользователь, создавший элемент	Запрос, извлечение, поиск.
Описание	Недоступно	Недоступно	Запрос, получение.
Id	Недоступно	Недоступно	Запрос, получение.
ModifiedAt	Время последней измененной даты	Дата и время последнего изменения элемента в источнике данных	Запрос, получение.
ModifiedBy	Автор последнего изменения	Пользователь, внесший последнее изменение	Запрос, извлечение, поиск.
Имя	Название	Заголовок элемента, который вы хотите показать в Copilot и других интерфейсах поиска	Запрос, извлечение, поиск.
Команда	Недоступно	Недоступно	Запрос, получение.
ViewLink	url	Целевой URL-адрес элемента в источнике данных	Запрос, получение.

Предварительный просмотр данных

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

Синхронизация

Интервал обновления определяет частоту синхронизации данных между источником данных и индексом соединителя Miro Copilot. Поддерживаются только интервалы полного обновления обхода контента. Дополнительные сведения см. в разделе Параметры обновления.

Вы можете изменить значения интервала обновления по умолчанию.

Устранение неполадок

Ниже приведены распространенные ошибки и способы их устранения.

1. Отсутствуют необходимые области разрешений. Убедитесь, что в приложении Miro выбраны необходимые области.

У вас нет необходимых областей разрешений. Убедитесь, что выбрано boards:read Read boards you have access to поле разрешений конфигурации приложений.

2. Сбой потока OAuth 2.0. Проверьте учетные данные и убедитесь, что приложение Miro настроено с правильными параметрами.

Это распространенная ошибка проверки подлинности. Назад в приложение Miro и убедитесь, что OAuth2 в параметрах настроен правильно.

4. Сбой потока OAuth 2.0. Убедитесь, что пользователь Miro, связанный с этим маркером доступа группы, имеет роль администратора команды и является активным пользователем.

Это распространенная ошибка проверки подлинности. Назад в консоль приложения Miro и убедитесь, что у создателя есть роль администратора и состояние учетной записи активно.

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

Срок действия учетных данных истек. Обновите приложение Miro и скопируйте последнюю версию идентификатора клиента и секрета клиента на вкладке параметров для проверки подлинности.

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

Это распространенная ошибка учетных данных. Назад к приложению Miro и убедитесь, что области в разделе Разрешения настроены правильно.

Дальнейшие действия

После публикации подключения можно просмотреть состояние в разделе Источники данных в Центре администрирования. Дополнительные сведения см. в разделе Управление соединителем.

Если у вас возникли проблемы или вы хотите отправить отзыв, см. раздел поддержки Microsoft Graph.