Масовий імпорт через 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

Файли 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 визначає промпт для кожної бази знань. Промпт підказує AI-агенту, коли і як використовувати цю базу знань.

Структура

Кожен розділ починається з ## 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 тощо
Вміст	Опишіть, що містить KB і коли її використовувати
Мова	Пишіть тією ж мовою, що й ваш агент

Найкращі практики для промптів

• Будьте конкретними: замість «загальна інформація» напишіть «функції платформи, підтримувані інтеграції та технічні вимоги»
• Додавайте тригерні слова: згадайте ключові теми, які мають активувати цю KB
• Опишіть призначення: поясніть не лише що є в KB, а й коли агент має її використовувати

Приклад з іншою нумерацією

Підтримуються обидва формати:

## KB01
Prompt for knowledge base 1...

## KB-02
Prompt for knowledge base 2...

Дефіс між KB та числом є необов'язковим. Обидва KB01 і KB-01 посилаються на ту саму базу знань.

---

Процес імпорту

Крок 1: Завантаження ZIP

Перетягніть свій ZIP-файл у зону завантаження або натисніть, щоб вибрати. Максимальний розмір файлу — 50 MB.

Крок 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», щоб почати завантаження. Індикатор прогресу показує статус завантаження. Бази знань створюються по одній.

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

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

---

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

Ось повний приклад набору баз знань для агента з продажів 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 | Free | €0.13/min | Testing the platform |
| Starter | €49 | €0.13/min | Small businesses |
| Pro | €99 | €0.11/min | Growing companies |
| Business | €249 | €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, щоб легко визначати, до якого агента належить KB, переглядаючи їх у списку
• Узгодженість нумерації: використовуйте однакову нумерацію в іменах файлів і TRIGGERS.md (KB01 в імені файлу = ## KB01 у TRIGGERS.md)
• Тестуйте перед імпортом: перевірте вміст архіву перед завантаженням, щоб уникнути виправлення багатьох попереджень
• Один агент на папку: використовуючи вкладену структуру, організовуйте за агентом для ясності

---

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

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