Масовий імпорт через ZIP

Замість створення баз знань по одній ви можете імпортувати кілька баз знань одночасно, завантаживши ZIP-архів. Це особливо корисно, коли у вас підготовлено багато баз знань для агента.

Швидкий старт

1. Перейдіть до Knowledge Base на бічній панелі
2. Натисніть «Import ZIP»
3. Перетягніть свій ZIP-архів у зону завантаження
4. Перегляньте та відредагуйте оброблені результати
5. Натисніть «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, після чого йде число:

Дійсні	Недійсні
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

порада

Текст після числа необов'язковий і призначений лише для вашого довідника. Система використовує число, щоб співставити файли БЗ з їхніми промптами в TRIGGERS.md.

TRIGGERS.md

Файл має називатися точно TRIGGERS.md (без урахування регістру). Він містить промпти (описи) для кожної бази знань.

---

Формат файлу БЗ

Кожен файл БЗ має бути 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)

попередження

Якщо файл БЗ не має H1-заголовка, замість нього буде використано ім'я файлу. Ви побачите попередження і зможете відредагувати його перед імпортом.

---

Формат TRIGGERS.md

TRIGGERS.md визначає промпт для кожної бази знань. Промпт каже AI-агенту, коли і як використовувати цю базу знань.

Структура

Кожен розділ починається з ## 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
Prompt for knowledge base 1...

## KB-02
Prompt for knowledge base 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	Файл БЗ не починається з # Title	Відредагуйте назву в таблиці
No matching section in TRIGGERS.md	TRIGGERS.md не має ## KBxx для цього файлу	Заповніть промпт вручну
File is empty	Файл БЗ не має вмісту	Файл автоматично пропускається

important

Кнопка Import вимкнена, поки не заповнено всі назви та промпти. Порожні поля підсвічуються червоним.

Крок 4: Імпорт

Натисніть «Import», щоб почати завантаження. Шкала прогресу показує статус завантаження. Бази знань створюються одна за одною.

Після завершення:

• Усі успішні: Модальне вікно закривається, з'являється сповіщення про успіх
• Деякі провалилися: Сповіщення про помилку показує, скільки успішних з загальної кількості

---

Повний приклад

Ось повний приклад набору баз знань для 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)
• Тестуйте перед імпортом: Перевіряйте вміст архіву перед завантаженням, щоб уникнути необхідності виправляти кілька попереджень
• Один агент на папку: При використанні вкладеної структури організовуйте за агентами для ясності

---

Пов'язані теми

• База знань — Створення та керування базами знань
• AI голосові агенти — Підключення БЗ до агентів
• Інженерія промптів — Написання ефективних промптів