Руководства
Пошаговые инструкции для эффективной работы с Pravia — от регистрации до продвинутой настройки.
Начало работы
Создание первого AI-сотрудника
1. Зарегистрируйтесь на pravia.dev. 2. В дашборде нажмите «Создать». 3. Введите имя и описание. 4. Добавьте источники знаний — импорт с сайта, sitemap, загрузка PDF/Word/Markdown или вставка текста. 5. Нажмите «Опубликовать» — бот готов к работе. Скопируйте код виджета и вставьте на сайт перед закрывающим тегом </body>.
Загрузка и управление документами
Источники знаний: загрузка PDF, Word (.docx), Markdown, TXT файлов, импорт с URL сайта, парсинг Sitemap XML или вставка текста. Система автоматически подготавливает материалы для поиска — AI будет находить нужные фрагменты и отвечать на их основе. Управление: в разделе «База знаний» вы видите все источники. Удалите устаревший документ — бот перестанет использовать его данные. Загрузите обновлённую версию — бот начнёт отвечать по новой информации. Совет: используйте чёткие заголовки и структуру в документах — это улучшает точность ответов.
Подготовка документов
Оптимизация документов для AI
Используйте заголовки (H1, H2, H3) для разделения тем — бот точнее находит релевантные секции. Пишите короткие абзацы (3–5 предложений) — длинные хуже понимаются и теряют смысл. Добавляйте ключевые слова в начало абзаца — так AI точнее находит нужный раздел. Избегайте таблиц без контекста — AI хуже понимает табличные данные. Формулируйте вопросы и ответы в тексте — бот лучше отвечает на вопросы, похожие по структуре на исходный документ.
Мульти-язычный контент
Pravia обрабатывает документы на любом языке. Для мультиязычного AI-сотрудника: загрузите документы на обоих языках в одного бота — система определит язык запроса и найдёт ответ на нужном языке. Важно: не смешивайте языки в одном документе — это снижает точность. Совет: создайте отдельные версии документа для каждого языка с одинаковой структурой. Приветствие бота настройте на нужном языке через настройки виджета.
Настройка AI-сотрудника
Кастомизация внешнего вида
В настройках AI-сотрудника → «Виджет»: 1. Цвет акцента — основной цвет кнопки и заголовка чата (по умолчанию чёрный). 2. Приветственное сообщение — текст, который бот пишет первым (например: «Привет! Я помогу с вопросами о наших услугах»). 3. Позиция на странице — правый нижний угол (по умолчанию) или левый. 4. Имя бота — отображается в заголовке виджета. 5. Аватар — загрузите логотип вашей компании. После сохранения изменений обновите страницу — виджет обновится автоматически.
Правила поведения
Настройте инструкции для AI-сотрудника в его настройках, чтобы задать тон ответов. Пример: «Отвечай дружелюбно и по существу. Если не знаешь ответ — скажи «Обратитесь в поддержку». Не придумывай информацию.» Эскалация на оператора: добавьте правило «Если клиент просит соединить с оператором — ответь «Сейчас соединю вас с менеджером»». Ограничение тем: укажите «Отвечай ТОЛЬКО по документам о [тема]. На другие вопросы отвечай «Я специализируюсь на [тема]»».
Встраивание и интеграция
Встраивание на сайт
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%+ ответов «из документов» к концу первой недели.
Технические материалы
Как AI находит ответы в ваших материалах
Когда вы загружаете документ, Pravia подготавливает его для поиска. Когда пользователь задаёт вопрос, AI находит подходящие разделы из ваших материалов и формирует ответ на их основе. Если нужной информации нет в источниках, AI не пытается угадать ответ. Преимущество: ответы опираются на ваши материалы.
Безопасность и конфиденциальность
Защита данных: 1. Шифрование — все данные шифруются при передаче (TLS 1.3). 2. Изоляция — каждый аккаунт видит ТОЛЬКО свои данные (multi-tenancy). 3. Нет обучения на ваших данных — AI не использует ваши документы для обучения моделей. 4. Удаление — удалите аккаунт, и все данные удаляются безвозвратно немедленно. 5. Доступ — только вы и авторизованные пользователи видят ваших AI-сотрудников и документы. Соответствие: GDPR, SOC 2 (в процессе). Вопросы безопасности: [email protected]
Помощь по AI-сотруднику и частые вопросы
На что AI-сотрудник может и не может отвечать
AI-сотрудник отвечает ТОЛЬКО по загруженным вами документам. Он может: отвечать на вопросы о ваших продуктах, услугах, регламентах и процедурах; давать пошаговые инструкции из вашей документации; помогать пользователям находить нужную информацию в базе знаний. Он не может: обращаться к интернету и свежим данным; отвечать на вопросы за пределами загруженных документов; помнить предыдущие разговоры (каждый вопрос обрабатывается отдельно); обращаться к внешним базам данных и API. Если ответа нет в ваших документах, AI-сотрудник скажет: «Не могу найти ответ на этот вопрос в загруженных документах».
Что происходит, когда AI-сотрудник не может ответить
Когда AI-сотрудник не может ответить, он показывает одно из этих сообщений: 1. Документы не загружены: «Документы ещё не загружены. Загрузите документы в разделе «Источники знаний», и я смогу отвечать на вопросы по вашей базе знаний». 2. Нужная информация не найдена: «Не могу найти ответ на этот вопрос в загруженных документах». 3. Не настроен поставщик AI: «Документы не загружены. Загрузите документы или настройте поставщика AI, чтобы получать развёрнутые ответы». Во всех случаях AI-сотрудник предложит обратиться в поддержку. Это поведение можно изменить в настройках инструкций AI-сотрудника.
Как получить ответ на незакрытый вопрос
Если AI-сотрудник не смог ответить: 1. Проверьте, есть ли нужная информация в загруженных документах. 2. Попробуйте переформулировать вопрос другими словами. 3. Обратитесь к администратору AI-сотрудника, чтобы он добавил недостающую информацию. Если вы видите сообщение «Не могу найти ответ», нажмите на ссылку поддержки в виджете или напишите на [email protected]. Администраторам: смотрите незакрытые вопросы в разделе «Аналитика» → «Частые вопросы», чтобы найти пробелы в знаниях, и загрузите недостающие документы.
Если что-то не работает
AI-сотрудник не отвечает: проверьте, что он активен (зелёный статус в дашборде). Убедитесь, что код встраивания установлен правильно. Проверьте, что задан DEEPSEEK_API_KEY. Ответы не по теме: возможно, нужный документ не загружен — посмотрите долю ответов «из документов» в аналитике и загрузите недостающие материалы. Отвечает слишком долго: обычное время ответа — 1–3 секунды. Проверьте состояние вашего поставщика AI. Уменьшите объём документов, чтобы они обрабатывались быстрее. Виджет не появляется: очистите кэш браузера, проверьте консоль на ошибки JavaScript и убедитесь, что идентификатор AI-сотрудника в коде встраивания совпадает с вашим.
Начните с руководства «Создание первого бота» — оно проведёт вас через все этапы за 5 минут.
Сохраните эту страницу в закладки — мы регулярно добавляем новые руководства.