Call Bridge

通话桥接专业版是一款面向团队与企业的AI电话代理平台，在免费版单次外呼基础上，新增并行外呼、实时转接、呼入号码配置、通话活动管理、个性化语音配置与完整错误处理等高级能力。核心能力： - 并行外呼：同时拨打3-4通电话进行信息比价与选项探索 - 实时转接（live handoff）：将用户桥接到正在进行的通话中 -...

核心功能: 本技能提供等高级能力等能力。

通话桥接专业版

专业版增值服务

能力	免费版	付费版
基础功能	支持	支持
通话桥接专业版通话活动管理	不支持	支持
通话桥接专业版与个性化语音配置	不支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持

能力矩阵

并行外呼与通话活动

• 同时发起3-4通外呼，适合信息比价与选项探索
• 通话活动状态管理：跨通话保持目标、目的、已知事实、结果与下一步行动
• 跟进通话复用上一次通话的转写文本，代理可自然衔接
• 通话结果汇总与对比报表

实时转接（live handoff）

• 将用户桥接到正在进行的通话中，跳过等待时间
• 用户通过bridge_number加入通话，代理负责引导转接
• 转接前的对话记录在转写文本中，转接后的对话为私密
• 适合身份验证、敏感谈判、实时决策等场景

呼入号码配置

• 配置来电应答规则：代理如何接听、收集什么信息、何时转接
• 站立式简报：为未来未知来电者预设应答指令
• 转接号码配置：将来电转接到用户的外部号码
• 需要预留号码与对应服务套餐

个性化语音配置

• 语音音色：jessica(默认,女)、sarah(女)、chris(男)、eric(男)
• 个性化风格：定义代理的身份、语气、持久度、谨慎度与决策边界
• 开场白：配置外呼时的标准开场语
• 呼入问候语：为来电者定制应答问候

错误处理

• 认证错误：Key无效或缺失时的恢复策略
• 配额错误：试用耗尽、套餐不足、余额不足时的引导
• 网络错误：拨号失败、号码池耗尽时的策略
• 配置错误：语音选项无效、呼入配置缺失时的修复指引
• 保留所有返回的action.url与action.sign_in_url

外呼前侦察

• 调用查找工具预填商家电话、地址、营业时间等公开信息
• 预判身份核验、OTP、付款、费用、审批等关键节点
• 评估通话风险等级：信息收集型、边界承诺型、实时转接型
• 适度探询：只询问防止无效或风险通话的必要信息

新手引导

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

应用场景

场景一：多商家信息比价

用户希望对比4家餐厅的价格与可用时段。专业版并行拨打4通外呼，每通通话指令明确"仅收集信息不承诺预订"。4通通话结束后汇总对比，用户选择最优方案后再发起确认预订的通话.

场景二：敏感通话实时转接

用户需要与银行协商账户问题，涉及身份验证与敏感决策。代理先拨打银行，处理电话菜单与等待，到达人工客服后触发转接，将用户桥接到通话中。用户直接与客服对话，代理退出.

场景三：呼入应答自动化

用户拥有一个预留号码，希望所有来电由AI代理先接听。代理收集来电者姓名、事由，判断是否需要转接给用户。常规咨询由代理直接应答，紧急事务转接到用户手机.

场景四：通话活动跟进

代理首次拨打商家时对方要求提供订单号，用户当时未提供。代理记录阻断点与缺失信息，用户补充后代理发起跟进通话，通话指令中包含上一次的转写文本，代理自然衔接"上次提到需要提供订单号，现在订单号是...".

场景五：个性化代理配置

用户希望代理以"李总的助理"身份外呼，语气专业但不过于正式，遇到付款请求时必须先询问用户。通过个性化配置定义身份、语气与决策边界，所有外呼自动应用.

操作流程

预计上手时间：约180秒.

优秀步：检查API Key与配置

bash

# 检查已有配置
cat ~/.config/call-bridge/key.json

第二步：配置个性化语音

bash

curl -X PUT https://api.call-bridge.dev/me/call-preferences \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: cb_sk_..." \
  -d '{
    "voice": "jessica",
    "personality": "你是李总的助理，语气专业但友善。遇到付款、承诺或敏感决策时，必须先询问用户。不要代替用户做出财务承诺。",
    "greeting": "您好，我是李总的助理。"
  }'

第三步：发起并行外呼

bash

# 同时拨打3家餐厅比价
for restaurant in "rest1_phone" "rest2_phone" "rest3_phone"; do
  curl -X POST https://api.call-bridge.dev/call \
    -H "Content-Type: application/json" \
    -d "{
      \"to\": \"$restaurant\",
      \"task\": \"你好，我想了解本周六晚上7点两位用餐的可用时段与套餐价格。仅收集信息，不要预订。请询问：1)是否有包间 2)最低消费 3)是否需要预付定金。请报告完整信息。\"
    }" &
done
wait

第四步：发起实时转接通话

bash

call-bridge.dev/call \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1555bankphone",
    "bridge_number": "+1555userphone",
    "task": "你好，我需要协助处理账户问题。请帮我转接到人工客服。处理电话菜单时选择'账户问题'。等待时请不要挂断。一旦接通人工客服，请告知对方您正在连接客户，然后将客户桥接到通话中。"
  }'

第五步：配置呼入应答（需预留号码）

bash

# 查看当前呼入配置
curl -H "X-Api-Key: cb_sk_..." \
  https://api.call-bridge.dev/me/call-preferences
# ...
# 更新呼入配置
call-bridge.dev/me/call-preferences \
  -H "Content-Type: application/json" \
  -d '{
    "voice": "jessica",
    "personality": "专业友善的助理",
    "greeting": "您好，请问我能帮您什么？",
    "inbound": {
      "instructions": "接听来电时，先询问对方姓名与来意。常规咨询直接应答。紧急事务请告知对方将转接，然后桥接到用户号码。",
      "greeting": "您好，这里是李总办公室。",
      "handoff_number": "+1555userphone"
    }
  }'

第六步：轮询呼入历史

bash

# 查看最近的呼入通话
  "https://api.call-bridge.dev/me/calls?direction=inbound&limit=25"

输入定义

参数名	类型	必填	说明
content	string	否	call-bridge处理的内容输入
strict_level	string	否	审查严格度, 可选: strict/normal/loose, 默认: normal

输出规范

json

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

错误恢复方案

错误场景	原因	处理方式
待审查内容为空	用户未提供内容	提示用户提供待审查的代码
内容格式不识别	传入不支持的内容格式	列出支持的格式, 建议转换后重试
检查项超出范围	传入了不存在的检查维度	列出可用检查维度, 使用默认全部检查
审查超时	内容过长导致处理超时	建议分段审查, 每段不超过5000字
其他异常	内部处理异常	检查输入后重试

安装与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• 网络: 需可访问https://api.call-bridge.dev
• 电话号码: 需有效的美国+1格式电话号码
• 可选: 预留号码（呼入功能需要）、呼入服务套餐

依赖说明(补充)

依赖项	类型	是否必需	获取方式
Call Bridge API	API	必需	首次外呼自动获取Key
curl/HTTP客户端	工具	必需	操作系统内置
预留号码	通信资源	可选	Call Bridge平台购买
LLM API	API	必需	由Agent内置LLM提供

呼入功能需要预留号码与对应服务套餐，外呼功能无需额外资源.

API Key 配置

• Call Bridge API Key: 持久化在~/.json
• 首次获取: 首次未认证外呼的响应中自动返回Key
• 手动替换: 用户可提供自己的Key替换自动获取的Key
• 账户关联: 使用https://call-bridge.dev/sign-in?token=<api_key>关联账户
• 禁止: 在代码、日志或版本控制中暴露API Key
• 建议: 配置文件设置600权限，仅所有者可读写

可用性分类

• 分类: MD+EXEC（）
• 说明: 基于Markdown的AI Skill，

案例展示

通话偏好完整配置

字段	说明	适用范围
voice	语音音色	外呼+呼入
personality	代理风格与行为边界	外呼+呼入
greeting	外呼开场白	外呼
inbound.instructions	呼入应答指令	呼入
inbound.greeting	呼入问候语	呼入
inbound.handoff_number	呼入转接号码	呼入

并行外呼决策矩阵

场景	是否可并行	条件
信息比价（餐厅、供应商）	可以	仅收集信息，不承诺
预约可用时段查询	可以	不预订，仅询问
库存检查	可以	不下单，仅查询
预订/购买/取消	不可以	需用户明确批准
付款/审批	不可以	需实时转接

错误处理矩阵

错误码	含义	处理方式
invalid_phone	电话号码无效	要求用户提供有效+1格式号码
missing_fields	缺少必填字段	补充to与task字段
auth_required	需要认证	获取有效Key或使用返回的认证URL
invalid_api_key	Key无效	替换为有效Key
quota_exceeded	配额用尽	引导用户查看套餐与余额
trial_exhausted	试用耗尽	引导升级套餐
plan_required	需要套餐	引导用户购买对应套餐
balance_depleted	余额不足	引导用户充值
number_pool_exhausted	号码池耗尽	静默重试一次
dial_failed	拨号失败	静默重试一次
network_error	网络错误	静默重试一次
reserved_number_required	需要预留号码	引导用户开通预留号码服务
inbound_plan_required	需要呼入套餐	引导用户升级到支持呼入的套餐
invalid_preferences	偏好配置无效	修正voice为合法值
invalid_profile	呼入配置无效	补充呼入instructions或greeting
invalid_handoff_number	转接号码无效	提供非本平台的外部可达号码

通话活动状态结构

json

{
  "campaign_id": "restaurant-comparison-2024-03",
  "calls": [
    {
      "target": "+1555rest1",
      "purpose": "查询周六晚餐价格与可用时段",
      "known_facts": "两位用餐，周六晚7点",
      "constraints": "仅收集信息不预订",
      "result": "有包间，最低消费500，无需定金",
      "blocker": null,
      "next_action": "等待用户决策"
    }
  ]
}

问答合集

Q1：并行外呼被风控拦截？

并行数量建议不超过4通，且仅用于信息收集。每通通话指令必须明确"不承诺"。若被风控，降低并行数或改为串行.

Q2：实时转接后代理是否继续监听？

不会。转接后代理退出通话，后续对话为用户与对方的私密沟通。转接前的对话记录在转写文本中.

Q3：呼入配置需要什么前提？

需要三项：账户关联的API Key、活跃的预留号码、对应的呼入服务套餐。缺少任一项配置会返回reserved_number_required或inbound_plan_required.

Q4：如何清除呼入配置但保留外呼配置？

先GET /me/call-preferences获取当前外呼配置，然后在PUT请求中保留voice/personality/greeting，将inbound设为null.

Q5：通话活动如何跨会话保持？

将活动状态序列化为JSON存储在本地文件中。每次发起跟进通话时读取状态，将上一次转写文本包含在新的通话指令中.

已知限制

不能是本平台的预留号码，不能是本平台拥有的号码。必须是外部可达的真实号码。已保存的用户电话号码可作为默认handoff_number.

Q7：如何定期轮询呼入历史？

使用GET /me/calls?direction=inbound&since={ISO时间戳}&limit=25。建议每30分钟轮询一次，时间窗口重叠以避免遗漏，按通话id去重。since按通话结束时间过滤.

Q8：试用额度如何计算？

新用户获得10次通话与10分钟通话时长的试用额度，以先到者为准。通话达到5秒talk time才算一次有效试用。试用额度用完后需升级套餐.

Q9：outcome与任务成功的关系？

outcome是电话网络层面的结果（如answered表示接通），不代表任务成功。已接通的通话仍可能未达成用户目标。必须阅读transcript判断.

Q10：如何将代理关联到用户账户？

加载已保存的API Key，生成登录链接：https://call-bridge.dev/sign-in?token=<api_key>。不要为账户关联创建新Key，需先完成至少一次外呼后才有Key可关联.

已知限制(补充)

• 需要LLM支持

具体详情请参考下方内容.

创新亮点

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
信息比价	60分钟/商家	15分钟/商家	45分钟/商家	20%
实时转接	15分钟/次	2分钟/次	13分钟/次	50%
呼入号码配置	30分钟/规则	5分钟/规则	25分钟/规则	30%
通话活动管理	60分钟/活动	15分钟/活动	45分钟/活动	25%
个性化语音配置	60分钟/配置	15分钟/配置	45分钟/配置	25%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
并行外呼能力	支持同时发起3-4通外呼	需手动操作每通电话	需编写脚本管理多线程	部分专业软件支持
实时转接	支持实时将用户桥接到通话中	需手动操作	需编写脚本进行桥接	部分专业软件支持
个性化语音配置	提供多种语音音色和风格	无此功能	可通过TTS库实现	部分专业软件支持
通话活动管理	支持跨通话保持状态	需手动记录	可通过数据库管理	部分专业软件支持
错误处理	提供完整错误处理机制	需手动处理	可通过异常处理机制	部分专业软件支持

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
多商家信息比价效率低	手动拨打多家商家电话进行信息比价，耗时且容易出错	影响决策效率和准确性	提供并行外呼功能，自动化比价	时间节约20%，准确率提升20%
敏感通话处理复杂	需手动处理敏感通话，如银行账户问题，耗时且存在风险	影响用户体验和安全性	提供实时转接功能，简化流程	时间节约50%，安全性提升
呼入号码配置繁琐	需手动配置来电应答规则，耗时且容易出错	影响客户服务效率	提供呼入号码配置功能，自动化配置	时间节约30%，准确性提升

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
无法发起外呼	API Key无效	检查API Key是否正确	重新获取API Key或更新API Key
无法完成实时转接	网络连接不稳定	检查网络连接	确保网络连接稳定或尝试更换网络环境
无法配置呼入号码	配置信息不完整	检查配置信息	完善配置信息并重新配置
语音配置错误	语音音色选择错误	检查语音音色选择	选择正确的语音音色并重新配置
错误处理失败	错误处理逻辑错误	检查错误处理逻辑	修复错误处理逻辑并重新配置

安全指导原则

1. [与「通话桥接专业版」相关的安全注意事项]
   • 保障API Key的安全，防止泄露给未授权用户。
   • 定期更新API Key，以减少安全风险。
   • 限制API调用频率，防止滥用。
   • 对敏感数据进行加密处理，防止数据泄露。
   • 定期进行安全审计，确保系统安全。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

功能介绍

• 自动化执行: 企业级AI电话代理平台，支持并行外呼、实时转接、呼入号码、通话活动管理与个性化语音配置。通话桥接专业版是一款面向团队与企
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

支持中心

Q1: 通话桥接专业版支持哪些输入格式？

A1: 企业级AI电话代理平台，支持并行外呼、实时转接、呼入号码、通话活动管理与个性化语音配置。通话桥接专业版是一款面向团队与企业的AI电话代理平台，在免费版单次外呼基。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

通话桥接专业版通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

部署指引

1. 配置API密钥: 在环境变量中设置对应的API Key
2. 初始化连接: 使用提供的凭证建立API连接
3. 调用接口: 传入必要参数执行API调用
4. 准备文件: 确认文件路径正确且格式受支持
5. 执行处理: 调用对应的处理函数
6. 查看结果: 检查输出文件或返回数据
7. 检查环境: 确认运行时和依赖已安装
8. 执行命令: 使用正确的参数格式执行
9. 查看输出: 检查命令输出和退出码

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪

用户常见咨询

异常恢复指南

针对通话桥接专业版使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置