Начало работы
Пример:
Массовый импорт через ZIP
Импортируйте несколько баз знаний разом через ZIP-архив
Вместо создания баз знаний по одной можно импортировать сразу несколько, загрузив ZIP-архив. Особенно полезно, когда у вас много баз знаний, подготовленных для агента.
Быстрый старт
- Откройте База знаний в боковой панели
- Нажмите «Import ZIP»
- Перетащите ZIP-архив в область загрузки
- Проверьте и отредактируйте результат парсинга
- Нажмите «Import»
Структура ZIP-архива
Простая структура (один агент)
Все файлы БЗ и файл TRIGGERS.md положите в корень архива:
support-agent.zip
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_setup.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
Вложенная структура (несколько агентов)
Можно организовать базы знаний по папкам. Каждая папка обрабатывается независимо со своим TRIGGERS.md:
all-agents.zip
├── Sales-Agent/
│ ├── KB01_platform_overview.md
│ ├── KB02_pricing_plans.md
│ ├── KB03_roi_calculator.md
│ ├── KB04_competitors.md
│ └── TRIGGERS.md
├── Tech-Support-Agent/
│ ├── KB01_widget_setup.md
│ ├── KB02_api_reference.md
│ ├── KB03_troubleshooting.md
│ └── TRIGGERS.md
└── Onboarding-Agent/
├── KB01_getting_started.md
├── KB02_first_agent.md
├── KB03_knowledge_base.md
├── KB04_phone_numbers.md
├── KB05_billing.md
└── TRIGGERS.md
Правила именования файлов
Файлы KB
Файлы KB должны начинаться с KB, за которым следует число:
| Допустимо | Недопустимо |
|---|---|
KB01_platform_overview.md | platform_overview.md |
KB02_pricing.md | 02_pricing.md |
KB1_faq.md | knowledge_base_1.md |
KB10_integrations.md | FAQ.md |
подсказка
Текст после числа необязателен и нужен только для вашего удобства. Система использует число, чтобы сопоставить KB-файлы с их промптами в TRIGGERS.md.
TRIGGERS.md
Файл должен называться ровно TRIGGERS.md (регистр не важен). Он содержит промпты (описания) для каждой базы знаний.
Формат KB-файла
Каждый KB-файл должен быть Markdown-файлом (.md), начинающимся с H1-заголовка (# Title). Этот заголовок становится именем базы знаний в системе.
Пример: KB01_platform_overview.md
# Говорило Platform Overview [sales]
## What is Говорило?
Говорило is an AI voice agent platform that allows businesses to create
intelligent voice assistants. These agents handle phone calls,
answer customer questions using knowledge bases, and integrate
with existing business tools.
## Key Features
- Unlimited AI voice agents on all plans
- Knowledge base with RAG technology
- SIP integration for phone systems
- Web widget for website calls
- Real-time analytics dashboard
Что извлекается
| Часть | Как используется |
|---|---|
H1-заголовок (# Title) | Имя базы знаний (макс. 100 символов) |
| Полное содержимое файла | Файл базы знаний (загружается как .md) |
внимание
Если у KB-файла нет H1-заголовка, в качестве имени будет использовано имя файла. Появится предупреждение, и имя можно будет отредактировать перед импортом.
Формат TRIGGERS.md
TRIGGERS.md задаёт промпт для каждой базы знаний. Промпт говорит агенту, когда и как использовать эту базу знаний.
Структура
Каждый раздел начинается с ## KB, за которым следует число (соответствующее номеру KB-файла). Текст ниже становится промптом.
## KB01
Говорило platform overview: what the product does, key features, and
benefits. Use when the customer asks what Говорило is, how it works,
or what problems it solves.
## KB02
Pricing plans and billing: Старт, Про, Бизнес, Корпоративный
with credit amounts and per-minute rates. Use when the customer asks about
costs, plans, or how billing works.
## KB03
Agent setup guide: step-by-step instructions for creating and
configuring a voice agent. Use when the customer asks how to create
an agent, configure settings, or write a prompt.
Гайдлайны промптов
| Правило | Детали |
|---|---|
| Макс. длина | 300 символов на промпт |
| Формат раздела | ## KB01, ## KB02 и т. д. |
| Содержимое | Опишите, что содержит БЗ и когда её использовать |
| Язык | Пишите на том же языке, что и агент |
Лучшие практики для промптов
- Будьте конкретны: вместо «общая информация» пишите «возможности платформы, поддерживаемые интеграции и технические требования»
- Включайте триггерные слова: упоминайте ключевые темы, которые должны активировать эту БЗ
- Описывайте назначение: объясняйте не только что в БЗ, но и когда агент должен её использовать
Пример с другой нумерацией
Поддерживаются оба формата:
## KB01
Промпт для базы знаний 1...
## KB-02
Промпт для базы знаний 2...
Дефис между KB и числом необязателен. И KB01, и KB-01 ссылаются на одну и ту же базу знаний.
Процесс импорта
Шаг 1: загрузка ZIP
Перетащите ZIP-файл в область загрузки или нажмите для выбора. Максимальный размер — 50 МБ.
Шаг 2: проверка
После загрузки вы увидите таблицу со всеми распарсенными базами знаний:
| Колонка | Описание |
|---|---|
| Название | Извлечено из H1-заголовка (редактируется) |
| Prompt | Извлечено из TRIGGERS.md (редактируется, макс. 300 символов) |
| Файл | Оригинальное имя файла |
Можно:
- Редактировать любое имя или промпт перед импортом
- Удалить ненужные базы знаний
- Вернуться, чтобы загрузить другой ZIP
Шаг 3: исправление предупреждений
Если система обнаружит проблемы, появятся жёлтые предупреждения:
| Предупреждение | Значение | Действие |
|---|---|---|
| TRIGGERS.md not found | В папке нет TRIGGERS.md | Заполните промпты вручную |
| No H1 heading | KB-файл не начинается с # Title | Отредактируйте имя в таблице |
| No matching section in TRIGGERS.md | В TRIGGERS.md нет ## KBxx для этого файла | Заполните промпт вручную |
| File is empty | KB-файл без контента | Файл пропускается автоматически |
important
Кнопка Импортировать заблокирована, пока все имена и промпты не заполнены. Пустые поля подсвечены красным.
Шаг 4: импорт
Нажмите «Import», чтобы начать загрузку. Прогресс-бар показывает статус. Базы знаний создаются по одной.
После завершения:
- Все успешно: окно закрывается, появляется уведомление об успехе
- Часть не удалась: уведомление об ошибке показывает, сколько успешных из общего числа
Полный пример
Ниже — полный пример набора баз знаний для sales-агента Говорило, который представляет платформу потенциальным клиентам.
Структура папок
Sales-Agent/
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_features.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
KB01_platform_overview.md
# Говорило Platform Overview [sales]
## What is Говорило?
Говорило is a cloud-based AI voice agent platform. Businesses create
intelligent voice assistants that handle phone calls autonomously —
answering questions, booking appointments, qualifying leads, and
providing support 24/7.
## How It Works
1. Create a voice agent in the Говорило dashboard
2. Write a prompt describing the agent's role and behavior
3. Upload knowledge bases with business-specific information
4. Connect a phone number or embed a web widget
5. The agent handles calls using AI with RAG technology
## Key Benefits
- **Available 24/7** — never miss a call again
- **Cost reduction 60-80%** compared to traditional call centers
- **Unlimited agents** on every paid plan, 14 days free to start
- **Setup in minutes** — no coding required
- **Multilingual** — agents speak any language
KB02_pricing_plans.md
# Pricing Plans [sales]
## Plan Overview
| Plan | Monthly price | Included credit | Per call minute | Best For |
|------|---------------|-----------------|-----------------|----------|
| Старт | 4 490 ₽ | около 330 мин | 13,83 ₽ | Small businesses |
| Про | 8 990 ₽ | около 710 мин | 12,91 ₽ | Growing companies |
| Бизнес | 22 990 ₽ | около 1 920 мин | 11,98 ₽ | Established businesses |
| Корпоративный | Индивидуально | Индивидуально | Индивидуально | Large organizations |
Every plan starts with 14 days free.
## What's Included on All Plans
- Unlimited AI voice agents
- Knowledge base with RAG
- Calendar integration
- Web call widget
- Analytics dashboard
## Credits
Included credit expires at the end of each month; top-ups stay.
Your whole subscription converts to credit. No hidden fees, no per-agent charges.
TRIGGERS.md
## KB01
Говорило platform overview: what the product is, how it works, key
benefits like 24/7 availability, 60-80% cost reduction, unlimited
agents. Use when customer asks what Говорило is or why they should use it.
## KB02
Pricing plans: Старт, Про, Бизнес, Корпоративный
and per-minute rates. All plans include unlimited agents, SIP, calendar.
Use when customer asks about pricing, costs, or plan comparison.
## KB03
Detailed agent features: voice settings, prompt configuration,
knowledge base setup, call forwarding, greeting messages, and tools.
Use when customer asks what agents can do or how to configure them.
## KB04
Integrations: SIP trunking, web widget,
API keys, webhooks (call-start, call-end events). Use when customer
asks about connecting Говорило with their existing systems.
## KB05
Frequently asked questions: setup time, supported languages, data
security, trial period, cancellation policy, technical requirements
(WebGL 2.0, Web Audio API, WebRTC). Use for common questions.
Результат после импорта
| Name | Prompt | File |
|---|---|---|
| Говорило Platform Overview [sales] | Говорило platform overview: what the product is... | KB01_platform_overview.md |
| Pricing Plans [sales] | Pricing plans: Старт, Про, Бизнес... | KB02_pricing_plans.md |
| Agent Features [sales] | Detailed agent features: voice settings... | KB03_agent_features.md |
| Integrations [sales] | Integrations: SIP trunking, calendar... | KB04_integrations.md |
| FAQ [sales] | Frequently asked questions: setup time... | KB05_faq.md |
Советы
- Идентификатор агента в H1: добавляйте тег вроде
[sales]или[support]в H1-заголовки, чтобы легко узнавать, к какому агенту относится БЗ при просмотре списка - Консистентность нумерации: используйте одну и ту же нумерацию в именах файлов и в TRIGGERS.md (
KB01в имени файла =## KB01в TRIGGERS.md) - Тестируйте перед импортом: проверьте содержимое архива до загрузки, чтобы не пришлось исправлять множество предупреждений
- Один агент на папку: при вложенной структуре организуйте по агенту для ясности
Связанные темы
- База знаний — создание и управление базами знаний
- Голосовые агенты — подключение БЗ к агентам
- Промпт-инжиниринг — написание эффективных промптов