Importazione in blocco tramite ZIP
Invece di creare knowledge base una alla volta, puoi importare più knowledge base contemporaneamente caricando un archivio ZIP. Questo è particolarmente utile quando hai molte knowledge base preparate per un agente.
Avvio rapido
- Vai su Knowledge Base nella barra laterale
- Clicca su "Importa ZIP"
- Trascina il tuo archivio ZIP nell'area di caricamento
- Rivedi e modifica i risultati analizzati
- Clicca su "Importa"
Struttura dell'archivio ZIP
Struttura semplice (singolo agente)
Posiziona tutti i file KB e un file TRIGGERS.md nella radice dell'archivio:
hanc-support-agent.zip
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_setup.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
Struttura nidificata (più agenti)
Puoi organizzare le knowledge base in cartelle. Ogni cartella viene elaborata in modo indipendente con il proprio 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
Regole di denominazione dei file
File KB
I file KB devono iniziare con KB seguito da un numero:
| Valido | Non valido |
|---|---|
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 |
Il testo dopo il numero è opzionale e solo per il tuo riferimento. Il sistema usa il numero per abbinare i file KB ai loro prompt in TRIGGERS.md.
TRIGGERS.md
Il file deve essere chiamato esattamente TRIGGERS.md (case-insensitive). Contiene i prompt (descrizioni) per ogni knowledge base.
Formato del file KB
Ogni file KB deve essere un file Markdown (.md) che inizia con un titolo H1 (# Titolo). Questo titolo diventa il nome della knowledge base nel sistema.
Esempio: 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
Cosa viene estratto
| Parte | Come viene usata |
|---|---|
Titolo H1 (# Titolo) | Nome della knowledge base (max 100 caratteri) |
| Contenuto file completo | File della knowledge base (caricato come .md) |
Se un file KB non ha titolo H1, il nome del file verrà usato come nome. Vedrai un avviso e potrai modificarlo prima dell'importazione.
Formato TRIGGERS.md
TRIGGERS.md definisce il prompt per ogni knowledge base. Il prompt dice all'agente IA quando e come usare questa knowledge base.
Struttura
Ogni sezione inizia con ## KB seguito dal numero (corrispondente al numero del file KB). Il testo sotto diventa il 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.
Linee guida per i prompt
| Regola | Dettagli |
|---|---|
| Lunghezza max | 300 caratteri per prompt |
| Formato sezione | ## KB01, ## KB02, ecc. |
| Contenuto | Descrivi cosa contiene la KB e quando usarla |
| Lingua | Scrivi nella stessa lingua del tuo agente |
- Sii specifico: Invece di "informazioni generali", scrivi "funzionalità della piattaforma, integrazioni supportate e requisiti tecnici"
- Includi parole trigger: Menziona gli argomenti chiave che dovrebbero attivare questa KB
- Descrivi lo scopo: Spiega non solo cosa c'è nella KB, ma quando l'agente dovrebbe usarla
Esempio con numerazione diversa
Entrambi i formati sono supportati:
## KB01
Prompt per knowledge base 1...
## KB-02
Prompt per knowledge base 2...
Il trattino tra KB e il numero è opzionale. Sia KB01 che KB-01 si riferiscono alla stessa knowledge base.
Processo di importazione
Passaggio 1: Carica lo ZIP
Trascina il tuo file ZIP nell'area di caricamento o clicca per sfogliare. La dimensione massima del file è 50 MB.
Passaggio 2: Rivedi
Dopo il caricamento, vedrai una tabella con tutte le knowledge base analizzate:
| Colonna | Descrizione |
|---|---|
| Nome | Estratto dal titolo H1 (modificabile) |
| Prompt | Estratto da TRIGGERS.md (modificabile, max 300 caratteri) |
| File | Nome file originale |
Puoi:
- Modificare qualsiasi nome o prompt prima dell'importazione
- Rimuovere knowledge base che non vuoi importare
- Tornare indietro per caricare uno ZIP diverso
Passaggio 3: Correggi gli avvisi
Se il sistema rileva problemi, vedrai avvisi gialli:
| Avviso | Significato | Azione |
|---|---|---|
| TRIGGERS.md non trovato | La cartella non ha TRIGGERS.md | Compila i prompt manualmente |
| Nessun titolo H1 | Il file KB non inizia con # Titolo | Modifica il nome nella tabella |
| Nessuna sezione corrispondente in TRIGGERS.md | TRIGGERS.md non ha ## KBxx per questo file | Compila il prompt manualmente |
| File vuoto | Il file KB non ha contenuto | Il file viene saltato automaticamente |
Il pulsante Importa è disabilitato fino a quando tutti i nomi e i prompt non sono compilati. I campi vuoti sono evidenziati in rosso.
Passaggio 4: Importa
Clicca su "Importa" per avviare il caricamento. Una barra di avanzamento mostra lo stato del caricamento. Le knowledge base vengono create una alla volta.
Dopo il completamento:
- Tutti riusciti: La modale si chiude, appare una notifica di successo
- Alcuni falliti: Una notifica di errore mostra quanti sono riusciti rispetto al totale
Esempio completo
Ecco un esempio completo di un set di knowledge base per un agente di vendita HANC.AI che presenta la piattaforma a potenziali clienti.
Struttura della cartella
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.
Risultato dopo l'importazione
| Nome | 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, 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 |
Consigli
- Identificatore dell'agente in H1: Aggiungi un tag come
[sales]o[support]ai titoli H1 per identificare facilmente a quale agente appartiene una KB quando la visualizzi nell'elenco - Consistenza della numerazione: Usa la stessa numerazione nei nomi dei file e in TRIGGERS.md (
KB01nel nome del file =## KB01in TRIGGERS.md) - Test prima dell'importazione: Controlla il contenuto del tuo archivio prima del caricamento per evitare di dover correggere più avvisi
- Un agente per cartella: Quando usi la struttura nidificata, organizza per agente per chiarezza
Argomenti correlati
- Knowledge Base — Creazione e gestione delle knowledge base
- Agenti vocali IA — Collegare KB agli agenti
- Prompt Engineering — Scrivere prompt efficaci