为 3CX AI Agent 配置 OpenAI

介绍

本指南说明如何将 OpenAI 与3CX AI Agent 集成，用于智能前台和呼叫处理场景。

此功能需要3CX AI 版本。

设置 OpenAI 账户

如果您还没有OpenAI账户，请在OpenAI登录页面登录或创建一个。

创建项目并设置计费

  • 登录OpenAI登录页面。
  • 创建一个新项目并为其指定一个描述性名称。
  • 前往“设置 → 计费(Settings → Billing)”并完成计费设置。
  • 确保您有足够的信用额度以满足预期使用量。

注意：您必须拥有付费的OpenAI账户才能正常使用；试用账户有限制，可能会出现不可预测的问题/错误。充值至少100美元的OpenAI账户通常会直接提升至Tier 3级别。

配置模型访问与限制

  • 前往“项目 → 限制(Project → Limits)”。
  • 设置预算以控制您的支出。
  • 在允许或阻止模型( Allow or block models)下，保持列表为空以允许所有模型。
  • 在速率限制(Rate limits)下，根据需要提高上述模型的限制（较大的安装可能需要更高的限制以避免不可预测的行为）。

关于速率限制的说明：您提高限制的能力取决于您的OpenAI API使用层级/账户历史。

创建新API密钥

  • 前往“仪表盘 → API密钥(Dashboard → API Keys)”。
  • 点击创建新密钥(Create a New Secret Key)。
  • 输入描述性名称并将权限设置为全部(Al)。
  • 复制密钥并妥善保存。Go to "Dashboard → API Keys".

在3CX中配置OpenAI

在3CX管理控制台中，前往“管理 > 集成 > AI”。点击“实时API”，然后选择“OpenAI”。

  • 配置以下设置：
  • API密钥(API Key:)：粘贴在OpenAI仪表盘中创建的API密钥。
  • AI实时模型(AI Realtime Model)：选择您3CX版本推荐的OpenAI实时模型。
  • AI文本模型(AI Text Model)：选择您3CX版本推荐的OpenAI文本模型。
  • 填写：
  • 公司名称(Company Name)
  • 公司描述(Company Description); 供AI智能体了解您组织的背景信息。
  • 点击保存按钮。

设置AI Agent 与知识库

有关 AI Agent 的详细设置，请参阅主文档3CX AI Agent 配置指南。

技术说明

  • 音频编解码器： PCMU
  • 如果您的OpenAI账户限制了模型访问，请在实时API设置中允许 gpt-realtime-whisper 以及为实时和文本选择的模型。
  • 确保3CX防火墙检测器通过。
  • 允许以下出站流量：
  • TCP 443 – 用于OpenAI实时API信令和会话建立。
  • UDP 3478 – 用于WebRTC媒体连接。
  • 3CX分三个阶段建立OpenAI实时连接：

AI模型

OpenAI会定期更新模型，并可能弃用旧版本。3CX会随着支持版本的变化更新其推荐的模型。请确保OpenAI项目可以访问您安装的3CX版本所需的模型。

另请参阅

最后更新
本文档最后更新于2026年8月20日
https://www.3cx.cn/docs/ai-agent-configuration-openai/