Importação em Massa via ZIP
Em vez de criar bases de conhecimento uma a uma, pode importar várias bases de conhecimento de uma só vez carregando um arquivo ZIP. Isto é especialmente útil quando tem muitas bases de conhecimento preparadas para um agente.
Início Rápido
- Vá a Knowledge Base na barra lateral
- Clique em "Import ZIP"
- Arraste o seu arquivo ZIP para a área de upload
- Reveja e edite os resultados analisados
- Clique em "Import"
Estrutura do Arquivo ZIP
Estrutura Simples (Agente Único)
Coloque todos os ficheiros KB e um ficheiro TRIGGERS.md na raiz do arquivo:
hanc-support-agent.zip
├── KB01_platform_overview.md
├── KB02_pricing_plans.md
├── KB03_agent_setup.md
├── KB04_integrations.md
├── KB05_faq.md
└── TRIGGERS.md
Estrutura Aninhada (Vários Agentes)
Pode organizar bases de conhecimento em pastas. Cada pasta é processada de forma independente com o seu próprio 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
Regras de Nomenclatura de Ficheiros
Ficheiros KB
Os ficheiros KB devem começar com KB seguido de um 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 |
O texto após o número é opcional e apenas para a sua referência. O sistema usa o número para fazer correspondência entre os ficheiros KB e os seus prompts em TRIGGERS.md.
TRIGGERS.md
O ficheiro deve ter o nome exatamente TRIGGERS.md (não sensível a maiúsculas/minúsculas). Contém prompts (descrições) para cada base de conhecimento.
Formato do Ficheiro KB
Cada ficheiro KB deve ser um ficheiro Markdown (.md) que comece com um cabeçalho H1 (# Título). Este cabeçalho torna-se o nome da base de conhecimento no sistema.
Exemplo: 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
O Que é Extraído
| Parte | Como É Usada |
|---|---|
Cabeçalho H1 (# Título) | Nome da base de conhecimento (máx 100 caracteres) |
| Conteúdo completo do ficheiro | Ficheiro da base de conhecimento (carregado como .md) |
Se um ficheiro KB não tiver cabeçalho H1, o nome do ficheiro será usado como nome em vez disso. Verá um aviso e pode editá-lo antes de importar.
Formato TRIGGERS.md
TRIGGERS.md define o prompt para cada base de conhecimento. O prompt diz ao agente IA quando e como usar esta base de conhecimento.
Estrutura
Cada secção começa com ## KB seguido do número (correspondendo ao número do ficheiro KB). O texto abaixo torna-se o 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.
Diretrizes para Prompts
| Regra | Detalhes |
|---|---|
| Comprimento máx | 300 caracteres por prompt |
| Formato de secção | ## KB01, ## KB02, etc. |
| Conteúdo | Descreva o que a KB contém e quando usá-la |
| Língua | Escreva na mesma língua que o seu agente |
- Seja específico: Em vez de "informação geral", escreva "funcionalidades da plataforma, integrações suportadas e requisitos técnicos"
- Inclua palavras-gatilho: Mencione os tópicos-chave que devem ativar esta KB
- Descreva a finalidade: Explique não só o que está na KB, mas quando o agente deve usá-la
Exemplo com Numeração Diferente
Ambos os formatos são suportados:
## KB01
Prompt for knowledge base 1...
## KB-02
Prompt for knowledge base 2...
O traço entre KB e o número é opcional. Tanto KB01 como KB-01 referem-se à mesma base de conhecimento.
Processo de Importação
Passo 1: Carregar ZIP
Arraste e largue o seu ficheiro ZIP na área de upload ou clique para navegar. O tamanho máximo do ficheiro é 50 MB.
Passo 2: Rever
Após o upload, verá uma tabela com todas as bases de conhecimento analisadas:
| Coluna | Descrição |
|---|---|
| Name | Extraído do cabeçalho H1 (editável) |
| Prompt | Extraído de TRIGGERS.md (editável, máx 300 caracteres) |
| File | Nome original do ficheiro |
Pode:
- Editar qualquer nome ou prompt antes de importar
- Remover bases de conhecimento que não quer importar
- Voltar para carregar um ZIP diferente
Passo 3: Corrigir Avisos
Se o sistema detetar problemas, verá avisos amarelos:
| Aviso | Significado | Ação |
|---|---|---|
| TRIGGERS.md not found | A pasta não tem TRIGGERS.md | Preencher prompts manualmente |
| No H1 heading | O ficheiro KB não começa com # Título | Editar o nome na tabela |
| No matching section in TRIGGERS.md | TRIGGERS.md não tem ## KBxx para este ficheiro | Preencher o prompt manualmente |
| File is empty | O ficheiro KB não tem conteúdo | O ficheiro é ignorado automaticamente |
O botão Import está desativado até todos os nomes e prompts estarem preenchidos. Os campos vazios são destacados a vermelho.
Passo 4: Importar
Clique em "Import" para iniciar o upload. Uma barra de progresso mostra o estado do upload. As bases de conhecimento são criadas uma a uma.
Após a conclusão:
- Todas com sucesso: O modal fecha, aparece a notificação de sucesso
- Algumas falharam: A notificação de erro mostra quantas tiveram sucesso vs. total
Exemplo Completo
Eis um exemplo completo de um conjunto de bases de conhecimento para um agente de vendas HANC.AI que apresenta a plataforma a potenciais clientes.
Estrutura de Pastas
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 Após Importação
| Nome | Prompt | Ficheiro |
|---|---|---|
| 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 |
Dicas
- Identificador de agente no H1: Adicione uma tag como
[sales]ou[support]aos cabeçalhos H1 para identificar facilmente a que agente pertence uma KB ao vê-las na lista - Consistência de numeração: Use a mesma numeração nos nomes de ficheiros e em TRIGGERS.md (
KB01no nome do ficheiro =## KB01em TRIGGERS.md) - Teste antes de importar: Verifique o conteúdo do seu arquivo antes de carregar para evitar ter de corrigir vários avisos
- Um agente por pasta: Ao usar estrutura aninhada, organize por agente para clareza
Tópicos Relacionados
- Base de Conhecimento — Criar e gerir bases de conhecimento
- Agentes de Voz IA — Ligar KB a agentes
- Engenharia de Prompts — Escrever prompts eficazes