Руководства
Пошаговые инструкции для эффективной работы с Pravia — от регистрации до продвинутой настройки.
Начало работы
Создание первого бота
1. Зарегистрируйтесь на pravia.dev. 2. В дашборде нажмите «Создать бота». 3. Введите имя и описание — бот будет представляться клиентам. 4. Загрузите документы (PDF, Markdown) — это база знаний бота. 5. Нажмите «Опубликовать» — бот готов к работе. Скопируйте код виджета и вставьте на сайт перед закрывающим тегом </body>.
Загрузка и управление документами
Загрузка: перетащите файлы в область загрузки или выберите через диалог. Поддерживаемые форматы: PDF (до 10 МБ), Markdown (.md, .markdown). Система автоматически разбивает документ на фрагменты (чанки) по 500–1000 слов и создаёт эмбеддинги для семантического поиска. Управление: в разделе «Документы» вы видите список загруженных файлов. Удалите устаревший документ — бот перестанет использовать его данные. Загрузите обновлённую версию — бот начнёт отвечать по новой информации. Совет: используйте чёткие заголовки и структуру в документах — это улучшает точность ответов.
Подготовка документов
Оптимизация документов для AI
Используйте заголовки (H1, H2, H3) для разделения тем — бот точнее находит релевантные секции. Пишите короткие абзацы (3–5 предложений) — длинные абзацы разбиваются на фрагменты с потерей контекста. Добавляйте ключевые термины в начало абзаца — семантический поиск ранжирует по релевантности. Избегайте таблиц без контекста — AI хуже понимает табличные данные. Формулируйте вопросы и ответы в тексте — бот лучше отвечает на вопросы, похожие по структуре на исходный документ.
Мульти-язычный контент
Pravia обрабатывает документы на любом языке. Для мультиязычного бота: загрузите документы на обоих языках в одного бота — система определит язык запроса и найдёт ответ на нужном языке. Важно: не смешивайте языки в одном документе — это снижает точность. Совет: создайте отдельные версии документа для каждого языка с одинаковой структурой. Приветствие бота настройте на нужном языке через настройки виджета.
Настройка чат-бота
Кастомизация внешнего вида
В настройках бота → «Виджет»: 1. Цвет акцента — основной цвет кнопки и заголовка чата (по умолчанию чёрный). 2. Приветственное сообщение — текст, который бот пишет первым (например: «Привет! Я помогу с вопросами о наших услугах»). 3. Позиция на странице — правый нижний угол (по умолчанию) или левый. 4. Имя бота — отображается в заголовке виджета. 5. Аватар — загрузите логотип вашей компании. После сохранения изменений обновите страницу — виджет обновится автоматически.
Правила поведения
Настройте системный промпт в настройках бота, чтобы задать тон ответов. Пример: «Отвечай дружелюбно и по существу. Если не знаешь ответ — скажи «Обратитесь в поддержку». Не придумывай информацию.» Эскалация на оператора: добавьте в промпт правило «Если клиент просит соединить с оператором — ответь «Сейчас соединю вас с менеджером»». Ограничение тем: указайте «Отвечай ТОЛЬКО по документам о [тема]. На другие вопросы отвечай «Я специализируюсь на [тема]»».
Встраивание и интеграция
Встраивание на сайт
HTML (любой сайт): добавьте перед </body>: <script src="https://pravia.dev/loader.js" data-bot-id="ВАШ_ID"></script> WordPress: добавьте виджет «Custom HTML» в Внешний вид → Виджеты → вставьте код. Shopify: Online Store → Themes → Edit code → theme.liquid → вставьте перед </body>. Webflow: Site Settings → Custom Code → Footer Code → вставьте код. Wix: Settings → Custom Code → Head Code → вставьте. После вставки кода виджет появится на всех страницах сайта автоматически.
Интеграция с React
Добавьте виджет в React-приложение через useEffect: import { useEffect } from 'react'; function ChatWidget({ botId }) { useEffect(() => { const script = document.createElement('script'); script.src = '/loader.js'; script.setAttribute('data-bot-id', botId); document.body.appendChild(script); }, [botId]); return null; } Виджет рендерится в iframe и не влияет на стили вашего приложения.
Аналитика и мониторинг
Панель аналитики
В дашборде → «Аналитика» вы видите: 1. Количество диалогов за период (день/неделя/месяц). 2. Топ-10 самых частых вопросов — используйте это для улучшения документации. 3. Процент ответов «из документов» vs «AI не нашёл ответ» — если много пропусков, добавьте документы. 4. Среднее время ответа — норма: 1–3 секунды. 5. Удовлетворённость пользователей (если включена оценка ответов). Экспорт: данные доступны в формате CSV для анализа в Excel.
Мониторинг качества
Регулярно проверяйте диалоги в разделе «История»: 1. Найдите вопросы, на которые бот ответил «Я не знаю» — загрузите соответствующий документ. 2. Проверьте ответы с низкой оценкой (1–2 звезды) — скорректируйте промпт или добавьте информацию. 3. Ищите повторяющиеся вопросы — создайте отдельный документ-FAQ. 4. Проверяйте цитирование — бот должен указывать источник. Если нет — улучшите структуру документа. Цель: 90%+ ответов «из документов» к концу первой недели.
Технические материалы
Как работает RAG-пайплайн
Retrieval-Augmented Generation (RAG) — архитектура, которая сочетает поиск по документам с генерацией ответа AI. Этапы: 1. Загрузка — документ разбивается на фрагменты (чанки) по 500–1000 слов. 2. Эмбеддинг — каждый фрагмент преобразуется в вектор (числовое представление смысла). 3. Хранение — векторы сохраняются в PostgreSQL с pgvector. 4. Запрос — вопрос пользователя тоже преобразуется в вектор. 5. Поиск — находятся 3–5 наиболее похожих фрагментов (cosine similarity). 6. Генерация — AI получает найденные фрагменты + вопрос и формирует ответ на основе только этих данных. Преимущество: бот не выдумывает — он опирается на загруженные документы.
Безопасность и конфиденциальность
Защита данных: 1. Шифрование — все данные шифруются при передаче (TLS 1.3) и хранении (AES-256). 2. Изоляция — каждый аккаунт видит ТОЛЬКО свои данные (multi-tenancy). 3. Нет обучения на ваших данных — AI не использует ваши документы для обучения моделей. 4. Удаление — удалите аккаунт, и все данные удаляются безвозвратно в течение 30 дней. 5. Доступ — только вы и авторизованные пользователи видят ботов и документы. Соответствие: GDPR, SOC 2 (в процессе). Вопросы безопасности: support@pravia.dev
Начните с руководства «Создание первого бота» — оно проведёт вас через все этапы за 5 минут.
Сохраните эту страницу в закладки — мы регулярно добавляем новые руководства.