构建可将 AI 智能体接入实时通话的 3CX 可编程分机

转译自：Leonidas Georgiou，3CX产品经理

3CX 可编程分机允许开发者创建 AI 智能体，从而通过 3CX 电话系统处理实时通话。

 3CX Agentic Call Control GitHub 代码仓库提供了连接可编程分机与 OpenAI、xAI、Google Gemini 和阿里云通义千问 (Alibaba Cloud Qwen) 的现成代码示例。每个示例都将 AI 服务商连接到 3CX 通话控制，为开发者构建自己的实时语音应用提供了基础。

选择最适合您应用场景的服务商，配置智能体并直接通过 3CX 进行测试。

为 3CX 可编程分机选择 AI 服务商

选择最契合您业务需求的 AI 服务，无需重新构建 3CX 端的通话逻辑。每个服务商都附带现成的示例，便于您直接使用正确的 API、模型、语音和区域设置开始配置。

  • OpenAI：使用熟悉的 OpenAI Realtime，快速轻松上手。
  • xAI：接入 xAI 的实时语音服务。
  • Google Gemini：基于 Google 的 Gemini 实时服务进行开发。
  • 阿里云通义千问 (Alibaba Cloud Qwen)：使用支持多区域端点（包括国际节点或北京节点）的通义千问，方便在中国大陆进行部署。

有关不同服务商的具体配置，请参阅 3CX 可编程分机的 AI 服务商，其中涵盖了 3CX 连接设置、服务商配置以及测试呼叫说明。 

同时使用多家 AI 服务商

您可以根据需求接入来自不同服务商的任意数量的智能体，并分别进行自定义配置。

换言之，您可以配置来自不同服务商的多个智能体：例如，使用基于 Grok 或 OpenAI 的英文智能体服务欧美客户，同时使用基于阿里云通义千问的智能体专门服务中文来电者。 

安全接入 3CX

智能体在处理呼叫前，需要在 PBX 中获取授权登录账号。在 3CX 中，该账号被称为“服务主体”（Service Principal），负责为智能体生成客户端 ID (Client ID) 和 PBX API 密钥。

管理员可指定智能体有权使用的分机。PBX API 密钥用于将智能体连接至 3CX，而独立的服务商 API 密钥则用于将其连接至 OpenAI、xAI、Gemini 或通义千问。

启动示例代码时，终端会显示是否已成功连接至 3CX 及指定的 AI 服务商。在向智能体发起呼叫前，请确保终端状态已显示为“ready”（就绪）。

打造成熟的来电体验

每个示例均内置一个接待员配置文件，用于定义来电者听到的语音内容。您可以修改智能体名称、公司名称、问候语和发音人语音，使其契合您的业务需求。

此外，该配置文件还能设定智能体的对话逻辑和呼叫处理方式。例如：

  • 智能体角色：设置系统提示词（Instructions）、对话语言和回复风格。 
  • 呼叫操作：设定智能体是否具备转接呼叫或挂断电话的权限。 
  • PBX 工具：指定智能体可以调用的 PBX 功能或数据，例如查询通讯录。
  • 呼叫前置筛选：在转接前启用身份确认与坐席空闲状态检查。
  • 异常与骚扰电话应对：为垃圾来电、情绪激进或不配合的来电者单独制定处理策略。

您可以为不同的团队、呼叫类型或语言创建独立的配置文件，且全过程无需修改底层 3CX 的连接配置。

通过真实通话测试 3CX 可编程分机

当可编程分机设置完毕且启动日志显示配置成功后，即可通过 3CX Web 客户端呼叫您的服务主体 Client ID。可编程分机会根据提示词（Prompt）中的指令做出相应响应。

该测试能够完整验证全链路通信：来电者 > PBX > AI 服务商 > PBX > 来电者。

建议先使用默认示例确认通话正常，随后每次仅微调一项设置。这样可以在保持 3CX 端测试变量可控的前提下，更轻松地对比不同服务商、发音人、参数及配置文件的效果。

参与互动

关注我们的互动频道，我们通过视频、图片、文档，包括召开技术及市场交流会议的形式，方便你了解及掌握 3CX 最新的资讯与技术信息，同时非常欢迎您在我们的媒体平台进行留言。