Importación masiva mediante ZIP

En lugar de crear las bases de conocimiento una por una, puedes importar varias a la vez subiendo un archivo ZIP. Esto es especialmente útil cuando tienes muchas bases de conocimiento preparadas para un agente.

Inicio rápido

Ve a Knowledge Base en la barra lateral
Haz clic en "Import ZIP"
Suelta tu archivo ZIP en el área de carga
Revisa y edita los resultados analizados
Haz clic en "Import"

Estructura del archivo ZIP

Estructura sencilla (un solo agente)

Coloca todos los archivos KB y un archivo TRIGGERS.md en la raíz del archivo:

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

Estructura anidada (varios agentes)

Puedes organizar las bases de conocimiento en carpetas. Cada carpeta se procesa de forma independiente con su propio 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

Reglas de nombres de archivo

Archivos KB

Los archivos KB deben empezar por KB seguido de un número:

Válido	Inválido
`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`

consejo

El texto después del número es opcional y solo es para tu referencia. El sistema usa el número para emparejar los archivos KB con sus prompts en TRIGGERS.md.

TRIGGERS.md

El archivo debe llamarse exactamente TRIGGERS.md (sin distinción entre mayúsculas y minúsculas). Contiene los prompts (descripciones) de cada base de conocimiento.

Formato del archivo KB

Cada archivo KB debe ser un archivo Markdown (.md) que empiece con un encabezado H1 (# Título). Este encabezado se convierte en el nombre de la base de conocimiento en el sistema.

Ejemplo: `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

Qué se extrae

Parte	Cómo se usa
Encabezado H1 (`# Título`)	Nombre de la base de conocimiento (máx. 100 caracteres)
Contenido completo del archivo	Archivo de la base de conocimiento (subido como .md)

aviso

Si un archivo KB no tiene encabezado H1, se usará el nombre del archivo como nombre. Verás una advertencia y podrás editarlo antes de importar.

Formato de TRIGGERS.md

TRIGGERS.md define el prompt para cada base de conocimiento. El prompt le indica al agente IA cuándo y cómo usar esta base de conocimiento.

Estructura

Cada sección empieza con ## KB seguido del número (coincidiendo con el número del archivo KB). El texto debajo se convierte en el 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.

Pautas del prompt

Regla	Detalles
Longitud máxima	300 caracteres por prompt
Formato de sección	`## KB01`, `## KB02`, etc.
Contenido	Describe qué contiene la KB y cuándo usarla
Idioma	Escribe en el mismo idioma que tu agente

Buenas prácticas para los prompts

Sé específico: en lugar de "información general", escribe "funcionalidades de la plataforma, integraciones soportadas y requisitos técnicos"
Incluye palabras disparadoras: menciona los temas clave que deben activar esta KB
Describe el propósito: explica no solo lo que contiene la KB, sino cuándo debe usarla el agente

Ejemplo con distinta numeración

Ambos formatos están soportados:

## KB01
Prompt for knowledge base 1...

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

El guion entre KB y el número es opcional. Tanto KB01 como KB-01 se refieren a la misma base de conocimiento.

Proceso de importación

Paso 1: Subir el ZIP

Arrastra y suelta tu archivo ZIP en el área de carga o haz clic para navegar. El tamaño máximo de archivo es 50 MB.

Paso 2: Revisar

Tras la subida, verás una tabla con todas las bases de conocimiento analizadas:

Columna	Descripción
Name	Extraído del encabezado H1 (editable)
Prompt	Extraído de TRIGGERS.md (editable, máx. 300 caracteres)
File	Nombre del archivo original

Puedes:

Editar cualquier nombre o prompt antes de importar
Quitar bases de conocimiento que no quieras importar
Volver para subir un ZIP distinto

Paso 3: Corregir advertencias

Si el sistema detecta problemas, verás advertencias amarillas:

Advertencia	Significado	Acción
TRIGGERS.md not found	La carpeta no tiene TRIGGERS.md	Rellena los prompts manualmente
No H1 heading	El archivo KB no empieza con `# Título`	Edita el nombre en la tabla
No matching section in TRIGGERS.md	TRIGGERS.md no tiene `## KBxx` para este archivo	Rellena el prompt manualmente
File is empty	El archivo KB no tiene contenido	El archivo se omite automáticamente

important

El botón Import está deshabilitado hasta que todos los nombres y prompts estén rellenados. Los campos vacíos se resaltan en rojo.

Paso 4: Importar

Haz clic en "Import" para iniciar la subida. Una barra de progreso muestra el estado de la subida. Las bases de conocimiento se crean una a una.

Tras finalizar:

Todas con éxito: el modal se cierra, aparece una notificación de éxito
Algunas fallaron: la notificación de error muestra cuántas tuvieron éxito frente al total

Ejemplo completo

A continuación, un ejemplo completo de un conjunto de bases de conocimiento para un agente de ventas HANC.AI que presenta la plataforma a clientes potenciales.

Estructura de carpetas

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.

Resultado tras la importación

Nombre	Prompt	Archivo
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

Consejos

Identificador del agente en H1: añade una etiqueta como [sales] o [support] a los encabezados H1 para identificar fácilmente a qué agente pertenece una KB al verla en la lista
Coherencia de numeración: usa la misma numeración en los nombres de archivo y en TRIGGERS.md (KB01 en el nombre de archivo = ## KB01 en TRIGGERS.md)
Prueba antes de importar: comprueba el contenido de tu archivo antes de subirlo para no tener que corregir varias advertencias
Un agente por carpeta: al usar la estructura anidada, organiza por agente para mayor claridad

Temas relacionados

Base de conocimiento: crear y gestionar bases de conocimiento
Agentes de voz IA: conectar KB a agentes
Ingeniería de prompts: redactar prompts efectivos

Inicio rápido​

Estructura del archivo ZIP​

Estructura sencilla (un solo agente)​

Estructura anidada (varios agentes)​

Reglas de nombres de archivo​

Archivos KB​

TRIGGERS.md​

Formato del archivo KB​

Ejemplo: KB01_platform_overview.md​

Qué se extrae​

Formato de TRIGGERS.md​

Estructura​

Pautas del prompt​

Ejemplo con distinta numeración​

Proceso de importación​

Paso 1: Subir el ZIP​

Paso 2: Revisar​

Paso 3: Corregir advertencias​

Paso 4: Importar​

Ejemplo completo​

Estructura de carpetas​

KB01_platform_overview.md​

KB02_pricing_plans.md​

TRIGGERS.md​

Resultado tras la importación​

Consejos​

Temas relacionados​

Inicio rápido

Estructura del archivo ZIP

Estructura sencilla (un solo agente)

Estructura anidada (varios agentes)

Reglas de nombres de archivo

Archivos KB

TRIGGERS.md

Formato del archivo KB

Ejemplo: `KB01_platform_overview.md`

Qué se extrae

Formato de TRIGGERS.md

Estructura

Pautas del prompt

Ejemplo con distinta numeración

Proceso de importación

Paso 1: Subir el ZIP

Paso 2: Revisar

Paso 3: Corregir advertencias

Paso 4: Importar

Ejemplo completo

Estructura de carpetas

KB01_platform_overview.md

KB02_pricing_plans.md

TRIGGERS.md

Resultado tras la importación

Consejos

Temas relacionados