Massenimport per ZIP
Anstatt Knowledge Bases einzeln zu erstellen, können Sie mehrere Knowledge Bases auf einmal importieren, indem Sie ein ZIP-Archiv hochladen. Das ist besonders nützlich, wenn Sie viele Knowledge Bases für einen Agenten vorbereitet haben.
Schnellstart
- Gehen Sie in der Seitenleiste zu Knowledge Base
- Klicken Sie auf „ZIP importieren"
- Ziehen Sie Ihr ZIP-Archiv in den Upload-Bereich
- Prüfen und bearbeiten Sie die ausgelesenen Ergebnisse
- Klicken Sie auf „Importieren"
Struktur des ZIP-Archivs
Einfache Struktur (ein Agent)
Legen Sie alle KB-Dateien und eine TRIGGERS.md-Datei in das Stammverzeichnis des Archivs:
hanc-support-agent.zip
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_setup.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
Verschachtelte Struktur (mehrere Agenten)
Sie können Knowledge Bases in Ordnern organisieren. Jeder Ordner wird unabhängig mit seiner eigenen TRIGGERS.md verarbeitet:
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
Regeln für Dateinamen
KB-Dateien
KB-Dateien müssen mit KB gefolgt von einer Zahl beginnen:
| Gültig | Ungültig |
|---|---|
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 |
Der Text nach der Zahl ist optional und dient nur Ihrer eigenen Orientierung. Das System verwendet die Zahl, um KB-Dateien mit ihren Prompts in TRIGGERS.md abzugleichen.
TRIGGERS.md
Die Datei muss exakt TRIGGERS.md heißen (Groß-/Kleinschreibung wird ignoriert). Sie enthält Prompts (Beschreibungen) für jede Knowledge Base.
Format der KB-Datei
Jede KB-Datei muss eine Markdown-Datei (.md) sein, die mit einer H1-Überschrift (# Titel) beginnt. Diese Überschrift wird zum Namen der Knowledge Base im System.
Beispiel: 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
Was extrahiert wird
| Bestandteil | Wie er verwendet wird |
|---|---|
H1-Überschrift (# Titel) | Name der Knowledge Base (max. 100 Zeichen) |
| Vollständiger Dateiinhalt | Datei der Knowledge Base (als .md hochgeladen) |
Wenn eine KB-Datei keine H1-Überschrift hat, wird stattdessen der Dateiname als Name verwendet. Sie sehen eine Warnung und können ihn vor dem Import bearbeiten.
Format von TRIGGERS.md
TRIGGERS.md definiert den Prompt für jede Knowledge Base. Der Prompt teilt dem KI-Agenten mit, wann und wie diese Knowledge Base zu verwenden ist.
Struktur
Jeder Abschnitt beginnt mit ## KB gefolgt von der Zahl (passend zur Nummer der KB-Datei). Der Text darunter wird zum 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, 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.
Richtlinien für Prompts
| Regel | Details |
|---|---|
| Maximale Länge | 300 Zeichen pro Prompt |
| Abschnittsformat | ## KB01, ## KB02 usw. |
| Inhalt | Beschreiben Sie, was die KB enthält und wann sie zu verwenden ist |
| Sprache | Schreiben Sie in derselben Sprache wie Ihr Agent |
- Seien Sie konkret: Schreiben Sie statt „allgemeine Informationen" lieber „Plattformfunktionen, unterstützte Integrationen und technische Anforderungen"
- Nennen Sie Auslösewörter: Erwähnen Sie die Schlüsselthemen, die diese KB aktivieren sollen
- Beschreiben Sie den Zweck: Erklären Sie nicht nur, was in der KB steht, sondern auch, wann der Agent sie verwenden soll
Beispiel mit unterschiedlicher Nummerierung
Beide Formate werden unterstützt:
## KB01
Prompt for knowledge base 1...
## KB-02
Prompt for knowledge base 2...
Der Bindestrich zwischen KB und der Zahl ist optional. Sowohl KB01 als auch KB-01 verweisen auf dieselbe Knowledge Base.
Importvorgang
Schritt 1: ZIP hochladen
Ziehen Sie Ihre ZIP-Datei per Drag-and-drop in den Upload-Bereich oder klicken Sie, um zu durchsuchen. Die maximale Dateigröße beträgt 50 MB.
Schritt 2: Prüfen
Nach dem Hochladen sehen Sie eine Tabelle mit allen ausgelesenen Knowledge Bases:
| Spalte | Beschreibung |
|---|---|
| Name | Aus der H1-Überschrift extrahiert (bearbeitbar) |
| Prompt | Aus TRIGGERS.md extrahiert (bearbeitbar, max. 300 Zeichen) |
| Datei | Ursprünglicher Dateiname |
Sie können:
- Jeden Namen oder Prompt vor dem Import bearbeiten
- Knowledge Bases, die Sie nicht importieren möchten, entfernen
- Zurückgehen, um ein anderes ZIP hochzuladen
Schritt 3: Warnungen beheben
Wenn das System Probleme erkennt, sehen Sie gelbe Warnungen:
| Warnung | Bedeutung | Aktion |
|---|---|---|
| TRIGGERS.md nicht gefunden | Ordner hat keine TRIGGERS.md | Prompts manuell ausfüllen |
| Keine H1-Überschrift | KB-Datei beginnt nicht mit # Titel | Namen in der Tabelle bearbeiten |
| Kein passender Abschnitt in TRIGGERS.md | TRIGGERS.md enthält kein ## KBxx für diese Datei | Prompt manuell ausfüllen |
| Datei ist leer | KB-Datei hat keinen Inhalt | Datei wird automatisch übersprungen |
Die Schaltfläche Importieren ist deaktiviert, bis alle Namen und Prompts ausgefüllt sind. Leere Felder werden rot hervorgehoben.
Schritt 4: Importieren
Klicken Sie auf „Importieren", um den Upload zu starten. Ein Fortschrittsbalken zeigt den Upload-Status an. Knowledge Bases werden einzeln erstellt.
Nach Abschluss:
- Alle erfolgreich: Der Dialog schließt sich, eine Erfolgsmeldung erscheint
- Einige fehlgeschlagen: Eine Fehlermeldung zeigt an, wie viele von wie vielen erfolgreich waren
Vollständiges Beispiel
Hier ist ein vollständiges Beispiel für einen Knowledge-Base-Satz für einen HANC.AI-Vertriebsagenten, der die Plattform potenziellen Kunden vorstellt.
Ordnerstruktur
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.
Ergebnis nach dem Import
| Name | Prompt | Datei |
|---|---|---|
| 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 |
Tipps
- Agentenkennung in der H1: Fügen Sie einen Tag wie
[sales]oder[support]zu H1-Überschriften hinzu, um in der Liste leicht zu erkennen, zu welchem Agenten eine KB gehört - Konsistente Nummerierung: Verwenden Sie in Dateinamen und TRIGGERS.md dieselbe Nummerierung (
KB01im Dateinamen =## KB01in TRIGGERS.md) - Vor dem Import testen: Prüfen Sie den Inhalt Ihres Archivs vor dem Hochladen, um nicht mehrere Warnungen beheben zu müssen
- Ein Agent pro Ordner: Bei verschachtelter Struktur organisieren Sie zur besseren Übersicht nach Agent
Verwandte Themen
- Knowledge Base — Knowledge Bases erstellen und verwalten
- Voice Agents — KB mit Agenten verbinden
- Prompt Engineering — Wirksame Prompts schreiben