用途:该技能面向使用 Telnyx AI Assistants 的 JavaScript 开发者,提供通过官方 SDK 管理 AI 语音助手的完整方法,包括创建助手、发起对话、编写并运行测试,以及金丝雀部署等运维操作。
安装与初始化:使用 npm install telnyx@6.74.2 安装,然后 import Telnyx from 'telnyx',用 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 初始化客户端。
主要能力:核心任务包括创建助手(client.ai.assistants.create(),必填 name 与 instructions,可选 model、tags 等)、与助手聊天(client.ai.assistants.chat(),需 content、conversation_id、assistant_id)、创建助手测试(client.ai.assistants.tests.create(),需 name、destination、instructions、rubric)。辅助操作涵盖获取、更新、列出、删除助手,从 elevenlabs、vapi、retell 等外部提供商导入助手,管理标签、工具、定时事件、短信聊天、克隆助手、增强指令,以及测试套件的触发与运行历史查询。
使用方式:所有调用均为异步,需处理网络错误、429 限流、422 校验错误和 401 认证错误;列表方法返回自动分页迭代器,可用 for await 遍历。电话号码须为 E.164 格式(如 +13125550001)。
限制:资料未提供具体收费、价格与效果数据;不要臆造参数、枚举、响应字段或 webhook 字段,未内联展示的字段需查阅 references/api-details.md。部分操作(如 tools)已标记为不推荐用于新集成。