Соединитель Microsoft Graph для облачных знаний GitHub (предварительная версия)

Соединитель графа облачных знаний GitHub позволяет индексировать содержимое из репозиториев GitHub, что упрощает поиск в экосистеме Microsoft 365. Этот соединитель идеально подходит для организаций, использующих облако GitHub для документации, файлов проектов или управления содержимым. Интеграция данных GitHub с Поиском (Майкрософт) позволяет пользователям получать доступ к соответствующему содержимому непосредственно в приложениях Microsoft 365, упрощая рабочие процессы и уменьшая необходимость переключаться между платформами.

Эта статья предназначена для администраторов Microsoft 365 или тех, кто настраивает, запускает и отслеживает соединитель Graph для облачных знаний GitHub.

Примечание.

Соединитель графа облачных знаний GitHub находится в предварительной версии. Если вы хотите получить ранний доступ, чтобы попробовать его, зарегистрируйтесь с помощью этой формы.

Возможности

• Проиндексировать облачные репозитории GitHub и файлы Markdown, чтобы сделать документацию по проекту доступной в Microsoft 365.
• Разрешить конечным пользователям задавать вопросы в Copilot, связанные с проектной документацией и техническими руководствами.
  • Разделы справки настроить Project Alpha?
  • Где можно найти инструкции по развертыванию?
  • Каковы общие сведения об архитектуре для этого проекта?
  • Краткое руководство по ключевым разделам в документации по проекту
• Используйте семантический поиск в Copilot , чтобы пользователи могли находить релевантный контент на основе ключевых слов, личных предпочтений и социальных связей.

Ограничения

• Индексируются только метаданные репозитория и файлы Markdown. Другие сущности GitHub, такие как проблемы, запросы на вытягивание и комментарии, не индексируются.
• Поддерживаются только файлы Markdown размером до 1 МБ. Большие файлы не индексируются.
• Соединитель Графа облачных знаний GitHub не поддерживает доступ к внутренним репозиториям в GitHub.

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

• Вы должны быть администратором поиска для клиента Microsoft 365 вашей организации.

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

  А. Для личных репозиториев необходимо иметь один из следующих вариантов:

  • Владелец репозитория
  • Совместная работа в репозитории

  Б. Для репозиториев, принадлежащих организации, вы должны быть одним из следующих:

  • внешний участник совместной работы
  • Участник организации в качестве непосредственного участника совместной работы
  • Участник организации с доступом через членство в команде
  • Участник организации с доступом через разрешения организации по умолчанию
  • Владелец организации.

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

1. Отображаемое имя

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

2. Тип проверки подлинности

Для проверки подлинности и синхронизации содержимого из GitHub можно выбрать один из следующих методов проверки подлинности:

1. Личный маркер доступа GitHub (PAT)
   Проверка подлинности с помощью личного маркера доступа для подключения данных GitHub и управления ими в Microsoft Graph. Используйте личный маркер доступа вместо пароля. Репозитории, доступные для индексирования, зависят от доступа, предоставленного маркером.

• У вас должен быть личный маркер доступа (PAT). Дополнительные сведения о личных маркерах доступа см. в статье Управление личными маркерами доступа — документация GitHub.
• Ваш личный маркер доступа должен иметь доступ ко всем репозиториям, которые вы хотите индексировать, и ему должно быть предоставлено разрешение, указанное ниже.

Для классического маркера:

Категория	Разрешение	Замечания
Репо	Все	Полный контроль над частными репозиториями
Пользователь	read:user	Чтение всех данных профиля пользователя
Пользователь	read:email	Доступ к адресам электронной почты пользователей (только для чтения)

Для детального маркера:

Категория	Разрешение	Уровень разрешений
Разрешения репозитория	Содержание	Только для чтения
Разрешения репозитория	Metadata	Только для чтения
Разрешения учетной записи	Адреса электронной почты	Только для чтения

Если у вас есть принадлежащие организации репозитории, выполните следующие дополнительные действия:

• Администратор организации должен разрешить доступ с помощью личных маркеров доступа. Инструкции см. в статье Настройка политики личных маркеров доступа для организации — документация GitHub
• Если вы используете детализированные маркеры, выберите организацию в качестве владельца ресурса.

2. маркер установки Приложение GitHub
   

• Используйте зарегистрированный Приложение GitHub для безопасной проверки подлинности и управляемого доступа к данным GitHub.
• Обеспечивает улучшенное управление разрешениями и безопасность, обеспечивая беспроблемную интеграцию с Microsoft Graph.

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

Пользовательская настройка предназначена для администраторов, которые хотят изменить значения по умолчанию для перечисленных параметров. Щелкнув параметр "Настраиваемая настройка", вы увидите еще три вкладки: Пользователи, Содержимое и Синхронизация.

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

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

Соединитель облачных знаний GitHub поддерживает разрешения на поиск , видимые всем пользователям с доступом к этому источнику данных. Для всех индексированные данные отображаются в результатах поиска для всех пользователей. Сведения о преобразовании удостоверений см. в статье Сопоставление удостоверений, отличных от Azure AD | Microsoft Learn.

Содержимое

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

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

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

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

Интервал обновления определяет частоту синхронизации данных между источником данных и индексом соединителя Graph. Существует два типа интервалов обновления: полный обход контента и добавочный обход контента. Дополнительные сведения см. в разделе Параметры обновления.

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

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

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

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