用于规定智能体说什么以及如何行为的提示词—— 包括转接、按键和挂断等通话操作；这些只是普通提示词行，而非独立配置。
引擎层级（spark、bolt、storm-*）：Spark 针对成本优化， Bolt 针对速度优化，Storm 则针对复杂提示词的智能表现优化。
语音以及主要语言和可选的附加语言——当来电者切换语言时，智能体会自动切换。请参阅支持的语言。
已附加的能力：已连接应用、 API 连接、知识库、 MCP 服务器和内联函数工具。
行为设置：发言顺序、确认模式、背景音轨、保持等待超时。

构建器中的编辑会自动保存为草稿；在您点击部署前，任何更改都不会上线。每次部署都会在构建器的 历史记录选项卡中创建快照，因此您可以检查并恢复任何先前版本。

控制台中的语音智能体： 智能体构建器 (/dashboard/agents)。请参阅构建您的第一个语音智能体。

API： /v1/agents——CRUD、复制、转接、版本历史记录和提示词辅助工具。

语音

语音库包含智能体可使用的语音、可播放的示例、兼容的语言、性别和口音分组，以及任何高级语音或语言附加费用。付费试听功能可在您选择前合成您自己的 1–500 个字符短语。

符合条件的组织还可以根据简短的 WAV 或 MP3 示例创建自定义语音。自定义语音设有配额和异步创建状态；准备就绪后，它们会与语音库中的语音一起显示在同一智能体选择器中。

在控制台中： 语音（/dashboard/voices）。请参阅语音库和自定义语音。

在 API 中： /v1/voices、语音示例和自定义语音。

电话号码

电话号码归属于某个组织，并将呼入电话路由至智能体（也可用于呼出电话）。有两种来源：

演示号码——从 ThunderPhone 的号码池中配置的真实美国号码，几秒内即可启用。仅支持呼入，会通过简短的语音免责声明接听，且控制台将每个组织限制为最多 10 个。非常适合首次测试；不适用于生产环境。
VoIP 号码——通过您自己的提供商和 VoIP 连接接入。Twilio 和 Telnyx 可直接连接（Telnyx 提供引导式设置）；SignalWire 和 Vonage 即将推出——目前您可以通过手动 SIP 配置接入它们，该配置接受任何 SIP 中继线路。导入并验证后，VoIP 号码支持呼入和呼出。

每个号码行都允许您设置路由模式、选择呼入智能体，并为号码添加标签。

在控制台中： 电话号码（/dashboard/phone-numbers）。请参阅获取电话号码。

在 API 中： /v1/phone-numbers、 /v1/voip-connections、 /v1/phone-number-labels。

通话

每次呼入、呼出、模拟和小组件会话都会成为一条通话日志。通话包含完整的角色标记转录文本、结构化轮次历史记录（包括工具调用）、录音、账单总额，以及可选的 AI 评分和问题报告。

当通话处于进行中状态时，您可以打开通话并进行旁听——您会静默加入，通话中的任何人都不会听到您。开始旁听后，您可以进行私语：输入一条会在通话中直接发送给您的智能体的指令；来电者永远不会听到它，智能体会即时遵循该指令。

在控制台中： 使用 通话记录（/dashboard/call-history）查看归档和单次通话详情；使用 进行中 查看正在进行的通话。请参阅查看、旁听和指导您的通话。

在 API 中： /v1/calls——列表、转录文本、历史记录、音频、评分、导出； /v1/issue-reports。

客户门户

客户门户是面向外部客户的品牌化只读通话记录视图。组织管理员可以选择要显示其通话的智能体、添加已批准的查看者电子邮件地址、上传徽标和强调色，并可选择验证自定义域名。门户查看者无需获得控制台访问权限，即可查看通话详情、转录文本和可用录音。

在控制台中： 客户门户（/dashboard/client-portals）。请参阅客户门户。

在 API 中： /v1/client-portals用于管理员管理。

网页组件

网页组件让您的网站访客能够通过麦克风与智能体对话——无需电话号码。它使用与您获准域名绑定来源的可发布密钥（pk_live_...）进行身份验证，因此可安全地用于客户端代码。

密钥可在以下两种模式之一运行：agent（静态绑定到一个智能体）或 webhook（您的服务器为每位访客选择配置——请参阅按通话动态配置）。组件会话与电话通话使用相同的通话基础设施。

在控制台中： 网页组件（/dashboard/web-widgets）—— 创建组件、设置模式和智能体、管理获准域名，以及复制嵌入代码片段。请参阅创建网页组件。

在 API 中： /v1/publishable-key、 /v1/mic-session，以及组件 SDK 文档。

知识库

知识库是一组可供您的智能体在通话过程中搜索、以便为回答提供依据的文档——上传文件、粘贴文本或通过 URL 导入网页，然后在构建器中将知识库关联到智能体。智能体会在对话需要时使用内置搜索工具查询知识库。

在控制台中： 文档库位于知识（/dashboard/knowledge）；在构建器的知识部分可将知识库关联到智能体。请参阅为您的智能体添加知识库。

连接

连接让智能体能够访问外部世界。共有四种类型，位于同一个侧边栏分组中：

应用（/dashboard/app-connections）——连接至 Slack、HubSpot、Salesforce、Google Calendar、Google Sheets 和 Cal.com 的 OAuth 连接。只需连接一次，然后即可将按操作划分的工具（发送 Slack 消息、更新或创建 HubSpot 联系人、预约 Cal.com 时段……）切换添加到任意智能体。请参阅连接应用。
API（/dashboard/api-connections）——将任何 HTTP API 转换为智能体操作。粘贴 cURL 命令后，AI 向导会起草工具定义；您也可以手动构建。测试请求按钮会在您发布前发起沙盒调用。请参阅 API 连接——这是 /v1/integrations 的控制台界面。
MCP（/dashboard/mcp-connections）——通过 URL 添加模型上下文协议服务器，并让智能体使用其公开的工具。请参阅添加 MCP 服务器。
VoIP（/dashboard/voip-connections）——用于自带电话号码的提供商凭据。请参阅连接 VoIP 提供商。

ThunderPhone 还公开了自己的 MCP 端点，因此外部 MCP 客户端可以列出智能体、查看通话和转录记录，以及发起通话。请参阅将 ThunderPhone 用作 MCP 服务器。

在 API 中： /v1/integrations、 /v1/mcp-servers 和 /v1/voip-connections；另请参阅构建工具集成。

营销活动

营销活动可大规模发起外呼：上传联系人 CSV，选择智能体和呼出号码，并设置呼叫时段（日期和时间，支持时区）、并发数和重试策略（最大尝试次数，以及哪些结果——无人接听、语音信箱、失败——需要重试）。营销活动会依次处理列表中的联系人，并在通话记录中记录每通电话。

在控制台中： 营销活动（/dashboard/campaigns）。请参阅运行外呼营销活动。

对于一次性编程调用： 请使用外呼 API。

实时监控

实时显示整个组织中正在进行的每一通电话，并让您打开其中任意一通，以便实时旁听和耳语。这是监督界面：观察新的提示词接入第一批真实流量，或关注正在运行的活动。

在控制台中： 实时（/dashboard/live）。请参阅观看和监督实时通话。

模拟

模拟是由 AI 呼叫者与您的智能体进行真实对话——使用相同的电话路径、真实的转录文本和真实的评分——因此您可以在发布前（以及发布后）进行测试。将其指定给某个智能体或电话号码，自行编写呼叫者场景，或根据智能体的提示词使用 AI 生成场景（如有要求，也会包含边界情况），然后实时观看通话。

场景归入套件，套件可固定最低通过率，并可在 CI 中作为发布门禁；系统会按场景报告相对于已接受基线的回归。

在控制台中： 模拟（/dashboard/simulations），以及智能体构建器中的模拟按钮。请参阅模拟一次通话。

在 API 中： /v1/test-calls 和套件运行器——请参阅端到端测试智能体。

验证集

验证集可将真实通话中的时刻转化为可重复执行的单轮回归检查。每个示例都会固定对话上下文、相关的呼叫者音频、原始回复以及预期行为。回放会针对当前智能体草稿运行，而无需再次拨打电话；部署对话框可以显示最新运行结果是否仍与该草稿一致。

在控制台中： 用于组织数据集的 验证集（/dashboard/validation），以及用于运行的智能体构建器验证选项卡。请参阅验证集。

在 API 中： /v1/validation-sets 以及同一参考页面中的智能体/示例回放端点。

实验

实验会在实时流量上对智能体配置进行 A/B 测试：定义变体（不同的提示词、引擎或设置），在它们之间分配流量，并按变体比较结果。使用它代替在 webhook 中手动编写分桶逻辑。

在控制台中： 实验（/dashboard/experiments）以及智能体构建器中的 A/B选项卡。请参阅实验（A/B 测试）。

问题

问题是针对特定通话标记的问题——可由人工审核员提交，或由 AI 评分检测。问题包含严重程度、来源和状态，而“问题”页面是分诊队列：筛选、检查出现问题的通话，并跟踪修复进度。

在控制台中： 问题（/dashboard/issues），以及通话记录中的按通话标记功能。请参阅问题分诊。

在 API 中： /v1/issue-reports。

报告

报告会回答关于您的通话数据的自然语言问题（“呼叫者上周要求转人工的前三大原因是什么？”），并提供由 AI 撰写的分析，范围限定为您选择的智能体和日期范围。

在控制台中： 报告（/dashboard/reports）。请参阅报告。

可观测性

可观测性是指标界面：通话量、结果和随时间变化的质量，可按智能体和时间窗口筛选，并可导出以供下游分析。

在控制台中： 可观测性（/dashboard/observability）。请参阅可观测性。

警报

警报规则会在一个时间窗口内监控某项指标（成功率、失败率、平均分数、通话量、套件回归），并在其超过您的阈值时触发。通知会发送至电子邮件和 Slack，并向您的 webhook 端点触发 alert.triggered 事件。

在控制台中： 组织 → 警报。请参阅警报。

Webhooks

当通话期间或结束后发生事件时，ThunderPhone 会向您的服务器发送 HTTP POST Webhook。提供两种投递模式：

Webhook 端点（推荐）：在 /v1/developer/webhook-endpoints 管理多个 URL，并为每个端点设置独立密钥和事件订阅。
旧版单 URL Webhook：每个组织一个 URL。可通过 /v1/webhook 或在 组织 → 常规设置 下管理。保留此功能以实现向后兼容。

事件分为两类：

阻塞事件要求您的服务器返回用于调整进行中通话的配置——即来电事件（telephony.incoming / web.incoming）。您最多有 10 秒时间响应；超时后，将由静态分配的智能体处理通话。
非阻塞事件为即发即弃的通知，并采用指数退避机制重试——请参阅投递语义。

每个请求都会在 X-ThunderPhone-Signature 中携带 HMAC-SHA256 签名。请参阅签名验证。

函数工具

函数工具是您的智能体可在对话过程中调用的 HTTP 端点。您向 ThunderPhone 提供 OpenAI 风格的函数架构和端点 URL；智能体决定何时调用，ThunderPhone 会从其服务器发起已签名的 HTTP 请求，并将结果返回给智能体。

智能体还提供内置通话能力——转接通话、发送按键（DTMF）输入、结束通话、保持等待——您只需通过简单的提示词行启用这些能力，无需定义工具。

控制台位置：构建器的 API 连接部分（请参阅连接）。

API 位置：/v1/integrations 和函数工具规范。

团队和角色

每个组织都有成员列表，包含两种角色：成员负责构建和运营智能体；管理员还可以管理团队和计费。可通过电子邮件邀请成员——邀请会在 7 天后过期，也可撤销；成员行中的 ⋯ 菜单可用于更改角色或移除成员。可为整个组织配置单点登录——请参阅 SSO。

控制台位置：组织 → 常规设置。请参阅邀请您的团队。

API 位置：/v1/members， /v1/invites。

计费

ThunderPhone 采用预付费模式。每个组织都有美元余额；通话会按智能体的每分钟费率从余额中扣费（引擎层级加附加费——当您更改设置时，构建器会实时显示全包费率，并且部分附加语言每分钟额外收费 3¢）。当余额降至零时，入站通话会被拒绝，出站通话会返回 402 Payment Required。

您可以手动充值，也可以启用自动充值，并设置余额阈值、充值金额以及可选的每月支出上限——确保通话不会在句子中途终止。

控制台位置：组织 → 计费设置和 计费历史记录。请参阅充值并开启自动充值，以及完整定价参考。

API 位置：/v1/billing。