Клиенты спрашивают о вашем продукте у ИИ. Что он им отвечает?
Представьте: клиент не может разобраться с настройкой в вашем сервисе. Ещё пару лет назад он открыл бы справку или написал в поддержку. Сегодня он всё чаще спрашивает у ИИ-ассистента. И ответ, который он получит, зависит от того, нашёл ли ассистент вашу документацию и смог ли её прочитать.
Если не смог, ассистент возьмёт ответ из того, что найдёт: из старой статьи на форуме, из обзора трёхлетней давности, из документации похожего продукта. Клиент получит неточную инструкцию, потратит время и придёт в поддержку уже раздражённым. Или решит, что продукт сложный, и уйдёт к конкуренту.
Поэтому вопрос «видят ли ИИ-инструменты нашу документацию» постепенно становится вопросом не только для технических писателей, но и для тех, кто отвечает за поддержку и удержание клиентов.
Что мешает ИИ читать документацию
Справочный портал сделан для людей: меню, панели навигации, кнопки, футеры. Человек всё это пропускает взглядом. ИИ-агент получает страницу целиком, и полезный текст для него перемешан с интерфейсом. Чем больше на странице служебных элементов, тем выше шанс, что агент поймёт её неправильно.
Что изменилось в Документерре
В ноябрьском обновлении порталы Документерры помогают ИИ-агентам находить открытую документацию и получать только содержимое страниц, без меню и кнопок. Отдельно настраивать ничего не нужно.
При этом контроль остаётся у вас. Что видят агенты, определяется настройками видимости публикаций: закрытая документация остаётся закрытой. Файл robots.txt по-прежнему указывает поисковым роботам, какие страницы обходить.
Что можно сделать уже сейчас
Если вы ведёте документацию в Документерре, есть три простых шага, которые помогут ИИ-инструментам работать с ней точнее:
— держите хотя бы одну публикацию открытой: агенты работают только с публичной документацией;
— включите MCP-сервер опубликованной документации, чтобы читатели могли подключать свои ИИ-ассистенты напрямую к вашим страницам;
— проверьте robots.txt: если в нём стоит запрет на всё, портал не будет показывать себя агентам.
Что ещё в обновлении
Для команд документации есть и другие изменения. Перед заменой файла или удалением проекта можно за пару секунд увидеть, какие страницы на него ссылаются, даже на больших порталах. В новом шаблоне читательского интерфейса Next работают почти все настройки классических шаблонов и несколько новых. А доступом к закрытой документации можно управлять через API и связать его с CRM или системой подписок: например, клиент автоматически получает доступ к документации по тем продуктам, которыми пользуется.
Подробнее — в описании обновления.