Import zbiorczy przez ZIP

Zamiast tworzyć bazy wiedzy jedna po drugiej, możesz importować wiele baz wiedzy naraz, przesyłając archiwum ZIP. Jest to szczególnie przydatne, gdy masz wiele baz wiedzy przygotowanych dla agenta.

Szybki start

1. Przejdź do Baza wiedzy w panelu bocznym
2. Kliknij „Importuj ZIP"
3. Upuść swoje archiwum ZIP w obszarze przesyłania
4. Przejrzyj i edytuj sparsowane wyniki
5. Kliknij „Importuj"

---

Struktura archiwum ZIP

Prosta struktura (jeden agent)

Umieść wszystkie pliki KB i plik TRIGGERS.md w katalogu głównym archiwum:

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

Struktura zagnieżdżona (wielu agentów)

Możesz organizować bazy wiedzy w folderach. Każdy folder jest przetwarzany niezależnie z własnym 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

---

Zasady nazewnictwa plików

Pliki KB

Pliki KB muszą zaczynać się od KB, po którym następuje liczba:

Poprawne	Niepoprawne
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

wskazówka

Tekst po liczbie jest opcjonalny i służy tylko do Twojego odniesienia. System używa liczby, aby dopasować pliki KB do ich promptów w TRIGGERS.md.

TRIGGERS.md

Plik musi nazywać się dokładnie TRIGGERS.md (bez rozróżniania wielkości liter). Zawiera prompty (opisy) dla każdej bazy wiedzy.

---

Format pliku KB

Każdy plik KB musi być plikiem Markdown (.md), który zaczyna się od nagłówka H1 (# Tytuł). Ten nagłówek staje się nazwą bazy wiedzy w systemie.

Przykład: 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 zostaje wyodrębnione

Część	Jak jest używana
Nagłówek H1 (# Tytuł)	Nazwa bazy wiedzy (maks. 100 znaków)
Pełna zawartość pliku	Plik bazy wiedzy (przesłany jako .md)

ostrzeżenie

Jeśli plik KB nie ma nagłówka H1, jako nazwa zostanie użyta nazwa pliku. Zobaczysz ostrzeżenie i możesz to edytować przed importem.

---

Format TRIGGERS.md

TRIGGERS.md definiuje prompt dla każdej bazy wiedzy. Prompt mówi agentowi AI, kiedy i jak używać tej bazy wiedzy.

Struktura

Każda sekcja zaczyna się od ## KB, po którym następuje liczba (pasująca do liczby pliku KB). Tekst poniżej staje się 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.

Wytyczne dotyczące promptów

Reguła	Szczegóły
Maks. długość	300 znaków na prompt
Format sekcji	## KB01, ## KB02 itd.
Treść	Opisz, co zawiera KB i kiedy go używać
Język	Pisz w tym samym języku co Twój agent

Najlepsze praktyki dla promptów

• Bądź konkretny: Zamiast „ogólne informacje" napisz „funkcje platformy, obsługiwane integracje i wymagania techniczne"
• Uwzględnij słowa wyzwalające: Wymień kluczowe tematy, które powinny aktywować tę KB
• Opisz cel: Wyjaśnij nie tylko, co jest w KB, ale kiedy agent powinien tego używać

Przykład z różnym numerowaniem

Oba formaty są obsługiwane:

## KB01
Prompt dla bazy wiedzy 1...

## KB-02
Prompt dla bazy wiedzy 2...

Myślnik między KB a liczbą jest opcjonalny. Zarówno KB01, jak i KB-01 odnoszą się do tej samej bazy wiedzy.

---

Proces importu

Krok 1: Prześlij ZIP

Przeciągnij i upuść swój plik ZIP w obszarze przesyłania lub kliknij, aby przeglądać. Maksymalny rozmiar pliku to 50 MB.

Krok 2: Przegląd

Po przesłaniu zobaczysz tabelę ze wszystkimi sparsowanymi bazami wiedzy:

Kolumna	Opis
Nazwa	Wyodrębniona z nagłówka H1 (edytowalna)
Prompt	Wyodrębniony z TRIGGERS.md (edytowalny, maks. 300 znaków)
Plik	Oryginalna nazwa pliku

Możesz:

• Edytować dowolną nazwę lub prompt przed importem
• Usunąć bazy wiedzy, których nie chcesz importować
• Wrócić, aby przesłać inny ZIP

Krok 3: Napraw ostrzeżenia

Jeśli system wykryje problemy, zobaczysz żółte ostrzeżenia:

Ostrzeżenie	Znaczenie	Działanie
Nie znaleziono TRIGGERS.md	Folder nie ma TRIGGERS.md	Wypełnij prompty ręcznie
Brak nagłówka H1	Plik KB nie zaczyna się od # Tytuł	Edytuj nazwę w tabeli
Brak pasującej sekcji w TRIGGERS.md	TRIGGERS.md nie ma ## KBxx dla tego pliku	Wypełnij prompt ręcznie
Plik jest pusty	Plik KB nie ma zawartości	Plik jest pomijany automatycznie

important

Przycisk Importuj jest wyłączony, dopóki wszystkie nazwy i prompty nie zostaną wypełnione. Puste pola są podświetlone na czerwono.

Krok 4: Importuj

Kliknij „Importuj", aby rozpocząć przesyłanie. Pasek postępu pokazuje status przesyłania. Bazy wiedzy są tworzone jedna po drugiej.

Po zakończeniu:

• Wszystkie udane: Modal się zamyka, pojawia się powiadomienie o sukcesie
• Niektóre nieudane: Powiadomienie o błędzie pokazuje, ile udało się względem ogółu

---

Pełny przykład

Oto pełny przykład zestawu baz wiedzy dla agenta sprzedaży HANC.AI, który prezentuje platformę potencjalnym klientom.

Struktura folderów

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.

Wynik po imporcie

Nazwa	Prompt	Plik
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

---

Wskazówki

• Identyfikator agenta w H1: Dodaj tag taki jak [sales] lub [support] do nagłówków H1, aby łatwo identyfikować, do którego agenta należy dana KB podczas przeglądania ich na liście
• Spójność numerowania: Używaj tego samego numerowania w nazwach plików i w TRIGGERS.md (KB01 w nazwie pliku = ## KB01 w TRIGGERS.md)
• Testuj przed importem: Sprawdź zawartość swojego archiwum przed przesłaniem, aby uniknąć konieczności naprawiania wielu ostrzeżeń
• Jeden agent na folder: Korzystając ze struktury zagnieżdżonej, organizuj według agenta dla jasności

---

Powiązane tematy

• Baza wiedzy — Tworzenie baz wiedzy i zarządzanie nimi
• Agenci głosowi AI — Podłączanie KB do agentów
• Inżynieria promptów — Pisanie skutecznych promptów