Bulk Import via ZIP

Instead of creating knowledge bases one by one, you can import multiple knowledge bases at once by uploading a ZIP archive. This is especially useful when you have many knowledge bases prepared for an agent.

Quick Start

1. Go to Knowledge Base in the sidebar
2. Click "Import ZIP"
3. Drop your ZIP archive into the upload area
4. Review and edit the parsed results
5. Click "Import"

---

ZIP Archive Structure

Simple Structure (Single Agent)

Place all KB files and a TRIGGERS.md file in the root of the archive:

hanc-support-agent.zip
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_setup.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md

Nested Structure (Multiple Agents)

You can organize knowledge bases into folders. Each folder is processed independently with its own 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

---

File Naming Rules

KB Files

KB files must start with KB followed by a number:

Valid	Invalid
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

tip

The text after the number is optional and only for your reference. The system uses the number to match KB files with their prompts in TRIGGERS.md.

TRIGGERS.md

The file must be named exactly TRIGGERS.md (case-insensitive). It contains prompts (descriptions) for each knowledge base.

---

KB File Format

Each KB file must be a Markdown file (.md) that starts with an H1 heading (# Title). This heading becomes the name of the knowledge base in the system.

Example: 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 inbound and outbound
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
- Calendar booking (Cal.com, Calendly)
- Web widget for website calls
- Real-time analytics dashboard

What Gets Extracted

Part	How It's Used
H1 heading (# Title)	Knowledge base name (max 100 characters)
Full file content	Knowledge base file (uploaded as .md)

warning

If a KB file has no H1 heading, the filename will be used as the name instead. You'll see a warning and can edit it before importing.

---

TRIGGERS.md Format

TRIGGERS.md defines the prompt for each knowledge base. The prompt tells the AI agent when and how to use this knowledge base.

Structure

Each section starts with ## KB followed by the number (matching the KB file number). The text below becomes the prompt.

## 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, Agency 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.

Prompt Guidelines

Rule	Details
Max length	300 characters per prompt
Section format	## KB01, ## KB02, etc.
Content	Describe what the KB contains and when to use it
Language	Write in the same language as your agent

Best Practices for Prompts

• Be specific: Instead of "general information", write "platform features, supported integrations, and technical requirements"
• Include trigger words: Mention the key topics that should activate this KB
• Describe the purpose: Explain not just what's in the KB, but when the agent should use it

Example with Different Numbering

Both formats are supported:

## KB01
Prompt for knowledge base 1...

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

The dash between KB and the number is optional. Both KB01 and KB-01 refer to the same knowledge base.

---

Import Process

Step 1: Upload ZIP

Drag and drop your ZIP file into the upload area or click to browse. Maximum file size is 50 MB.

Step 2: Review

After uploading, you'll see a table with all parsed knowledge bases:

Column	Description
Name	Extracted from H1 heading (editable)
Prompt	Extracted from TRIGGERS.md (editable, max 300 chars)
File	Original filename

You can:

• Edit any name or prompt before importing
• Remove knowledge bases you don't want to import
• Go back to upload a different ZIP

Step 3: Fix Warnings

If the system detects issues, you'll see yellow warnings:

Warning	Meaning	Action
TRIGGERS.md not found	Folder has no TRIGGERS.md	Fill in prompts manually
No H1 heading	KB file doesn't start with # Title	Edit the name in the table
No matching section in TRIGGERS.md	TRIGGERS.md has no ## KBxx for this file	Fill in the prompt manually
File is empty	KB file has no content	File is skipped automatically

important

The Import button is disabled until all names and prompts are filled in. Empty fields are highlighted in red.

Step 4: Import

Click "Import" to start uploading. A progress bar shows the upload status. Knowledge bases are created one by one.

After completion:

• All successful: Modal closes, success notification appears
• Some failed: Error notification shows how many succeeded vs. total

---

Complete Example

Here's a full example of a knowledge base set for a HANC.AI sales agent that presents the platform to potential customers.

Folder Structure

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.14/min | Testing the platform |
| Starter | €30 | €0.13/min | Small businesses |
| Pro | €250 | €0.11/min | Growing companies |
| Agency | €800 | €0.10/min | Agencies & resellers |

## What's Included on All Plans

- Unlimited AI voice agents
- Knowledge base with RAG
- SIP integration
- Calendar integration
- Outbound calls
- Web call widget
- Analytics dashboard

## Credits

Credits roll over to the next month. You only pay for actual usage.
No hidden fees, no per-agent charges.

## Agency Exclusive Features

- Sub-accounts for client management
- Custom branding options
- Priority support

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, Agency 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, calendar (Cal.com, Calendly), 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.

Result After Import

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, Agency...	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

---

Tips

• Agent identifier in H1: Add a tag like [sales] or [support] to H1 headings to easily identify which agent a KB belongs to when viewing them in the list
• Numbering consistency: Use the same numbering in filenames and TRIGGERS.md (KB01 in filename = ## KB01 in TRIGGERS.md)
• Test before importing: Check your archive contents before uploading to avoid having to fix multiple warnings
• One agent per folder: When using nested structure, organize by agent for clarity

---

Related Topics

• Knowledge Base — Creating and managing knowledge bases
• Voice Agents — Connecting KB to agents
• Prompt Engineering — Writing effective prompts