SuperAPI AI 工具集

telnyx-ai-assistants-javascript

智能体与模型

查看项目

更新于 10-16 08:11

技能介绍

用途:该技能面向 JavaScript 开发者,说明如何用 Telnyx 官方 SDK 管理 AI 语音助手,覆盖助手创建、对话、测试与标签等操作。

主要能力:可创建助手并指定名称与系统指令,可选指定模型(如 openai/gpt-4o)与标签;通过 chat 方法发送消息并维持 conversation_id 会话;可为助手创建测试,定义目标、指令与评分标准(rubric);此外支持获取、更新、列出、删除助手,导入外部提供商的助手(provider 为 elevenlabs、vapi、retell,需 api_key_ref),管理标签、工具、定时事件、Canary 部署,以及发送 SMS 对话、克隆助手、增强指令等操作。测试侧支持列表、触发测试套件运行、查看运行历史等。

使用方式:安装依赖 npm install telnyx@6.74.2,然后初始化客户端:import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] });。创建助手调用 client.ai.assistants.create()(POST /ai/assistants),参数必填 name 与 instructions;对话调用 client.ai.assistants.chat('assistant_id', {...})(POST /ai/assistants/{assistant_id}/chat),必填 content 与 conversation_id,回复读取 response.content。列表方法返回自动分页迭代器,可用 for await 遍历。

限制与注意:所有调用可能因网络、限流(429)、校验(422)或认证(401)失败,生产代码需处理错误,429 可按 retry-after 重试;电话号码必须为 E.164 格式,含 + 前缀和国家码,不能有空格、破折号或括号。文档强调不要臆造参数、枚举、响应字段或 webhook 字段;内联未展示的参数、枚举或响应字段需先读 references/api-details.md。tools 参数对新集成已弃用。部分操作(如 Canary 部署、定时事件、工具增删)的详细可选参数与响应结构暂未提供完整说明。