Hromadný import přes ZIP
Místo vytváření znalostních bází po jedné můžete importovat více znalostních bází najednou nahráním ZIP archivu. To je obzvláště užitečné, když máte mnoho znalostních bází připravených pro agenta.
Rychlý start
- Přejděte na Znalostní báze v postranním panelu
- Klikněte na "Importovat ZIP"
- Přetáhněte svůj ZIP archiv do oblasti pro nahrávání
- Zkontrolujte a upravte naparsované výsledky
- Klikněte na "Importovat"
Struktura ZIP archivu
Jednoduchá struktura (jeden agent)
Umístěte všechny KB soubory a soubor TRIGGERS.md do kořene archivu:
hanc-support-agent.zip
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_setup.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
Vnořená struktura (více agentů)
Znalostní báze můžete organizovat do složek. Každá složka je zpracovávána nezávisle se svým vlastním 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
Pravidla pojmenování souborů
KB soubory
KB soubory musí začínat KB následovaným číslem:
| Platné | Neplatné |
|---|---|
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 |
Text za číslem je volitelný a slouží pouze pro vaši orientaci. Systém používá číslo pro spárování KB souborů s jejich prompty v TRIGGERS.md.
TRIGGERS.md
Soubor musí být pojmenován přesně TRIGGERS.md (bez ohledu na velikost písmen). Obsahuje prompty (popisy) pro každou znalostní bázi.
Formát KB souboru
Každý KB soubor musí být Markdown soubor (.md), který začíná H1 nadpisem (# Název). Tento nadpis se stává názvem znalostní báze v systému.
Příklad: 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
Co se extrahuje
| Část | Jak se používá |
|---|---|
H1 nadpis (# Název) | Název znalostní báze (max 100 znaků) |
| Plný obsah souboru | Soubor znalostní báze (nahraný jako .md) |
Pokud KB soubor nemá H1 nadpis, místo toho bude jako název použit název souboru. Uvidíte varování a můžete ho před importem upravit.
Formát TRIGGERS.md
TRIGGERS.md definuje prompt pro každou znalostní bázi. Prompt říká AI agentovi, kdy a jak tuto znalostní bázi použít.
Struktura
Každá sekce začíná ## KB následovaným číslem (odpovídajícím číslu KB souboru). Text níže se stává promptem.
## 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.
Pokyny pro prompty
| Pravidlo | Detaily |
|---|---|
| Max délka | 300 znaků na prompt |
| Formát sekce | ## KB01, ## KB02 atd. |
| Obsah | Popište, co KB obsahuje a kdy ji použít |
| Jazyk | Pište ve stejném jazyce jako váš agent |
- Buďte konkrétní: Místo "obecné informace" napište "vlastnosti platformy, podporované integrace a technické požadavky"
- Zahrňte spouštěcí slova: Zmiňte klíčová témata, která by měla tuto KB aktivovat
- Popište účel: Vysvětlete nejen co je v KB, ale kdy by ji agent měl použít
Příklad s odlišným číslováním
Oba formáty jsou podporovány:
## KB01
Prompt for knowledge base 1...
## KB-02
Prompt for knowledge base 2...
Pomlčka mezi KB a číslem je volitelná. Jak KB01, tak KB-01 odkazují na stejnou znalostní bázi.
Proces importu
Krok 1: Nahrajte ZIP
Přetáhněte svůj ZIP soubor do oblasti pro nahrávání nebo klikněte pro procházení. Maximální velikost souboru je 50 MB.
Krok 2: Zkontrolujte
Po nahrání uvidíte tabulku se všemi naparsovanými znalostními bázemi:
| Sloupec | Popis |
|---|---|
| Název | Extrahováno z H1 nadpisu (upravitelné) |
| Prompt | Extrahováno z TRIGGERS.md (upravitelné, max 300 znaků) |
| Soubor | Původní název souboru |
Můžete:
- Upravit jakýkoli název nebo prompt před importem
- Odstranit znalostní báze, které nechcete importovat
- Vrátit se zpět pro nahrání jiného ZIP
Krok 3: Opravte varování
Pokud systém detekuje problémy, uvidíte žlutá varování:
| Varování | Význam | Akce |
|---|---|---|
| TRIGGERS.md nenalezen | Složka nemá TRIGGERS.md | Vyplňte prompty manuálně |
| Žádný H1 nadpis | KB soubor nezačíná # Název | Upravte název v tabulce |
| Žádná odpovídající sekce v TRIGGERS.md | TRIGGERS.md nemá ## KBxx pro tento soubor | Vyplňte prompt manuálně |
| Soubor je prázdný | KB soubor nemá obsah | Soubor je automaticky přeskočen |
Tlačítko Importovat je zakázáno, dokud nejsou vyplněny všechny názvy a prompty. Prázdná pole jsou zvýrazněna červeně.
Krok 4: Importujte
Klikněte na "Importovat" pro zahájení nahrávání. Indikátor průběhu zobrazuje stav nahrávání. Znalostní báze jsou vytvářeny jedna po druhé.
Po dokončení:
- Vše úspěšné: Modál se zavře, zobrazí se oznámení o úspěchu
- Některé selhaly: Oznámení o chybě ukazuje, kolik bylo úspěšných vs. celkem
Kompletní příklad
Zde je úplný příklad sady znalostních bází pro HANC.AI prodejního agenta, který představuje platformu potenciálním zákazníkům.
Struktura složek
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.
Výsledek po importu
| Název | Prompt | Soubor |
|---|---|---|
| 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 |
Tipy
- Identifikátor agenta v H1: Přidejte tag jako
[sales]nebo[support]k H1 nadpisům pro snadnou identifikaci, kterému agentovi KB patří, při jejich prohlížení v seznamu - Konzistence číslování: Použijte stejné číslování v názvech souborů a TRIGGERS.md (
KB01v názvu souboru =## KB01v TRIGGERS.md) - Otestujte před importem: Před nahráním zkontrolujte obsah svého archivu, abyste se vyhnuli nutnosti opravovat více varování
- Jeden agent na složku: Při použití vnořené struktury organizujte podle agenta pro přehlednost
Související témata
- Znalostní báze — Vytváření a správa znalostních bází
- AI hlasoví agenti — Připojení KB k agentům
- Inženýrství promptů — Psaní efektivních promptů