Hromadný import přes ZIP
Místo vytváření znalostních bází jednu po druhé můžete importovat více znalostních bází najednou nahráním archivu ZIP. To je obzvláště užitečné, když máte pro agenta připraveno mnoho znalostních bází.
Rychlý start
- Přejděte na Znalostní báze v postranním panelu
- Klikněte na „Importovat ZIP"
- Přetáhněte svůj archiv ZIP do oblasti pro nahrání
- Zkontrolujte a upravte zpracované výsledky
- Klikněte na „Importovat"
Struktura archivu ZIP
Jednoduchá struktura (jeden agent)
Umístěte všechny soubory znalostní báze 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ána nezávisle s 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ů
Soubory KB
Soubory KB musí začínat na KB následované čí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 nepovinný a slouží jen pro vaši orientaci. Systém používá číslo ke spárování souborů KB 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 souboru KB
Každý soubor KB musí být soubor Markdown (.md), který začíná nadpisem H1 (# Titulek). Tento nadpis se stane 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žije |
|---|---|
Nadpis H1 (# Titulek) | Název znalostní báze (max. 100 znaků) |
| Celý obsah souboru | Soubor znalostní báze (nahraný jako .md) |
Pokud soubor KB nemá nadpis H1, jako název se místo toho použije název souboru. Zobrazí se varování a před importem jej můžete 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é číslem (odpovídajícím číslu souboru KB). Text pod ním se stane 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 | Podrobnosti |
|---|---|
| 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 „funkce 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 to, co je v KB, ale i kdy by ji měl agent 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 nepovinná. KB01 i KB-01 odkazují na stejnou znalostní bázi.
Proces importu
Krok 1: Nahrání ZIP
Přetáhněte svůj soubor ZIP do oblasti pro nahrání nebo klikněte pro procházení. Maximální velikost souboru je 50 MB.
Krok 2: Kontrola
Po nahrání uvidíte tabulku se všemi zpracovanými znalostními bázemi:
| Sloupec | Popis |
|---|---|
| Název | Extrahováno z nadpisu H1 (upravitelné) |
| Prompt | Extrahováno z TRIGGERS.md (upravitelné, max. 300 znaků) |
| Soubor | Původní název souboru |
Můžete:
- Upravit libovolný název nebo prompt před importem
- Odebrat znalostní báze, které nechcete importovat
- Vrátit se a nahrát jiný ZIP
Krok 3: Oprava varování
Pokud systém zjistí problémy, uvidíte žlutá varování:
| Varování | Význam | Akce |
|---|---|---|
| TRIGGERS.md nenalezen | Složka nemá TRIGGERS.md | Vyplňte prompty ručně |
| Žádný nadpis H1 | Soubor KB nezačíná na # Titulek | Upravte název v tabulce |
| Žádná odpovídající sekce v TRIGGERS.md | TRIGGERS.md nemá ## KBxx pro tento soubor | Vyplňte prompt ručně |
| Soubor je prázdný | Soubor KB nemá žádný obsah | Soubor je automaticky přeskočen |
Tlačítko Importovat je zakázané, dokud nejsou vyplněny všechny názvy a prompty. Prázdná pole jsou zvýrazněna červeně.
Krok 4: Import
Kliknutím na „Importovat" spustíte nahrávání. Průběh nahrávání zobrazuje ukazatel postupu. Znalostní báze se vytvářejí jedna po druhé.
Po dokončení:
- Vše úspěšné: Okno se zavře, zobrazí se oznámení o úspěchu
- Některé selhaly: Oznámení o chybě ukáže, kolik jich uspělo z celkového počtu
Kompletní příklad
Zde je úplný příklad sady znalostních bází pro prodejního agenta HANC.AI, který prezentuje 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 | 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.
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 značku jako
[sales]nebo[support]k nadpisům H1, abyste při prohlížení v seznamu snadno poznali, ke kterému agentovi KB patří - Konzistentní číslování: Používejte stejné číslování v názvech souborů a v TRIGGERS.md (
KB01v názvu souboru =## KB01v TRIGGERS.md) - Otestujte před importem: Zkontrolujte obsah archivu před nahráním, abyste se vyhnuli opravování více varování
- Jeden agent na složku: Při použití vnořené struktury organizujte podle agenta kvůli přehlednosti
Související témata
- Znalostní báze — Vytváření a správa znalostních bází
- Hlasoví agenti — Připojení KB k agentům
- Prompt engineering — Psaní účinných promptů