您的首个代理
本教程引导您创建、配置和测试您的首个 AI 语音代理。完成后,您将拥有一个可以回答您业务问题的可用代理。
我们将构建什么
一个语音代理:
- 专业地问候来电者
- 使用您的业务信息回答问题
- 提供营业时间和联系方式
- 知道何时转给人工
预计时间: 15-20 分钟
前提条件
开始前,请确保您已经:
- 创建了 Hanc.AI 账户(账户设置)
- 登录到平台
- 准备好您业务的基本信息
步骤 1:创建新代理
创建代理有两种路径:基于模板(推荐新手)或从零开始。
路径 A:基于模板(推荐)
模板角色提供让您快速上手的预构建配置。Hanc.AI 在两个类别中提供 24 个即用型角色模板。
1.1 导航至语音代理
- 在左侧边栏点击 "Voice Agents"
- 如果这是您首次访问,入门导览将逐步引导您浏览界面
1.2 开始创建代理
点击 "Create Voice Agent" 按钮。出现一个模态对话框,有两个选项:
- Start from Scratch —— 创建您手动配置的空白代理(参见下面的路径 B)
- Template Roles —— 组织在两个类别中的 24 个角色模板
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 | 产品或服务演示、demo |
面向员工(10 个角色):
| 模板 | 最适合 |
|---|---|
| Secretary | 内部通话管理、安排、留言 |
| Recruiter | 候选人筛选、面试安排 |
| Onboarder | 新员工入职、导览 |
| Coordinator | 团队协调、会议安排 |
| Controller | 流程监控、状态更新、合规检查 |
| Internal Helpdesk | IT 支持、内部常见问题、员工协助 |
| Data Collector | 从团队成员收集结构化数据 |
| Approval Agent | 路由审批、收集签字 |
| Procurement Agent | 采购请求、供应商咨询 |
| Dispatcher | 任务分配、资源调配、调度 |
对于本教程: 选择任何符合您用例的模板。
模板角色包括为特定角色优化的预写提示词、问候消息和对话协议。您可以在创建后自定义所有内容。
1.4 查看模板详情
点击任何模板卡打开详情视图,显示:
- 角色及代理功能的描述
- 使用此模板的好处
- 代理将具备的能力
- 语言选择器 —— 先选择语言(例如 English、Deutsch),然后选择区域变体(例如 United States、Austria、Switzerland)和匹配的语音
- Download as Word document —— 将 Setup Wizard 的问题导出为您所选语言的
.docx文件,以便您的团队可以离线填写。填写后,同一 Guided Setup 向导可以读回文档并自动填充每个匹配的字段 —— 参见下面的通过 Word 文档填写
每个模板都在 20 种支持的语言中提供,具有母语级质量的提示词和针对每种语言的语音选项。德语的 Receptionist 角色使用真实的德语基线,而不是英语模板的翻译。
通过 Word 文档填写
如果您更愿意离线收集业务信息(或在队友之间分配工作),请使用 Word 文档路径:
- 在角色详情模态对话框上点击 Download as Word document —— 您将获得与所选角色和语言匹配的
.docx。 - 在您有答案的所有部分填写。跳过您不知道的内容。
- 点击 Guided Setup 打开同一角色的向导。
- 在向导内,点击 Upload filled document 并选择文件。向导解析您的答案并显示类似 "12 of 18 fields filled from the document." 的确认。
- 审查并调整预填字段,然后正常继续向导。
您可以随时重新上传文档 —— 每次上传都使用文件中的最新值刷新匹配的字段。
1.5 选择如何创建
从模板详情视图,您有两个按钮:
- Deploy Agent —— 使用模板默认值即时创建代理。您可以稍后使用 Setup Wizard 填写您的业务详情。这是最快的开始方式。
- Guided Setup —— 打开一个逐步向导,您在其中填写业务详情(公司名称、服务、联系信息等),然后创建代理。
Deploy Agent 非常适合您想先探索代理并稍后配置它的情况。Guided Setup 更好,如果您已准备好业务信息并希望从一开始就拥有更完整的代理。
1.6 Guided Setup(如选择)
如果您点击 Guided Setup,向导会引导您填写您业务特有的详情:
- 公司名称、服务、联系详情
- 营业时间、地点、定价
- 具体指令和政策
重要: 您可以跳过不适用于您业务的字段或整个部分。但是,至少必须完整填写一个部分才能继续。
完成向导后,您的代理将以您提供的所有详情创建。
路径 B:从零开始
为从一开始就完全控制:
- 点击 "Create Voice Agent"
- 选择 "Start from Scratch"
- 使用默认提示词创建空白代理
- 您将在下一步手动配置一切
步骤 2:创建后
创建您的代理后,您将看到一个带有建议后续步骤的成功横幅。入门导览将引导您浏览代理配置标签,突出关键设置和功能。
您的代理附带两个默认检索变量 —— Email 和 Phone —— 以便它可以立即从来电者收集联系信息。您可以在 Actions 标签中自定义或移除这些。
Setup Wizard
寻找代理名称旁边的发光魔杖图标 —— 这是 Setup Wizard。它帮助您按章节填写其余详情。
Setup Wizard 如何工作:
- 进度跟踪为 "X/Y sections completed",以便您始终知道还剩什么
- 每个部分涵盖不同的配置区域:Agent Configuration、Company Profile、Services、Specialists、Locations 等
- 您可以跳过不需要的字段或整个部分(每个部分最少 1 个字段)
- 按您自己的节奏以任何顺序完成各部分
如果您使用 Deploy Agent,Setup Wizard 是您在创建后添加业务详情的主要方式。如果您使用 Guided Setup,某些部分将已填写。
手动编辑提示词或知识库文件会禁用 Setup Wizard。如果发生这种情况,会出现 "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 知识库
知识库为您的代理提供回答问题所需的事实。
- 在代理设置中前往 Knowledge Base 标签
- 创建新的知识库或选择现有的
- 上传包含您业务信息的文件
接受的文件格式: .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 通过网页小组件测试
- 在 Voice Agents 列表中找到您的代理
- 点击 "Talk to agent" 或测试/通话按钮
- 在浏览器中允许麦克风访问
- 开始说话
4.2 通过电话号码测试
如果您已连接电话号码:
- 将您的代理分配给该号码(在 Phone Numbers 设置中)
- 从任何电话拨打该号码
4.3 测试场景
测试 1:基本问候
- 等待代理的问候
- 说:"您好"
- 代理应自然响应
测试 2:营业时间
- 说:"您的营业时间是什么?"
- 代理应从知识库提供您的营业时间
测试 3:服务问题
- 说:"您提供哪些服务?"
- 代理应列出您的服务
测试 4:价格问题
- 说:"[您的服务]多少钱?"
- 代理应在知识库中时给出价格
测试 5:未知问题
- 说:"生命的意义是什么?"
- 代理应礼貌地说它没有该信息
4.4 结束测试
完成后点击 "End call" 或关闭测试窗口。
步骤 5:完善您的代理
基于测试,您可能想要改进:
常见问题和修复
| 问题 | 解决方案 |
|---|---|
| 代理说话太多 | 添加到提示词:"将响应保持在 1-2 句" |
| 代理太正式 | 调整提示词语气:"友好且对话式" |
| 代理不知道信息 | 检查知识库是否有该信息 |
| 代理编造内容 | 在提示词中强调:"NEVER invent information" |
| 错误的语言 | 检查 Language 设置是否匹配您的需求 |
| 语音太快/太慢 | 调整语音速度设置 |
迭代和改进
- 测试 → 识别问题 → 调整提示词/设置 → 再测试
- 基于测试通话向知识库添加更多常见问题
- 基于真实对话完善提示词
步骤 6:部署您的代理(可选)
对测试满意后,您可以部署您的代理:
选项 A:连接电话号码
- 前往 Phone Numbers
- 购买号码或导入现有号码
- 将您的代理分配给该号码
- 该号码的通话现在由您的代理处理
选项 B:添加网站小组件
- 前往您的代理设置
- 找到 Widgets 标签
- 复制嵌入代码
- 添加到您的网站
清单:您的代理准备好了吗?
上线前,验证:
- 首条消息清晰且欢迎
- 提示词正确定义行为
- 知识库有准确的信息
- 代理很好地处理常见问题
- 代理在不知道某事时承认
- 语音听起来适合您的品牌
- 语言设置正确
- 测试通话产生良好结果
接下来做什么?
恭喜!您已创建了您的首个语音代理。
继续学习:
故障排查
代理无法启动测试通话
- 检查浏览器麦克风权限
- 尝试不同的浏览器
- 确保稳定的互联网连接
代理不响应
- 等待几秒 —— 可能有处理延迟
- 清晰且不太快地说话
- 检查代理未暂停/非活跃
代理提供错误信息
- 验证知识库内容正确
- 检查知识库已连接到代理
- 审查提示词中是否有冲突指令
语音质量差
- 检查您的互联网连接
- 尝试不同的语音
- 减少背景噪音
需要帮助?
- 审查 故障排查指南
- 联系 support@hanc.ai