跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

通过 ZIP 批量导入

您可以通过上传 ZIP 存档一次导入多个知识库,而不是一个一个创建。当您为代理准备了许多知识库时,这特别有用。

快速开始​

  1. 转到侧边栏中的知识库
  2. 点击**"导入 ZIP"**
  3. 将您的 ZIP 存档拖入上传区域
  4. 查看并编辑解析结果
  5. 点击**"导入"**

ZIP 存档结构​

简单结构(单个代理)​

将所有 KB 文件和一个 TRIGGERS.md 文件放在存档的根目录中:

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

嵌套结构(多个代理)​

您可以将知识库组织到文件夹中。每个文件夹都用自己的 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

文件命名规则​

KB 文件​

KB 文件必须以 KB 开头,后跟一个数字:

有效无效
KB01_platform_overview.mdplatform_overview.md
KB02_pricing.md02_pricing.md
KB1_faq.mdknowledge_base_1.md
KB10_integrations.mdFAQ.md
提示

数字后的文本是可选的,仅供您参考。系统使用数字将 KB 文件与 TRIGGERS.md 中的提示词匹配。

TRIGGERS.md​

文件必须完全命名为 TRIGGERS.md(不区分大小写)。它包含每个知识库的提示词(描述)。

KB 文件格式​

每个 KB 文件必须是以 H1 标题(# 标题)开头的 Markdown 文件(.md)。此标题成为系统中知识库的名称。

示例: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

提取的内容​

部分如何使用
H1 标题(# 标题)知识库名称(最多 100 个字符)
完整文件内容知识库文件(作为 .md 上传)
注意

如果 KB 文件没有 H1 标题,将使用文件名作为名称。您将看到警告,可以在导入前对其进行编辑。

TRIGGERS.md 格式​

TRIGGERS.md 定义每个知识库的提示词。提示词告诉 AI 代理何时以及如何使用此知识库。

结构​

每个部分以 ## KB 开头,后跟数字(匹配 KB 文件编号)。下面的文本成为提示词。

## 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.

提示词指南​

规则详情
最大长度每个提示词 300 个字符
部分格式## KB01、## KB02 等
内容描述 KB 包含的内容以及何时使用
语言用与您的代理相同的语言书写
提示词最佳实践
  • 具体些: 不要写"常规信息",而是写"平台功能、支持的集成和技术要求"
  • 包含触发词: 提及应激活此 KB 的关键主题
  • 描述目的: 不仅解释 KB 中有什么,还要解释代理应何时使用它

不同编号的示例​

两种格式都受支持:

## KB01
Prompt for knowledge base 1...

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

KB 和数字之间的破折号是可选的。KB01 和 KB-01 都指同一个知识库。

导入过程​

第 1 步:上传 ZIP​

将您的 ZIP 文件拖放到上传区域或点击浏览。最大文件大小为 50 MB。

第 2 步:审查​

上传后,您将看到一个包含所有解析的知识库的表:

列描述
名称从 H1 标题提取(可编辑)
提示词从 TRIGGERS.md 提取(可编辑,最多 300 字符)
文件原始文件名

您可以:

  • 在导入前编辑任何名称或提示词
  • 删除您不想导入的知识库
  • 返回上传不同的 ZIP

第 3 步:修复警告​

如果系统检测到问题,您将看到黄色警告:

警告含义操作
未找到 TRIGGERS.md文件夹没有 TRIGGERS.md手动填写提示词
无 H1 标题KB 文件不以 # 标题开头在表中编辑名称
TRIGGERS.md 中没有匹配的部分TRIGGERS.md 没有此文件的 ## KBxx手动填写提示词
文件为空KB 文件没有内容文件自动跳过
important

导入按钮在所有名称和提示词填写完毕之前都被禁用。空字段以红色突出显示。

第 4 步:导入​

点击**"导入"**开始上传。进度条显示上传状态。知识库一个接一个地创建。

完成后:

  • 全部成功: 模态框关闭,出现成功通知
  • 部分失败: 错误通知显示成功了多少与总数

完整示例​

这是一个用于向潜在客户展示平台的 HANC.AI 销售代理的知识库集的完整示例。

文件夹结构​

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.

导入后的结果​

名称提示词文件
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

提示​

  • H1 中的代理标识符: 在 H1 标题中添加像 [sales] 或 [support] 这样的标签,以便在列表中查看 KB 时轻松识别其所属的代理
  • 编号一致性: 在文件名和 TRIGGERS.md 中使用相同的编号(文件名中的 KB01 = TRIGGERS.md 中的 ## KB01)
  • 导入前测试: 在上传前检查您的存档内容,以避免必须修复多个警告
  • 每个文件夹一个代理: 使用嵌套结构时,按代理组织以保持清晰

相关主题​