База знаний

Knowledge Base является основой вашего AI-агента Quickchat AI. Она определяет, что агент знает о компании, продуктах и услугах. Полная и хорошо организованная база знаний помогает эффективно отвечать на вопросы пользователей и давать точные ответы.

В этом руководстве описаны возможности базы знаний, подходы к её построению и способы улучшить её работу.

Для страниц тарифов и помощи, которые регулярно меняются, начните со статей, связанных с URL, и ежедневного Auto-refresh на платном тарифе. Важные изменения обновляйте вручную, не дожидаясь следующей ежедневной проверки. Можно попросить ChatGPT или Claude настроить это через подключение к вашему аккаунту Quickchat.

Источники данных

Панель инструментов вверху страницы Knowledge Base позволяет добавлять знания из следующих источников:

Add Article

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

Совет

Посвящайте каждую статью одной теме. Длинные статьи с несколькими темами затрудняют поиск информации. Разделение на части помогает AI давать более чёткие ответы.

Add Paragraph

Короткие самостоятельные факты, которым не нужна целая статья. Абзацы объединяются, например в папку “Single Paragraphs”, и используются как небольшие единицы знаний. Подходят для фраз вроде “Доставка занимает 3–5 рабочих дней” или “Возврат принимается в течение 30 дней”.

Add Website

Импорт содержимого по любому URL. Доступно четыре режима:

• Single Page: импорт одной веб-страницы. В Advanced options → HTML selector можно ограничить импорт определённой частью страницы, например main, #article-body или .docs-content, если остальное содержимое состоит из меню, рекламы или подвала.
• Multiple Pages: вставьте список URL; каждый станет отдельной статьёй.
• Sitemap: укажите sitemap.xml; каждая страница карты сайта импортируется отдельной статьёй. Особенно удобно для документации и структурированных блогов.
• All Pages: обход всех доступных URL на домене. Используйте для полного импорта документации или корпоративного блога.

URL остаются связанными с источниками, поэтому содержимое можно обновлять автоматически или по запросу. См. Поддержание актуальности статей из URL.

Публичная проверка извлечения (две страницы-примера)

Хотите увидеть, что возвращает поставщик извлечения Quickchat, до создания аккаунта или импорта статьи? Откройте публичную проверку извлечения. Эта экспериментальная проверка поддерживает только две страницы-примера: нашу страницу тарифов и это руководство Knowledge Base на английском. Укажите в вопросе один из этих точных URL и содержимое, которое хотите проверить. Вход или подключение аккаунта не требуются.

Результат содержит свежий извлечённый текст, время проверки, настройки и сведения о сбоях извлечения. Выполняется одна попытка со стандартным фильтром основного содержимого, без собственного селектора и обычных повторных попыток импорта. Текст может быть сокращён, поэтому отсутствие фрагмента в результате не доказывает, что его не было в полном извлечённом содержимом.

Проверка не создаёт аккаунт и не импортирует статью, а также не подтверждает успешный импорт или будущие ответы AI.

Автоматическое обновление

Статьи, связанные с URL, могут повторно загружать содержимое раз в день, чтобы база знаний следовала за источником без ручного вмешательства.

Перед использованием важно знать три вещи:

• Настройка действует для каждой статьи отдельно, а не для всего аккаунта. Включайте её для статей, которые нужно синхронизировать.
• Она доступна только на платных тарифах. На Free используйте описанное выше ручное обновление.
• Редактирование содержимого статьи вручную отключает обновление для этой статьи. Это сделано намеренно: иначе ежедневная загрузка перезаписала бы ваши правки следующим утром. Поэтому отредактированная вручную страница перестаёт отслеживать источник, пока вы снова не включите обновление.

Изменить ежедневный интервал нельзя.

Upload File

Загружайте документы PDF, Word, PowerPoint, Excel/CSV и другие файлы. Для сканированных изображений применяется OCR. Текст извлекается и индексируется автоматически. Максимальный размер файла: 32 MB, а для текстовых файлов, например txt, md, csv и json, 1 MB. Более крупный текстовый файл разделите на части и загрузите их отдельно.

Shopify MCP

Подключите магазин Shopify, чтобы AI отвечал на основе актуального каталога, сведений о товарах и правил магазина. Для настройки вставьте URL магазина. Внутри создаётся Custom Action Shopify MCP, которой также можно управлять в Actions & MCPs. См. Пользовательские действия, включая объяснение, почему для статуса заказа нужно отдельное действие.

Intercom Articles

Импортируйте сразу все статьи подключённого Intercom Help Center. Сначала необходимо подключить Intercom в External Apps → Intercom. Повторный импорт синхронизирует новые и обновлённые статьи.

YouTube

Вставьте URL YouTube, чтобы импортировать расшифровку видео как статью. Это удобно для обучающих каналов и обзоров продукта, которые не хочется переписывать вручную.

Поддержание актуальности статей из URL

Статьи из URL сохраняют связь со страницей-источником, поэтому их можно обновлять без повторного ручного импорта. Есть два способа: Auto-refresh, который выполняется автоматически каждый день, и ручное обновление, которое вы запускаете по запросу. Оба заменяют содержимое статьи последней версией опубликованной страницы и затем автоматически переобучают AI-агента.

Краткий справочник со ссылками на источники: Обновления сайта: ежедневное обновление, новые страницы и срочные изменения цен.

Нужна помощь с выбором способа поддержания знаний в актуальном состоянии? Спросите Quickchat о своей конфигурации, чтобы получить ответ AI со ссылками на публичную документацию. Вход или подключение аккаунта не требуются.

Управление обновлениями через ChatGPT или Claude

Для небольшого набора меняющихся страниц самый простой подход: ежедневное обновление и ручное обновление при важных изменениях. Подключите аккаунт по руководству Управление через AI, назовите агента и укажите URL источников. Например:

Помоги поддерживать актуальность страниц тарифов и помощи у моего агента на сайте. Проверь, какие из этих URL уже есть в его Knowledge Base, добавь недостающие страницы и включи ежедневное автообновление, если мой тариф его поддерживает. Перед применением покажи предлагаемые изменения.

Подключение может добавлять страницы, обновлять существующие статьи из URL и управлять их автоматическим обновлением. Оно использует вход Quickchat, поэтому для этих задач не нужны API-ключ разработчика или собственный скрипт синхронизации. Автоматическое обновление требует платного тарифа; ручное обновление URL доступно на Free.

Не усложняйте процесс:

1. Сначала обновляйте исходный сайт. Не храните противоречащие друг другу копии цен или правил в разных статьях.
2. После важного изменения попросите подключённое AI-приложение обновить соответствующий URL, затем проверьте статус Ready и протестируйте ответ.
3. Регулярно проверяйте ошибки обновления и вопросы клиентов без ответа. Можно попросить подключённое AI-приложение просмотреть недавние беседы, а затем решить, какие знания нужно улучшить.
4. Отдельно добавляйте новые URL и проверяйте снятые с публикации страницы. Ежедневное обновление следит за выбранными статьями, но не обнаруживает новые страницы карты сайта автоматически. Ручное редактирование статьи отключает её автообновление.

Если нужна собственная синхронизация, сначала проверьте отдельные требования тарифа для REST API. Ежедневное обновление не является запросом в реальном времени. Используйте Action, если для ответа нужно обратиться к действующей системе.

Auto-refresh

Включите Auto-refresh для статьи из URL, и Quickchat будет проверять источник раз в день и автоматически обновлять статью при изменениях. Это поддерживает синхронизацию знаний без ручной работы.

Заметка

Автоматическое обновление URL доступно на платных тарифах.

Как включить

• Для одной статьи: откройте статью и включите Auto-refresh в правой панели метаданных либо используйте переключатель Auto-refresh URL в строке статьи.
• Из меню строки: нажмите меню ”…” у статьи из URL и выберите Auto-refresh URL.
• Сразу для нескольких: отметьте статьи из URL флажками и нажмите Auto-refresh URLs (N) на панели выбранных элементов.

Пока Auto-refresh включён, статья синхронизируется с источником, а её содержимое доступно только для чтения. Показывается сообщение “This article is in sync with its source. Turn off auto-refresh to edit.” Чтобы изменить текст самостоятельно, нажмите Turn off & edit или отключите Auto-refresh. Редактирование статьи из URL автоматически отключает Auto-refresh, чтобы последующее обновление не перезаписало ваши изменения.

Поле Last Refreshed в панели метаданных показывает время последнего обновления из источника.

Если обновление завершается ошибкой, последняя сохранённая версия остаётся активной, и AI-агент продолжает её использовать. Статус, причины и повторные попытки описаны в разделе Если обновление URL не удалось.

Ручное обновление

Чтобы получить актуальное содержимое прямо сейчас, не дожидаясь ежедневной проверки:

• Для одной статьи: откройте её и нажмите Refresh URL Manually в панели метаданных либо выберите Manually refresh URL в меню ”…” строки.
• Сразу для нескольких: выберите статьи из URL и нажмите Manually refresh URLs (N). Чтобы заново загрузить все статьи, связанные с URL, используйте Refresh all URLs в правом верхнем углу.

Ручное обновление заменяет ваши правки содержимым опубликованной страницы, поэтому перед перезаписью отредактированных статей Quickchat запрашивает подтверждение. Массовое обновление охватывает до 1,000 статей из URL за один раз.

Советы по созданию эффективной базы знаний

Каждая загруженная текстовая статья, страница из URL или PDF должна быть самостоятельной, полной и подробно раскрывать тему. Хорошо организованная база знаний даёт AI-агенту контекст для полезных ответов.

Следующие советы помогут подготовить агента к работе:

Шаги по созданию и улучшению базы знаний

1. Чётко определите назначение
   Определите роль AI-агента и типы вопросов, на которые он будет отвечать. Организуйте знания по категориям с учётом потребностей и сценариев пользователей.

   Пример AI-агента для интернет-магазина:

   • Просмотр и выбор товаров: характеристики, сравнения и частые вопросы.
   • Покупка: способы оплаты, промокоды и налоги.
   • Доставка: отправка, изменение заказов и отслеживание.

   Пример AI-агента для студенческих кредитов:

   • До подачи заявки: требования к заёмщику и условия кредита.
   • Подача заявки: руководства, условия и пошаговые инструкции.
   • После окончания учёбы: графики погашения и отсрочки.

2. Обеспечьте качество данных
   Качество ответов AI зависит от загруженных данных. Обратите внимание на:

   • Читаемость: удаляйте не относящуюся к теме информацию, таблицы и лишние заголовки из загружаемого содержимого.
   • Релевантность: убедитесь, что содержимое отвечает на распространённые вопросы и соответствует ожиданиям пользователей.
   • Согласованность: избегайте противоречий и устаревших сведений, соблюдайте единый формат, например дат и цен.
   • Только текст: поскольку изображения не поддерживаются, передавайте важную информацию текстом.

3. Ставьте ясность на первое место
   Каждая статья должна быть понятной, краткой и удобной для чтения. Стройте абзацы логично и включайте только нужные детали.

4. Будьте исчерпывающими
   Добавляйте как можно больше подробностей, чтобы AI-агент мог отвечать на сложные вопросы.

5. Используйте ответы вместо пар «вопрос-ответ»
   Предоставляйте полную информацию, а не отдельные пары вопросов и ответов. AI-агент сам извлечёт нужные детали.

6. Встраивайте URL в текст
   Всегда включайте URL в текст для перехода к источникам. Даже при загрузке через URL ссылки на товары и формы внутри текста повышают удобство использования.

   Пример:
   Для AI-агента интернет-магазина добавляйте ссылки на формы, например отмены заказа:
   “Чтобы отменить заказ, отправьте запрос здесь: https://example.com/cancel-order.”

7. Тщательно тестируйте
   Тестирование необходимо для улучшения базы знаний. Имитируйте взаимодействия пользователей, находите пробелы и противоречия, затем корректируйте содержимое.

Частые проблемы

• AI-агент пропускает ссылки или не включает URL в ответы Убедитесь, что нужные ссылки встроены в текст каждой статьи.
• Повторяющаяся или избыточная информация Не загружайте одинаковое содержимое в несколько статей.
• В ответах отсутствуют важные детали Рассмотрите отдельные статьи для конкретных сведений, например критериев или особых случаев.
• Неверные даты или цены Проверяйте и обновляйте все статьи, чтобы сохранять точность.

Создание эффективной базы знаний является итеративным процессом. Начните с ясных целей, логично организуйте содержимое и регулярно проверяйте работу AI-агента.

Заметка

Если вам нужна помощь в настройке Knowledge Base или собственные интеграции, напишите на contact@quickchat.ai.

Поиск

Функция Search позволяет быстро находить статьи в Knowledge Base, выполняя поиск и по заголовкам, и по содержимому.

Как пользоваться поиском

1. Введите ключевые слова или фразы в поле Search вверху интерфейса управления знаниями.
2. Результаты сразу обновятся и покажут статьи, содержащие введённый текст в заголовке или основном содержимом.

Множественный выбор и массовое удаление

Множественный выбор и массовое удаление упрощают работу сразу с несколькими статьями Knowledge Base.

Как выбрать несколько статей

1. Откройте список Knowledge Base
2. Нажмите “…” рядом с нужной статьёй и выберите “Select”
3. Отметьте флажки слева от нужных статей. Можно выбрать одну или несколько одновременно
4. Выбранные статьи останутся выделенными для дальнейших действий

Как удалить несколько статей

1. После выбора статей нажмите Delete внизу, чтобы удалить выбранные элементы
2. Подтвердите действие, чтобы окончательно удалить все выбранные статьи

Теги

Теги помогают организовать Knowledge Base и позволяют AI-агенту сузить список статей для конкретного вопроса. Они отображаются в каждой строке статьи и в фильтре вверху списка.

Добавить тег можно двумя способами:

• Вручную: откройте статью и используйте + Add Tag в правой панели метаданных.
• Auto-tag with AI: нажмите Auto-tag with AI в той же панели. Quickchat прочитает статью и предложит теги по содержимому. Это удобно после массового импорта через Sitemap, All Pages или Intercom, когда размечать сотни статей вручную непрактично.

Фильтр Tags на панели инструментов показывает статьи, соответствующие одному или нескольким тегам.

Как изменения становятся активными

Отдельного этапа переобучения или кнопки запуска нет. Каждое изменение Knowledge Base автоматически обрабатывается в фоне, по одной статье за раз. Повторно обрабатываются только изменённые статьи, поэтому остальная база знаний всё это время продолжает использоваться для ответов.

Это касается любого изменения: добавления, редактирования или удаления статьи, импорта сайта или файла, ручного обновления URL и ежедневного автоматического обновления.

Статус статьи

В каждой строке списка Knowledge Base есть столбец Status:

Статус	Значение
Pending	В очереди, ожидает обработки.
Processing	Обрабатывается прямо сейчас.
Ready	Активна. AI-агент использует эту статью.
Failed	Обработка не завершена. См. Если статья не обработалась.
Refresh failed	Обновление URL завершилось ошибкой. AI-агент продолжает использовать последнюю сохранённую версию.

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

Пока обработка не завершена, вверху приложения отображается “N articles still processing”. Сообщение исчезает, когда всё готово. Большинство статей получают Ready за несколько секунд. Крупный импорт занимает больше времени, потому что статьи обрабатываются пакетами.

Когда статья становится активной

Как только статья получает Ready, она одновременно становится доступной везде: в установленном виджете, во всех подключённых каналах, в API и в AI Preview. Отдельной публикации или развёртывания нет, как нет и промежуточной черновой копии Knowledge Base между вами и агентом.

Осторожно

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

Если обновление URL не удалось

Статья из URL со статусом Refresh failed продолжает работать на основе последней сохранённой Quickchat версии. Наведите курсор на статус, чтобы узнать причину: например, страница недоступна, требует входа, перенаправляет на другой сайт или содержит нечитаемые данные.

Quickchat повторяет попытки при временных сбоях. Если источник остаётся недоступным в течение 14 дней попыток обновления, автоматические проверки останавливаются, чтобы не запрашивать постоянно недоступную страницу снова и снова. После исправления источника выберите Manually refresh URL. Успешное обновление убирает ошибку и возобновляет автоматические проверки. Также можно снова выбрать Auto-refresh URL, чтобы начать новый период повторных попыток.

Если статья не обработалась

Статья со статусом Failed просто не используется AI-агентом. Остальная Knowledge Base не затронута, и агент продолжает отвечать на основе всего, что имеет статус Ready.

Большинство ошибок временные, и Quickchat автоматически повторяет обработку, поэтому они обычно исчезают сами. Если не хотите ждать, нажмите Retry рядом с сообщением “N failed to process” вверху приложения, чтобы сразу повторить обработку всех неудачных статей.

Если статья продолжает завершаться ошибкой, обычно проблема в источнике: пустая страница, файл без извлекаемого текста или неработающий URL. Откройте статью и проверьте, что было импортировано, либо импортируйте её заново из работающего источника. Если проблема остаётся, напишите на contact@quickchat.ai.

Всё остальное применяется сразу

Обработку проходит только содержимое Knowledge Base. Настройки Identity, AI Personality, Languages, Actions, ответы Inbox, Insights и Conversation Rating применяются сразу после сохранения.