跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

创建第一个代理

本教程将引导你创建、配置并测试你的第一个 AI 语音代理。完成后，你将拥有一个能够回答业务相关问题的可用代理。

我们将构建什么​

一个语音代理，它能够：

  • 专业地问候来电者
  • 使用你的业务信息回答问题
  • 提供营业时间和联系方式
  • 知道何时该转接给人工

预计耗时： 15-20 分钟

前置条件​

开始之前，请确认你已经：

  • 创建了 Hanc.AI 账户（账户设置）
  • 登录了平台
  • 准备好了关于你业务的基本信息

第 1 步：创建新代理​

创建代理有两条路径：基于模板（推荐初学者）或从零开始。

路径 A：基于模板（推荐）​

模板角色提供预建的配置，助你快速上手。Hanc.AI 提供分为两大类的 24 个即用型角色模板。

1.1 前往语音代理​

  1. 点击左侧边栏的 "Voice Agents"
  2. 如果这是你第一次进入，一个引导教程会逐步带你熟悉界面

1.2 开始创建代理​

点击 "Create Voice Agent" 按钮。会弹出一个含两个选项的对话框：

  • Start from Scratch——创建一个由你手动配置的空白代理（见下面的路径 B）
  • Template Roles——分为两大类的 24 个角色模板
更想用大白话描述？

你也可以用 Hanc Studio 来构建代理——描述你的需求，它就会为你组装出一个现成的代理（角色、工作流、知识库和集成）。

1.3 浏览模板角色​

模板角色分为两大类：

面向客户（14 个角色）：

模板最适合
Sales Agent销售通话、推介、成交
Receptionist问候来电者、转接、一般咨询
Consultant探索性通话、需求评估、咨询建议
Support Agent客户支持、故障排查、问题解决
Order Agent下单、订单追踪、修改订单
Call Router将来电者引导至正确的部门或人员
Reminder Agent预约提醒、跟进、通知
Feedback Agent收集客户反馈和问卷
Collection Agent付款提醒、发票跟进
Lead Qualifier甄别呼入线索、收集潜在客户信息
Guide分步说明、引导上手、操作演示
Promoter产品认知、营销活动、漏斗顶端互动
Auto-Answerer自动接听来电、提供基本信息
Presenter产品或服务介绍、演示

面向员工（10 个角色）：

模板最适合
Secretary内部通话管理、日程安排、留言记录
Recruiter候选人筛选、面试安排
Onboarder新员工入职、迎新引导
Coordinator团队协调、会议安排
Controller流程监控、状态更新、合规检查
Internal HelpdeskIT 支持、内部 FAQ、员工协助
Data Collector从团队成员处收集结构化数据
Approval Agent转派审批、收集签核
Procurement Agent采购申请、供应商咨询
Dispatcher任务分配、资源调度、派单

在本教程中： 选择任意一个符合你使用场景的模板。

为什么要使用模板角色？

模板角色包含针对特定角色优化的预写提示词、问候语和对话协议。创建后你可以对一切进行自定义。

1.4 查看模板详情​

点击任意模板卡片可打开详情视图，其中显示：

  • 该角色及代理功能的描述
  • 使用此模板的优势
  • 代理将拥有的能力
  • 语言选择器——先选择一种语言（如 English、Deutsch），再选择区域变体（如 United States、Austria、Switzerland）及匹配的语音
  • 下载为 Word 文档——将设置向导的问题以你所选语言导出为 .docx 文件，方便你的团队离线填写。填好后，同一个引导式设置向导可以读回该文档并自动填充所有匹配的字段——见下面的通过 Word 文档填写
语言覆盖范围

每个模板都提供 25 种受支持语言，并为每种语言配备母语级别的提示词和语音选项。德语版的 Receptionist 角色使用真正的德语底本，而非从英语模板翻译而来。

通过 Word 文档填写​

如果你更愿意离线收集业务信息（或在团队成员之间分工），可以使用 Word 文档路径：

  1. 在角色详情对话框中点击 Download as Word document——你会得到一个与所选角色和语言匹配的 .docx。
  2. 尽你所能填写各个部分。不清楚的就跳过。
  3. 点击 Guided Setup 打开同一角色的向导。
  4. 在向导中点击 Upload filled document 并选择该文件。向导会解析你的答案，并显示类似 "12 of 18 fields filled from the document."（已从文档填充 18 个字段中的 12 个）的确认信息。
  5. 检查并调整预填的字段，然后照常继续完成向导。

你可以随时重新上传该文档——每次上传都会用文件中的最新值刷新匹配的字段。

1.5 选择创建方式​

在模板详情视图中，你有两个按钮：

  • Deploy Agent——使用模板默认值即时创建代理。你稍后可以用设置向导填写业务详情。这是最快的上手方式。
  • Guided Setup——打开一个分步向导，在代理创建之前填写你的业务详情（公司名称、服务、联系方式等）。
我该选哪个按钮？

如果你想先探索代理、稍后再配置，Deploy Agent 很合适。如果你已经准备好业务信息、希望从一开始就得到一个更完整的代理，那么 Guided Setup 更好。

1.6 引导式设置（如果选择了）​

如果你点击了 Guided Setup，一个向导会带你填写你业务专属的详情：

  • 公司名称、服务、联系方式
  • 营业时间、位置、价格
  • 具体的说明和政策

重要： 你可以跳过不适用于你业务的字段或整个部分。但在继续之前，至少要完整填写一个部分。

完成向导后，你的代理将带着你提供的所有详情被创建出来。

路径 B：从零开始​

如果想从一开始就完全掌控：

  1. 点击 "Create Voice Agent"
  2. 选择 "Start from Scratch"
  3. 系统会创建一个带默认提示词的空白代理
  4. 你将在下一步手动配置一切

第 2 步：创建之后​

代理创建完成后，你会看到一个成功横幅，其中含建议的后续步骤。一个引导教程会带你了解代理配置选项卡，突出显示关键设置和功能。

你的代理自带两个默认检索变量——Email 和 Phone——因此它能立刻从来电者处收集联系信息。你可以在 Actions 选项卡中自定义或删除它们。

设置向导​

在你的代理名称旁边找到发光的魔杖图标——这就是设置向导。它会帮助你逐部分填写剩余的详情。

设置向导的工作方式：

  • 进度以 "X/Y sections completed"（已完成 X/Y 个部分）跟踪，让你随时知道还剩什么
  • 每个部分涵盖配置的不同方面：Agent Configuration、Company Profile、Services、Specialists、Locations 等
  • 你可以跳过不需要的字段或整个部分（每部分最少 1 个字段）
  • 按你自己的节奏，以任意顺序完成各部分
信息

如果你使用了 Deploy Agent，设置向导就是你在创建后添加业务详情的主要方式。如果你使用了 Guided Setup，某些部分会已经填好。

重要

手动编辑提示词或知识库文件会禁用设置向导。若发生这种情况，会出现一个 "Reset to Template" 按钮，让你恢复向导功能。

代理选项卡​

你的代理配置页面有以下选项卡：

选项卡包含内容
Dashboard代理活动概览和统计数据
Model提示词、语音、语言和 AI 模型设置
Knowledge Base代理用于回答问题的文件和信息
Settings通话设置、首条消息、通话时长限制
Actions通话后动作（邮件、短信、Webhook）
Widgets用于嵌入你网站的网页小组件配置

第 3 步：配置代理设置​

3.1 提示词​

提示词定义了代理的性格、行为和对话流程。

如果你使用了模板，提示词已预先填好。检查它并针对你的业务进行自定义。

如果你从零开始，请编写你的提示词：

## Role
You are a friendly virtual assistant for [Your Business Name].
You help customers with questions about our services, hours, and booking appointments.

## Communication Style
- Speak clearly and concisely
- Be polite and professional
- Keep responses short (1-3 sentences when possible)
- Ask one question at a time

## Important Rules
1. Only provide information you know for certain
2. If you don't know something, say "I don't have that information, but I can connect you with our team"
3. Never make up prices, availability, or other specific details
4. Transfer to a human if the customer is upset or has a complex issue
关键规则

务必加入这条指令："Never make up information."（切勿编造信息。）这能防止 AI 虚构关于你业务的虚假细节。

3.2 知识库​

知识库为你的代理提供回答问题所需的事实。

  1. 前往代理设置中的 Knowledge Base 选项卡
  2. 创建一个新知识库或选择一个现有的
  3. 上传含你业务信息的文件

支持的文件格式： .txt、.md、.docx、.pdf、.html、.csv

应包含的内容：

  • 服务和价格
  • 营业时间和位置
  • 常见问题
  • 政策（取消、付款等）
  • 团队信息
重要

代理只知道知识库里的内容。如果信息缺失，代理就无法回答那些问题。请添加所有重要细节。

3.3 语音​

选择一个符合你品牌的语音：

  • 选择语言
  • 浏览可用语音（男声/女声、不同风格）
  • 选定前先试听语音

3.4 通话设置​

配置通话行为：

  • 首条消息（代理接听时的问候语）
  • 语言设置
  • 通话时长限制

3.5 工具​

添加代理在通话中可使用的工具：

  • 用于预约排期的 Google Calendar
  • 自定义 API 集成

3.6 动作​

设置对话结束后触发的通话后动作：

  • 发送邮件摘要
  • 发送短信通知
  • 触发 Webhook
  • 发起 API 调用

3.7 小组件​

配置用于嵌入你网站的网页小组件：

  • 外观和颜色
  • 位置和行为
  • 自定义品牌

3.8 保存设置​

点击 "Save" 或 "Update" 保存你的配置。

第 4 步：测试你的代理​

现在来看看你的代理实战表现吧！

4.1 通过网页小组件测试​

  1. 在语音代理列表中找到你的代理
  2. 点击 "Talk to agent" 或测试/通话按钮
  3. 在浏览器中允许麦克风访问
  4. 开始说话

4.2 通过电话号码测试​

如果你已连接了电话号码：

  1. 将你的代理分配给该号码（在电话号码设置中）
  2. 用任意电话拨打该号码

4.3 测试场景​

测试 1：基本问候

  • 等待代理的问候语
  • 说："Hello"
  • 代理应自然地回应

测试 2：营业时间

  • 说："What are your opening hours?"
  • 代理应从知识库提供你的营业时间

测试 3：服务问题

  • 说："What services do you offer?"
  • 代理应列出你的服务

测试 4：价格问题

  • 说："How much does [your service] cost?"
  • 如果知识库中有价格，代理应给出

测试 5：未知问题

  • 说："What is the meaning of life?"
  • 代理应礼貌地表示它没有该信息

4.4 结束测试​

完成后点击 "End call" 或关闭测试窗口。

第 5 步：优化你的代理​

根据测试情况，你可能想改进：

常见问题与修复​

问题解决方法
代理话太多在提示词中加入："Keep responses to 1-2 sentences"
代理太正式调整提示词语气："Be friendly and conversational"
代理不知道信息检查知识库中是否包含该信息
代理编造内容在提示词中强调："NEVER invent information"
语言错误检查语言设置是否符合你的需要
语音太快/太慢调整语音速度设置

迭代与改进​

  1. 测试 → 找出问题 → 调整提示词/设置 → 再次测试
  2. 根据测试通话为知识库添加更多 FAQ
  3. 根据真实对话优化提示词

第 6 步：部署你的代理（可选）​

对测试结果满意后，你就可以部署你的代理：

方式 A：连接电话号码​

  1. 前往 Phone Numbers
  2. 购买一个号码或导入一个现有号码
  3. 将你的代理分配给该号码
  4. 拨往该号码的来电现在都由你的代理处理

方式 B：添加网站小组件​

  1. 前往你的代理设置
  2. 找到 Widgets 选项卡
  3. 复制嵌入代码
  4. 添加到你的网站

检查清单：你的代理准备好了吗？​

上线前，请核实：

  • 首条消息清晰且热情
  • 提示词正确定义了行为
  • 知识库信息准确
  • 代理能很好地处理常见问题
  • 代理会在不知道时承认
  • 语音契合你的品牌
  • 语言设置正确
  • 测试通话结果良好

下一步​

恭喜！你已经创建了你的第一个语音代理。

继续学习：

  1. 语音代理深入解析——高级代理配置
  2. 知识库最佳实践——创建更好的知识库
  3. 电话号码——连接真实电话号码
  4. 模板角色——即用型提示词和配置
  5. 通话活动——设置外呼通话活动

故障排查​

代理无法开始测试通话​

  • 检查浏览器麦克风权限
  • 尝试其他浏览器
  • 确保网络连接稳定

代理没有响应​

  • 稍等几秒——可能存在处理延迟
  • 说得清晰一些，别太快
  • 检查代理是否被暂停/停用

代理提供错误信息​

  • 核实知识库内容是否正确
  • 检查知识库是否已连接到代理
  • 检查提示词中是否有相互冲突的指令

语音质量差​

  • 检查你的网络连接
  • 尝试其他语音
  • 减少背景噪音

需要帮助？​