ai-phone-agent
bobbylkchao/ai-phone-agent加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
凌晨两点,你的客服热线依然响个不停。 人工客服团队早已下班,但电话那头的用户还在焦急等待——订单查询、产品咨询、投诉建议,每一通未接来电都可能是正在流失的客户。传统方案是雇佣更多客服,但这意味着24小时轮班的高昂人力成本。对于中小型企业来说,这几乎是一道无解的难题。
bobbylkchao/ai-phone-agent 正是为解决这个问题而来。这是一个基于 Node.js + TypeScript 构建的生产级 AI 电话代理启动套件,能够让 AI 实时接听真实来电、与用户自然对话,并执行转接人工、收集信息、结束通话等操作。它底层调用 OpenAI Realtime API,支持 Twilio 和 Amazon Connect 两大主流电话平台,真正实现了"AI 接电话"的场景落地。

你甚至不需要克隆代码,只需要拨打 +1 (855) 522-2348 就能体验这个 AI 电话代理的实际效果。接听之后,AI 会以旅行预订场景为例,与你进行实时语音对话:它能听懂你的问题、自然地回答、主动追问细节(比如目的地、出行日期),最后把收集到的信息整理成结构化数据。整个过程延迟低、语气自然,完全不像传统 IVR(交互式语音应答)那样机械刻板。
这个 Demo 背后的技术实现并不复杂:用户拨打 Amazon Connect 分配的号码 → 呼叫被 SIP 转发到后端 → 后端与 OpenAI Realtime API 建立双向流式连接 → AI 实时理解语音、生成回复、返回音频。整个链路打通了电话网络与 AI 大模型之间的最后一公里。

这个项目的核心价值在于同时支持 两条电话接入路径,适合不同技术背景和业务需求的用户。
Twilio 路径 适合已经在使用 Twilio 进行语音开发的团队。项目通过 TwiML(Twilio 标记语言)接收来电,配合 Media Streams WebSocket 实现音频的双向流传输。开发者只需配置好 Webhook URL,就能在 Twilio 控制台绑定业务号码,让 AI 自动接听。
Amazon Connect 路径 则更适合需要与现有呼叫中心集成的企业。项目提供 OpenAI SIP Webhook,当 Amazon Connect 通过 SIP 接收来电后,会自动触发 webhook,后端接受连接并与 OpenAI Realtime 建立流式会话。这条路径的优势在于可以直接复用企业已有的 Amazon Connect IVR 流程,AI 作为其中一环无缝嵌入。

如果 AI 只能说话,那它顶多是个高级语音助手。这个项目真正有意思的地方在于工具调用(Function Calling)能力的集成。电话场景中,AI 可以执行以下真实操作:
项目内置了一个旅行预订场景的示例工具链,展示了如何通过多轮对话收集目的地、出行日期、人数等信息,并调用 MCP 服务器完成模拟预订。这套模式可以直接迁移到你的业务场景——只需要替换 MCP 服务器地址和 prompt 逻辑。
虽然功能聚焦于电话接入,但项目在工程实践上一点也不含糊:
开发体验也不错:npm run dev 启动 nodemon 热重载,npm run lint 自动修复风格问题,npm run build 编译后通过 tsc-alias 处理路径别名,最终产出干净的 dist/ 目录。
这个项目没有 Web UI,面向的是有 Node.js 后端开发能力的团队。部署流程简化为:
npm install
cp .env.example .env # 填入 OPENAI_API_KEY、TWILIO 或 AMAZON_CONNECT 配置
npm run dev
需要注意的是,电话集成依赖公网可达的 Webhook URL,本地开发需要用 ngrok 或类似工具暴露内网端口。项目文档中有详细的本地测试指南,涵盖了 Twilio 和 Amazon Connect SIP 的测试方法。
如果你是 AI 爱好者而非开发者,拨打 Demo 号码体验是最直接的方式。但想要落地到自己的业务中,至少需要一名熟悉 Node.js 后端开发的工程师来配置和定制。
这个项目并非万能解药,有几个现实问题需要正视:
1. OpenAI Realtime API 的成本与合规。实时语音 API 按 token 计费,通话时长直接挂钩成本。生产环境中需要精确监控用量,否则账单可能超出预期。同时,如果你的业务涉及医疗、金融等强监管领域,AI 电话对话的合规性需要单独评估。
2. 中文支持待验证。项目默认基于 OpenAI Realtime API 的英文能力构建,虽然理论上支持任何 OpenAI 模型,但中文语音的自然度、方言识别、长句处理等都需要实际测试。项目本身没有专门的中文优化。
3. Twilio/Connect 配置有门槛。这两个平台本身就有一定的学习曲线,配合本项目使用时,需要同时理解语音流、WebSocket、SIP 等多个技术概念。初次接触可能需要几天时间才能跑通完整链路。
4. 工具调用示例是参考代码。项目提供的预订 MCP 和旅行信息收集工具是"示例性质"的,不能直接用于生产。真正的业务逻辑需要开发者自行实现。
电话是最高效的客户触达渠道之一,但传统客服的人力成本限制了服务时段和服务质量。AI 电话代理的出现,让企业第一次有了"AI 24小时接电话、而且成本极低"的可能性。
这个项目代表了当前 AI Phone(AI 电话)赛道的一个典型技术方向:OpenAI Realtime API 作为大脑,Twilio/Connect 作为耳朵和嘴巴。它不是通用语音助手,而是专门为电话场景优化的中间件层。2025年以来,随着 GPT-4o 语音能力的成熟和 Realtime API 的开放,类似的电话代理项目开始涌现。这个启动套件的价值在于:它帮你省掉了整合 Twilio/Connect 与 OpenAI 的工程工作,让你直接站在一个可用的baseline上开发自己的业务逻辑。
如果你正在考虑将 AI 能力嵌入到电话客服场景中,这个项目值得 clone 下来跑一跑 Demo。如果 Demo 的效果符合预期,再投入时间做定制开发也不迟。