自动化外呼机器人技能，用于批量电话外呼。

前置条件

配置阿里云凭证

export ALIBABA_CLOUD_ACCESS_KEY_ID="your-access-key-id"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your-access-key-secret"

绑定外呼号码 ⚠️ 重要

必须申请并绑定外呼号码，否则无法进行外呼。详见 phone-number-setup.md。

执行清单

复制此清单并在执行时逐项打勾：

• [ ] 步骤 0: 校验前置条件 ⛔ BLOCKING — 未通过前禁止继续

- [ ] 0.1 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET 已配置 - [ ] 0.2 已绑定外呼号码（未绑定则读取 phone-number-setup.md）

• [ ] 步骤 1: 获取外呼名单

- [ ] 1A: 前置节点 → 提取号码 + 推断场景描述 - [ ] 1B: 用户直接提供 → 收集号码、场景描述、任务名称

• [ ] 步骤 2: 验证数据

- [ ] 2.1 电话号码格式正确（1开头11位） - [ ] 2.2 场景描述清晰明确

• [ ] 步骤 3: 向用户确认 ⛔ BLOCKING — 未收到明确确认前禁止执行任何外呼
• [ ] 步骤 4: 创建 taskInput.json（请读取 input-formats.md）

- [ ] 4.1 盘点所有已知信息，作为 agentProfile.background 的素材 - [ ] 4.2 构建完整 agentProfile ⛔ 必填 — 不要依赖自动推断，background 写得越详细通话质量越高

• [ ] 步骤 5: 执行外呼
• [ ] 步骤 6: 报告结果并执行交付检查

---

步骤 0: 校验前置条件 ⛔ BLOCKING

在做任何事之前，先确认：

• ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET 是否已配置？未配置则立即告知用户，停止执行。
• 是否已绑定外呼号码？未绑定则读取 phone-number-setup.md 引导用户完成申请，停止执行。

---

步骤 1: 获取外呼名单

场景 A: 从前置节点获取（如简历筛查、CRM 查询等）

先执行前置步骤，从返回结果中提取电话号码，根据用户意图生成场景描述，直接传递给此技能，无需再次询问用户。

场景 B: 用户直接提供

收集以下信息：

• 电话号码列表（必需）— 中国大陆手机号（1开头11位）
• 外呼场景描述（必需）— 清晰描述外呼目的；脚本会自动从描述中推断 industry（行业）和 scene（场景类型）标准值，无需手动指定
• 任务名称（可选）

信息不完整时，向用户询问：

• "需要拨打哪些电话号码？"
• "这次外呼的目的是什么？"

---

步骤 2: 验证数据

逐项检查：

• 这些号码是否都是 1 开头的 11 位数字？有没有明显格式错误？
• 场景描述是否足够具体，能让智能体理解外呼目的？

---

步骤 3: 向用户确认 ⛔ BLOCKING

在执行前，必须向用户展示并等待明确确认：

准备执行外呼任务，请确认以下信息：
📋 任务信息
任务名称: [任务名称]
外呼场景: [场景描述]
智能体角色: [角色]
外呼目标: [目标]
📞 外呼名单（共 N 人）
[电话号码]
...
是否确认执行外呼？

• ✅ 必须等待用户明确确认后才能执行
• ✅ 用户不确认时，询问需要修改什么
• ❌ 不要在用户未确认的情况下自动执行

---

步骤 4: 创建 taskInput.json

请读取 input-formats.md文件，根据已知信息构建 taskInput.json 文件。

关键原则：充分利用已有信息，不要只提取号码和简单描述。

首先盘点当前已知的所有信息，这些都应该作为 background 的素材：

• 对话上下文中提到的任何细节（时间、地点、条件、产品名称、活动内容……）
• 前置节点传来的数据（简历信息、CRM 字段、订单详情……）
• 被叫方的个人信息（姓名、职位、历史记录……）
• 用户明确说明的要求或限制

然后再问自己：

• 这次外呼的核心目的是什么？被叫方需要做什么决定或回答什么问题？
• 如果对方拒绝或不方便，有备选方案吗？
• 根据场景，智能体应该扮演什么角色？（招聘专员、销售顾问、客服专员……）
• 开场白说什么最自然？对方接起电话的第一句话应该是什么？

所有已知信息都应填入 agentProfile.background，让机器人在通话中有据可依，而不是凭空发挥。

scenarioDescription 填写原则：

• 用简洁的中文描述外呼目的，例如："面试邀约"、"满意度回访"、"AI产品体验邀约"
• 脚本会自动根据描述关键词推断 industry（行业）和 scene（场景类型）标准值，无需手动指定
• 支持推断的关键词示例：

关键词	推断 industry	推断 scene
面试、招聘、简历	HR	interview_invite
保险、理财、金融	finance	product_promotion
教育、培训、课程	education	enrollment
医疗、体检、预约	healthcare	appointment
快递、物流、订单	ecommerce	delivery_notify
客服、回访、满意度	service	survey
销售、产品、推广	retail	product_promotion
通知、提醒	general	notify
其他	telecom	survey

执行：

node scripts/bundle.cjs taskInput.json

---

步骤 5: 执行外呼

用户确认后执行：

# 标准用法（推荐）
node scripts/bundle.cjs taskInput.json

参数说明：

参数	说明	使用场景
taskInput.json	JSON 文件路径	主要输入方式
--instance-id	指定已有外呼实例 ID	复用实例，避免重复创建
--script-id	指定已有话术脚本 ID	复用话术，避免重复生成
--no-interactive	禁用交互式输入	自动化脚本、CI/CD 场景

查询子命令：

子命令	说明	用法
query	查询任务组整体进度	node scripts/bundle.cjs query
query-jobs	查询各 Job 详细结果（分页）	node scripts/bundle.cjs query-jobs [--page N] [--size N] [--status Succeeded]
get-recording	获取单通录音下载链接	node scripts/bundle.cjs get-recording

技能执行时自动完成：验证输入 → 创建实例 → 检查绑定号码 → 生成话术 → 创建任务组 → 启动外呼

---

步骤 6: 报告结果

向用户报告：

• 外呼任务已启动
• 任务组 ID（jobGroupId）
• 拨打的电话数量

遇到错误时，请读取 troubleshooting.md。

---

步骤 7: 安排结果查询

外呼任务启动后，用定时任务的功能来安排一个 30 秒后的一次性任务，在隔离会话中查询进度并通知用户：

• 任务名称：外呼结果查询-
• 触发时间：30 秒后
• 任务内容：执行 node scripts/bundle.cjs query ，根据结果决定下一步：

- running / partial → 再安排一个 60 秒后的查询 - completed → 向用户汇报结果，询问是否需要下载录音进行分析

安排好后立即向用户回复，不要等待外呼完成：

✅ 外呼任务已启动！
📋 任务信息
任务组 ID: 
实例 ID: 
外呼数量: N 人
⏰ 我将在 30 秒后自动查询进度，完成后主动通知你。

---

交付前检查

执行完成后，逐项确认再向用户报告：

• [ ] 任务组 ID 已获取（jobGroupId 不为空）
• [ ] 实际拨打数量与名单数量一致
• [ ] 已告知用户在 阿里云晓蜜控制台 查看外呼结果
• [ ] 如有号码验证失败，已向用户说明哪些号码被跳过及原因

---

常见场景示例

需要参考具体场景时，请读取 scenarios.md。

---

注意事项

• 合规使用 — 确保外呼行为符合相关法律法规，获得用户同意
• 号码隐私 — 妥善保管客户电话号码，避免泄露
• 费用控制 — 外呼服务会产生费用，注意控制调用频率
• 测试优先 — 建议先在测试环境验证，再用于生产

参考链接

• 阿里云晓蜜控制台
• 阿里云晓蜜文档