Документацію зручно давати ШІ-асистенту як контекст: він відповідатиме на питання про інтеграцію, ґрунтуючись на актуальних інструкціях.
Способи
| Що | Де | Формат |
|---|---|---|
| Одна сторінка | Кнопки ⬇ PDF і ⬇ MD угорі сторінки | PDF / Markdown |
| Увесь розділ продукту | «⬇ Весь розділ одним PDF» у лівому меню або на сторінці Документація | PDF з відкритим змістом і закладками |
| Розділ у Markdown | /api/docs/bundle?space=ssai&format=md |
Markdown |
| Уся публічна база | /llms-full.txt | текст |
| Індекс для ШІ-агентів | /llms.txt | за стандартом llms.txt |
Вивантаження робиться мовою, обраною на порталі (додайте до посилання &lang=uk, &lang=en або &lang=ru, щоб обрати явно), і враховує ваші права: у файл потрапляють лише сторінки, які ви бачите на порталі.
Що саме в файлі
- Справжній текст (не картинки) — ШІ його читає без розпізнавання.
- Абсолютні посилання: внутрішні посилання між сторінками, зображення та відео ведуть на портал, тож файл зрозумілий і поза ним.
- Шапка з джерелом: адреса сторінки, мова, продукт, рівень доступу, дата оновлення.
- Відео в PDF — посиланням (відтворюються на порталі).
Порада
Для ШІ краще Markdown: він компактніший і зберігає структуру таблиць. PDF — для людей і для асистентів, які приймають лише PDF.
Увага
Матеріали «для клієнтів» конфіденційні. Не завантажуйте їх у публічні ШІ-сервіси, якщо політика вашої компанії цього не дозволяє.