База знаний

База знаний — это файлы, которые агент читает целиком и использует для ответов. В отличие от системного промпта, базу удобно собирать из готовых документов: FAQ, инструкции, прайс, описание продукта.

Как добавить файлы

1. На странице агента → вкладка «Настройки» → блок «База знаний».
2. Кнопка «Добавить файлы» открывает файловый менеджер.
3. Выберите файлы — они привяжутся к агенту.
4. Сохраните изменения.

Можно прикрепить до 20 файлов на одного агента.

Поддерживаемые форматы

Текстовые файлы читаются полностью:

• .txt, .md — обычный текст и Markdown
• .json, .xml — структурированные данные
• .csv — таблицы (читаются как текст)
• .html — HTML-разметка

Бинарные файлы (PDF, DOCX, изображения) — пока не парсятся, агент видит только имя файла. Если нужно содержимое PDF — конвертируйте в Markdown заранее.

Лимиты

• Размер одного файла — до 1 MB. Большие — пропускаются с пометкой.
• Суммарный объём содержимого — до 50 000 символов на запрос. Если файлов больше, обрезается с конца.
• На каждый запрос к боту база подмешивается в системный промпт целиком — это влияет на стоимость токенов.

Что класть в базу

Хорошие кандидаты:

• FAQ — список частых вопросов и ответов
• Прайс — цены, тарифы, условия доставки
• Описания услуг/продуктов с характеристиками
• Политики возврата, условия гарантии
• Скрипты для типовых ситуаций
• Базу преподавателей / врачей / специалистов с экспертизой

Плохие кандидаты:

• Код/документация в большом объёме (быстро упрётесь в лимит)
• Логи и сырые данные
• Конфиденциальные документы (помните: каждый запрос отправляется в OpenAI/DeepSeek/Anthropic)

Лучшие практики промпта

1. Структурируйте файлы

Бот лучше работает со структурированными данными. Например, для FAQ:

# FAQ интернет-магазина

## Доставка

**Сколько стоит доставка?**
По Москве — 300₽, по России — от 500₽ (рассчитывается калькулятором).

**Сколько идёт посылка?**
По Москве — 1–2 дня, по России — 3–7 дней в зависимости от региона.

## Возврат

**Какой срок возврата?**
14 дней с момента получения, товар должен быть в оригинальной упаковке.

2. Сошлитесь на базу из системного промпта

Используй базу знаний для ответов на вопросы клиентов.
Если вопроса нет в базе — скажи "уточню у менеджера" и попроси email.

3. Разделяйте «факты» и «инструкции»

• Факты (что есть в магазине, какие цены) — в базе знаний.
• Инструкции (как себя вести, какой тон) — в системном промпте.

Так проще обновлять — поменяли прайс, перезалили файл, промпт не трогаете.

4. Используйте теги

Если файлов много, теги в названиях помогают модели:

[ТАРИФЫ] start.md → описание тарифа Старт
[ТАРИФЫ] pro.md → описание тарифа Pro
[FAQ] payment.md → вопросы по оплате

Когда обновляется база

База подгружается на каждый запрос к агенту — нет кэша на стороне Framix. Если вы поменяли файл — следующий ответ бота уже учтёт изменения. Никаких «пересборок» делать не надо.

Влияние на стоимость

База знаний идёт в системный промпт каждого запроса → тратит токены на вход. С большой базой:

• Один запрос обходится дороже на ~$0.001–0.01 (зависит от размера)
• Но prompt cache (Anthropic, DeepSeek) даёт скидку 90% на повторные обращения в течение часа — поэтому в активном диалоге переплата минимальная.

См. Модели и расходы для деталей.