Массовый импорт через ZIP
Вместо создания баз знаний по одной можно импортировать сразу несколько, загрузив ZIP-архив. Особенно полезно, когда у вас много БЗ, подготовленных для агента.
Быстрый старт
- Knowledge Base в боковой панели
- «Import ZIP»
- Перетащите ZIP-архив в область загрузки
- Проверьте и отредактируйте результат парсинга
- «Import»
Структура ZIP-архива
Простая структура (один агент)
Все файлы БЗ и файл TRIGGERS.md положите в корень архива:
hanc-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:
hanc-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
# HANC.AI Platform Overview [sales]
## What is HANC.AI?
HANC.AI 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
- Google Calendar integration
- Web widget for website calls
- Real-time analytics dashboard
Что извлекается
| Часть | Как используется |
|---|---|
H1-заголовок (# Title) | Имя базы знаний (макс. 100 символов) |
| Полное содержимое файла | Файл базы знаний (загружается как .md) |
внимание
Если у KB-файла нет H1-заголовка, в качестве имени используется имя файла. Появится предупреждение, имя можно отредактировать перед импортом.
Формат TRIGGERS.md
TRIGGERS.md задаёт промпт для каждой базы знаний. Промпт говорит агенту, когда и как использовать эту БЗ.
Структура
Каждый раздел начинается с ## KB, за которым следует число (соответствующее номеру KB-файла). Текст ниже становится промптом.
## KB01
HANC.AI platform overview: what the product does, key features, and
benefits. Use when the customer asks what HANC.AI is, how it works,
or what problems it solves.
## KB02
Pricing plans and billing: Free, Starter, Pro, Business, Enterprise tiers
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: проверка
После загрузки увидите таблицу со всеми распарсенными базами знаний:
| Колонка | Описание |
|---|---|
| Name | Извлечено из H1 (редактируется) |
| Prompt | Извлечено из TRIGGERS.md (редактируется, макс. 300 символов) |
| File | Оригинальное имя файла |
Можно:
- Редактировать любое имя или промпт перед импортом
- Удалить ненужные БЗ
- Вернуться, чтобы загрузить другой 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
Кнопка Import заблокирована, пока все имена и промпты не заполнены. Пустые поля подсвечены красным.
Шаг 4: импорт
Нажмите «Import» для старта загрузки. Прогресс-бар показывает статус. Базы знаний создаются по одной.
После завершения:
- Все успешно: модалка закрывается, появляется success-уведомление
- Часть упала: error-уведомление показывает, сколько успешных из общего числа
Полный пример
Полный пример набора баз знаний для sales-агента HANC.AI, представляющего платформу потенциальным клиентам.
Структура папок
HANC-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
# HANC.AI Platform Overview [sales]
## What is HANC.AI?
HANC.AI 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 HANC.AI 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 all plans including Free
- **Setup in minutes** — no coding required
- **Multilingual** — agents speak any language
KB02_pricing_plans.md
# Pricing Plans [sales]
## Plan Overview
| Plan | Monthly Credits | Web Call Rate | Best For |
|------|----------------|---------------|----------|
| Free | €10 (one-time) | €0.13/min | Testing the platform |
| Starter | €30 | €0.13/min | Small businesses |
| Pro | €100 | €0.11/min | Growing companies |
| Business | €250 | €0.10/min | Established businesses |
| Enterprise | Custom | Custom | Large organizations |
## What's Included on All Plans
- Unlimited AI voice agents
- Knowledge base with RAG
- SIP integration
- Calendar integration
- Web call widget
- Analytics dashboard
## Credits
Credits roll over to the next month. 100% of your subscription
converts to credit. No hidden fees, no per-agent charges.
TRIGGERS.md
## KB01
HANC.AI 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 HANC.AI is or why they should use it.
## KB02
Pricing plans: Free, Starter, Pro, Business, Enterprise with credit amounts
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, Google Calendar, web widget,
API keys, webhooks (call-start, call-end events). Use when customer
asks about connecting HANC.AI 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 |
|---|---|---|
| HANC.AI Platform Overview [sales] | HANC.AI platform overview: what the product is... | KB01_platform_overview.md |
| Pricing Plans [sales] | Pricing plans: Free, Starter, Pro, Business... | 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) - Тестируйте перед импортом: проверяйте содержимое архива до загрузки, чтобы не править много предупреждений
- Один агент на папку: при вложенной структуре организуйте по агенту для ясности
Связанные темы
- База знаний — создание и управление базами знаний
- Голосовые агенты — подключение БЗ к агентам
- Prompt Engineering — написание эффективных промптов