База знаний для SaaS: что на самом деле нужно документации продукта

Почему документация SaaS — особая задача

Статичный корпоративный FAQ можно написать один раз и забыть. С документацией SaaS так не получится. Каждый релиз меняет экран, переименовывает настройку или добавляет функцию, и статья, которая была верной месяц назад, теперь порождает обращения. Большинство SaaS-компаний к тому же развивают несколько продуктов, редакций или white-label брендов, обслуживают клиентов на разных языках, и их документацию всё чаще читают ИИ-ассистенты, а не люди, листающие боковое меню.

Именно это сочетание — высокая скорость изменений, несколько аудиторий, несколько языков и машинные читатели — отличает базу знаний для SaaS от обычной вики или FAQ-модуля внутри хелпдеска. Используйте этот чек-лист при оценке любого сервиса, не только Multibase:

• Процесс релизов: история версий статей, ревью и согласование перед публикацией, отложенная публикация к дате запуска и автоматические редиректы при смене slug.
• Самообслуживание: ИИ-ответы на основе ваших статей со ссылками на источники и аналитика поиска, показывающая, что пользователи не смогли найти.
• Локализация: черновики для каждого языка, которые публикуются независимо, чтобы медленный перевод не задерживал релиз.
• Несколько продуктов: отдельный брендированный портал, домен и навигация для каждого продукта или редакции — в одном аккаунте.
• Закрытый контент: статьи, доступные только авторизованным клиентам или определённым группам клиентов.
• Доступ для ИИ и агентов: машиночитаемый способ для ассистентов вроде Claude или Cursor искать и читать вашу документацию.
• Предсказуемая цена: счёт, который не растёт с каждым новым агентом поддержки или брендом.

Документация в ритме релизов

Самое дешёвое обращение в поддержку — то, которое предотвратила статья, обновлённая до выхода релиза. В Multibase процесс в день релиза выглядит так:

1. Подготовьте обновлённые статьи в блочном редакторе, пока функция ещё в разработке. История версий сохраняет текущий опубликованный текст до момента публикации.
2. Отправьте черновики на ревью — ревьюеры комментируют и согласовывают их до публикации.
3. Запланируйте публикацию на дату и время релиза, чтобы документация и продукт вышли одновременно.
4. Если функцию переименовали, измените slug статьи. Multibase создаст редирект со старого URL, и ссылки из писем, приложения и поисковиков продолжат работать.
5. Добавьте запись в журнал изменений и отметьте ключевые статьи как избранные, чтобы вернувшиеся пользователи сразу увидели новое.

Меньше обращений благодаря ИИ-ответам и Gap Finder

Пользователям SaaS нужен ответ, а не десять ссылок. ИИ-чат для читателей в Multibase формирует ответ на основе ваших опубликованных статей, выводит его потоково и указывает статьи-источники, чтобы ответ можно было проверить. Если уверенность низкая, вместо догадок показывается обычный поиск.

Направьте ссылку «Помощь» в вашем приложении на портал — и ИИ-ответы станут первой линией поддержки. На платных тарифах Gap Finder замыкает цикл: неудачные поиски и вопросы без ответа превращаются в предложения статей, а аналитика показывает просмотры, поисковые запросы, использование ИИ и оценки статей. Команда документации работает над тем, что действительно порождает обращения.

ИИ-запросы включены в каждый тариф — 100/мес. на Starter, 1 000 на Growth, 5 000 на Scale и без ограничений на Enterprise. Дополнительные запросы стоят $20 за 1 000, а начиная с Growth можно подключить собственный ключ OpenAI или Anthropic.

Локализация для пользователей по всему миру

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

Для SaaS эта независимость важна. Английская статья выходит в день релиза, французская и итальянская версии — сразу после проверки, и ничто не ждёт самый медленный язык.

Отдельный портал для каждого продукта, редакции или бренда

Если вы продаёте несколько продуктов или white-label редакцию партнёрам, каждый из них получает свой портал со своим доменом (TLS настраивается автоматически), логотипом, цветами, шрифтами и пользовательским CSS — без подписи «Powered by Multibase» на платных тарифах. Все порталы управляются из одного аккаунта одной командой.

Для документации только для клиентов — руководств по настройке для enterprise, бета-функций, регламентов для партнёров — группы читателей ограничивают доступ к статьям авторизованными читателями. Количество авторизованных читателей не ограничено ни на одном тарифе.

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

Документация, понятная ИИ-ассистентам

Пользователи всё чаще спрашивают Claude или ассистента в IDE вместо того, чтобы открыть справочный центр. Каждый портал Multibase доступен как публичный MCP-эндпоинт (Model Context Protocol) только для чтения с инструментами search_kb, get_article, list_categories и list_articles. Любой MCP-клиент с поддержкой удалённых серверов Streamable HTTP сможет отвечать по вашей актуальной документации, а не по устаревшим обучающим данным.

Доступны только опубликованные публичные статьи, на эндпоинт действует ограничение частоты запросов, а MCP-поиски и чтения видны в аналитике с источником «MCP» — так вы видите, какая часть аудитории приходит через ИИ-инструменты.

Сколько это стоит на каждом этапе SaaS

Цены указаны при оплате за год; помесячная оплата на 20% дороже, цены без НДС. Тарифы фиксированные, поэтому найм агентов поддержки или новых авторов в пределах лимита администраторов не меняет счёт.

Когда Multibase не подходит

Multibase — это база знаний, а не хелпдеск: в нём нет тикетов и живого чата. Если вам нужен один поставщик для тикетов, чата и документации, такие пакеты, как Zendesk или Intercom, объединяют всё это — с оплатой за каждого агента. Если ваша документация — в основном справочник API для разработчиков, который ведётся в Git, инструмент docs-as-code вроде GitBook подойдёт лучше.

Сильнее всего Multibase там, где нужна клиентская справка по нескольким продуктам, брендам или языкам и где фиксированная цена и брендинг каждого портала важнее комплексного пакета поддержки.