为 3CX AI Agent 配置 xAI Grok

介绍

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

此功能需要3CX AI 版本。

设置xAI账户

如果您还没有xAI账户，请通过xAI控制台创建一个，并配置计费和适当的使用限制。

创建API密钥

• 在xAI控制台中，打开API密钥。
• 点击创建API密钥(Create API Key)。
• 复制生成的密钥并妥善保存。

创建管理密钥

• 打开设置 > 管理密钥(Settings > Management Keys)。
• 创建一个管理密钥，使用描述性名称，例如“3CX-KB”。
• 为集合和文件(Collections and Files)授予读取和写入(Read & Write)访问权限，然后保存。
• 复制生成的管理密钥并妥善保存。

在3CX中配置xAI Grok

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

• 配置以下设置：

• API密钥(API Key)：粘贴在xAI控制台中创建的API密钥。
• 管理API密钥(Management API Key)：粘贴用于知识库的管理密钥。
• AI实时模型(AI Realtime Model)：选择您3CX版本推荐的Grok实时模型。
• AI文本模型(AI Text Model)：选择您3CX版本推荐的Grok文本模型。
• 填写：

• 公司名称(Company Name)
• 公司描述(Company Description); 供AI智能体了解您组织的背景信息。

• 点击保存按钮。

设置AI Agent 与知识库

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

技术说明

• Audio codec: PCMU (G.711 μ-law ). xAI supports G.711 directly over WebSockets, allowing 3CX to pass telephony audio without additional encode/decode conversation.
• 音频编解码器：PCMU（G.711 μ-law）。xAI支持通过WebSockets直接传输G.711，使3CX能够传递电话音频而无需额外的编解码转换。
• 如果您的账户限制了模型访问，请在实时API设置中允许为实时和文本选择的模型。
• 确保3CX防火墙检测器通过。
• 允许以下出站流量：

• TCP 443 – 与xAI实时API的安全WebSocket连接。

• 3CX连接到xAI实时API使用：

• wss://api.x.ai/v1/realtime

AI 模型

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

另请参阅

• 3CX AI Agent 配置指南
• 为 3CX AI Agent 配置 OpenAI
• 在 3CX中配置 AI 客户服务 Agent

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