Объединённый поиск

Объединённый поиск позволяет поиску Документерры индексировать и выполнять поиск не только по документации внутри вашего портала, но и по внешним веб-сайтам — например, по маркетинговому сайту вашей компании, блогу или другой публичной базе знаний.

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

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

• Сценарии использования
• Требования и ограничения
• Попробовать Объединённый поиск
• Обратная связь

Сценарии использования

Объединённый поиск может быть полезен, если вы хотите:

• Объединить результаты из вашей документации в Документерре и с вашего сайта.
• Позволить ИИ Помощнику искать ответы одновременно и в документации, и на вашем сайте. 
• Обеспечить единый поиск по всем вашим ресурсам (например, основному сайту, блогу, порталу для разработчиков).

Требования и ограничения

Для подключения Объединённого поиска к вашему внешнему ресурсу должны быть выполнены следующие условия:

• Публичный доступ
  Страницы должны быть доступны без аутентификации. Если у вас закрытый сайт, вы все равно можете использовать Объединённый поиск, добавив IP-адрес поискового бота Документерры в белый список и разрешив анонимный доступ для индексации.
• Файл Sitemap
  
  Сайт должен иметь рабочие файлы sitemap или sitemap index со списком страниц для включения в поиск.
  Пример: https://company.com/sitemap.xml. Вы можете предоставить несколько файлов sitemap, если хотите индексировать несколько разных разделов отдельно (например, блог и сайт поддержки).
  Обратите внимание, что по умолчанию наш поисковой бот переиндексирует страницы раз в неделю.
• Только статические HTML-страницы
  Поисковой бот индексирует стандартные HTML-страницы. Он не поддерживает файлы PDF, Word или другие типы файлов и не может получить контент, который появляется только после выполнения скриптов на странице.
• Нет интеграции через API
  Объединённый поиск не использует API для доступа к контенту из таких систем, как Confluence, Zendesk или Jira. Если вам нужно импортировать такой контент, ознакомьтесь с разделом Импорт и перенос контента.
• Не поддерживаются robots.txt / canonical
  В настоящее время объединённый поиск не учитывает файлы robots.txt, канонические ссылки или другие директивы на уровне сайта, используемые для управления индексацией страниц публичными поисковыми системами. Если вам требуется поддержка этих механизмов, сообщите нам об этом.
• Ограничения по размеру
  По умолчанию можно добавить до 50 000 страниц. Увеличение объема можно обсудить с нами.

Попробовать Объединённый поиск

Если вы хотите оценить, как работает Объединённый поиск для вашего контента:

1. Подготовьте один или несколько URL-адресов файлов sitemap, для индексации.
   Пример: https://documenterra.ru/sitemap_index.xml.
2. Направьте нам следующие данные для каждого файла sitemap:
   1. URL файла sitemap.
   2. Публичное название ресурса для которого используется этот файл.
3. Мы настроим для вас портал sandbox с включенным Объединённым поиском.
4. Вы получите учетные данные для доступа к порталу sandbox, где сможете протестировать работу поиска или ИИ Помощника с вашими данными.

Обратная связь

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