Import en masse via ZIP

Au lieu de créer les bases de connaissances une par une, vous pouvez en importer plusieurs à la fois en téléversant une archive ZIP. C'est particulièrement utile lorsque vous avez de nombreuses bases de connaissances préparées pour un agent.

Démarrage rapide

1. Allez dans Base de connaissances dans la barre latérale
2. Cliquez sur « Importer un ZIP »
3. Déposez votre archive ZIP dans la zone de téléversement
4. Vérifiez et modifiez les résultats analysés
5. Cliquez sur « Importer »

---

Structure de l'archive ZIP

Structure simple (un seul agent)

Placez tous les fichiers de KB et un fichier TRIGGERS.md à la racine de l'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

Structure imbriquée (plusieurs agents)

Vous pouvez organiser les bases de connaissances en dossiers. Chaque dossier est traité indépendamment avec son propre 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

---

Règles de nommage des fichiers

Fichiers KB

Les fichiers KB doivent commencer par KB suivi d'un numéro :

Valide	Invalide
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

astuce

Le texte après le numéro est facultatif et sert uniquement à votre référence. Le système utilise le numéro pour faire correspondre les fichiers KB à leurs prompts dans TRIGGERS.md.

TRIGGERS.md

Le fichier doit être nommé exactement TRIGGERS.md (insensible à la casse). Il contient les prompts (descriptions) de chaque base de connaissances.

---

Format des fichiers KB

Chaque fichier KB doit être un fichier Markdown (.md) qui commence par un titre H1 (# Titre). Ce titre devient le nom de la base de connaissances dans le système.

Exemple : 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

Ce qui est extrait

Élément	Comment il est utilisé
Titre H1 (# Titre)	Nom de la base de connaissances (max 100 caractères)
Contenu complet du fichier	Fichier de la base de connaissances (téléversé en .md)

attention

Si un fichier KB n'a pas de titre H1, le nom du fichier sera utilisé comme nom à la place. Vous verrez un avertissement et pourrez le modifier avant l'import.

---

Format de TRIGGERS.md

TRIGGERS.md définit le prompt de chaque base de connaissances. Le prompt indique à l'agent IA quand et comment utiliser cette base de connaissances.

Structure

Chaque section commence par ## KB suivi du numéro (correspondant au numéro du fichier KB). Le texte en dessous devient le 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.

Recommandations pour les prompts

Règle	Détails
Longueur max	300 caractères par prompt
Format de section	## KB01, ## KB02, etc.
Contenu	Décrivez ce que contient la KB et quand l'utiliser
Langue	Rédigez dans la même langue que votre agent

Bonnes pratiques pour les prompts

• Soyez précis : au lieu de « informations générales », écrivez « fonctionnalités de la plateforme, intégrations prises en charge et exigences techniques »
• Incluez des mots déclencheurs : mentionnez les sujets clés qui doivent activer cette KB
• Décrivez l'objectif : expliquez non seulement ce qu'il y a dans la KB, mais aussi quand l'agent doit l'utiliser

Exemple avec une numérotation différente

Les deux formats sont pris en charge :

## KB01
Prompt for knowledge base 1...

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

Le tiret entre KB et le numéro est facultatif. KB01 et KB-01 désignent la même base de connaissances.

---

Processus d'import

Étape 1 : Téléverser le ZIP

Glissez-déposez votre fichier ZIP dans la zone de téléversement ou cliquez pour parcourir. La taille maximale de fichier est de 50 Mo.

Étape 2 : Vérifier

Après le téléversement, vous verrez un tableau avec toutes les bases de connaissances analysées :

Colonne	Description
Nom	Extrait du titre H1 (modifiable)
Prompt	Extrait de TRIGGERS.md (modifiable, max 300 caractères)
Fichier	Nom de fichier d'origine

Vous pouvez :

• Modifier n'importe quel nom ou prompt avant l'import
• Supprimer les bases de connaissances que vous ne voulez pas importer
• Revenir en arrière pour téléverser un autre ZIP

Étape 3 : Corriger les avertissements

Si le système détecte des problèmes, vous verrez des avertissements jaunes :

Avertissement	Signification	Action
TRIGGERS.md introuvable	Le dossier n'a pas de TRIGGERS.md	Renseignez les prompts manuellement
Pas de titre H1	Le fichier KB ne commence pas par # Titre	Modifiez le nom dans le tableau
Aucune section correspondante dans TRIGGERS.md	TRIGGERS.md n'a pas de ## KBxx pour ce fichier	Renseignez le prompt manuellement
Fichier vide	Le fichier KB n'a aucun contenu	Le fichier est ignoré automatiquement

important

Le bouton Importer est désactivé tant que tous les noms et prompts ne sont pas renseignés. Les champs vides sont surlignés en rouge.

Étape 4 : Importer

Cliquez sur « Importer » pour démarrer le téléversement. Une barre de progression indique l'état du téléversement. Les bases de connaissances sont créées une par une.

Après la fin :

• Tout a réussi : la fenêtre se ferme, une notification de succès apparaît
• Certaines ont échoué : une notification d'erreur indique combien ont réussi par rapport au total

---

Exemple complet

Voici un exemple complet d'un ensemble de bases de connaissances pour un agent commercial HANC.AI qui présente la plateforme à des clients potentiels.

Structure des dossiers

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.

Résultat après import

Nom	Prompt	Fichier
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

---

Astuces

• Identifiant d'agent dans le H1 : ajoutez une balise comme [sales] ou [support] aux titres H1 pour identifier facilement à quel agent appartient une KB lorsque vous les consultez dans la liste
• Cohérence de la numérotation : utilisez la même numérotation dans les noms de fichiers et dans TRIGGERS.md (KB01 dans le nom de fichier = ## KB01 dans TRIGGERS.md)
• Testez avant d'importer : vérifiez le contenu de votre archive avant de la téléverser pour éviter d'avoir à corriger plusieurs avertissements
• Un agent par dossier : avec une structure imbriquée, organisez par agent pour plus de clarté

---

Sujets connexes

• Base de connaissances — Créer et gérer des bases de connaissances
• Agents vocaux — Connecter une KB aux agents
• Prompt Engineering — Rédiger des prompts efficaces