Обзор API поиска Microsoft 365 Copilot (предварительная версия)

API-интерфейсы Microsoft 365 Copilot предоставляют доступ к компонентам, которые обеспечивают работу Copilot. С помощью этих API можно улучшить пользовательские агенты обработчика и решения искусственного интеллекта с помощью возможностей Copilot. API поиска Copilot позволяет разработчикам выполнять гибридный поиск (семантический и лексический) в OneDrive для рабочего или учебного содержимого с помощью запросов на естественном языке, которые понимают контекст и намерение возвращать соответствующие документы и файлы. Другие источники данных, такие как SharePoint, Соединители Copilot и другие, в настоящее время не поддерживаются API поиска, но будут добавлены в будущих выпусках. Дополнительные сведения о семантическом индексировании см. в разделе Microsoft 365 Copilot семантического индекса.

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

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

Попробуйте свой первый запрос API поиска в Graph Обозреватель.

Зачем использовать API поиска?

API поиска предлагает безопасный и соответствующий требованиям способ выполнения гибридного поиска (семантического и лексического) в OneDrive для рабочего или учебного содержимого при оптимизации контекстной релевантности и понимания намерений пользователей. Таким образом, вам не нужно отправлять данные, нарушать разрешения или скомпрометировать безопасность и соответствие требованиям.

Пользовательские поисковые приложения на основе ИИ могут использовать API поиска для обнаружения документов, хранящихся в OneDrive. Вместо того, чтобы создавать и поддерживать отдельные индексы поиска, эти приложения могут применять возможности гибридного поиска к содержимому OneDrive для отображения соответствующего содержимого так же, как Microsoft 365 Copilot поиск.

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

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

Управление рисками соответствия требованиям и безопасностью

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

Решение для актуальности и свежести

Так как API поиска выполняет гибридный поиск непосредственно в содержимом OneDrive без дублирования данных, его результаты сохраняются свежими и актуальными. Это устраняет необходимость в обслуживании отдельных дорогостоящих инфраструктур поиска.

Снижение стоимости владения и разработки

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

• Гибридный (семантический и лексический) поиск
• Обработка естественного языка
• Индексирование содержимого
• Хранилище данных
• Фильтрация на основе пути с помощью язык KeyQL (KQL)
• Безопасность и соответствие требованиям

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

Лицензирование

API поиска доступен без дополнительной платы для пользователей с надстройкой с лицензией на Microsoft 365 Copilot. Поддержка для пользователей без лицензии надстройки на Microsoft 365 Copilot в настоящее время недоступна.

Используя API поиска Microsoft 365 Copilot или используя его, вы соглашаетесь с условиями использования API Microsoft 365 Copilot (предварительная версия).

Лучшие методики

Следующие рекомендации применяются как к нефильтрованным запросам (запросы без ) так filterExpressionи к отфильтрованным запросам (запросы с filterExpression):

• API поиска возвращает результаты, упорядоченные по релевантности.
• Используйте все результаты поиска, возвращаемые API поиска, для комплексного обнаружения документов.
• Избегайте чрезмерно универсальных запросов, которые могут применяться к широкому спектру содержимого.
• Укажите как можно больше контекста в запросе для лучшего понимания семантики.
• query Создание описательного и естественного языка.
• Избегайте орфографических ошибок в важных ключевых словах при создании query.

Примените следующие рекомендации к отфильтрованным запросам (запросам с filterExpression):

• path Для параметра используйте полный путь к OneDrive, как показано в области сведений о файле или папке (не ссылка для общего доступа или адрес браузера). Пример: https://contoso-my.sharepoint.com/personal/username_domain_com/Documents/Project/Report.docx.

Текущие область и ограничения

В настоящее время к API поиска применяются следующие ограничения:

• Параметр query запроса имеет ограничение в 1500 символов.
• В качестве источника данных поддерживается только OneDrive для работы или учебного заведения.
• В filterExpressionподдерживаются только path выражения. Дополнительные свойства язык KeyQL (KQL) могут поддерживаться в будущих выпусках.
• Параметр pageSize запроса имеет максимальное значение 100.
• Поддерживается до 200 запросов на пользователя в час.
• Семантический поиск по нетекстуальному содержимому, включая таблицы, изображения и диаграммы, не поддерживается.
• Семантический поиск по файлам с расширениями .docx, .pptx и .pdf размером более 512 МБ не поддерживается. Семантический поиск в файлах с любым другим расширением размером более 150 МБ не поддерживается.
• Семантический поиск доступен в персонализированном рабочем наборе данных для содержимого OneDrive, который не включает все содержимое в OneDrive пользователя.
• Семантический поиск доступен только для следующих расширений файлов: .aspx, .docx, .pptx, .pdf, .onepart, .doc, .html, .eml, .mp4, .loop, .one, .fluid, .png, .jpg, .json, .csv, .xml, .ppt.
• На API поиска распространяются все ограничения Microsoft 365 Copilot семантического индекса.
• Если searchHits в ответе полезные данные пусты, соответствующие результаты не найдены.

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

Связанные материалы

• Попробуйте использовать обозреватель Graph