用途:此技能用于在 Ruby 项目中通过 telnyx gem 接入 Telnyx AI Assistants,创建并管理可配置指令、模型与工具集成的 AI 助手,支持对话交互与效果测试。
主要能力:创建助手(client.ai.assistants.create,可设 name、instructions、tags、model 等);与助手对话(client.ai.assistants.chat,需 content 与 conversation_id);检索、更新、删除、列出助手;从外部提供商导入助手(provider 支持 elevenlabs、vapi、retell);创建和管理助手测试(tests.create / retrieve / update / delete / list),按测试套件触发运行并查看运行历史;标签管理;短信通道对话(send_sms);克隆助手;增强指令;定时事件;工具添加、移除与测试;版本列表、检索、更新与删除;金丝雀部署的创建、更新、删除与检索;获取 texml。
使用方式:先安装 gem install telnyx,并以 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。电话号码须为 E.164 格式(含 + 与国家代码,如 +13125550001)。列表分页可用 auto_paging_each 迭代。生产环境应处理 401、403、404、422、429 等错误,429 可用指数退避重试。
限制:不要臆造 Telnyx 参数、枚举、响应字段或 webhook 字段;若所需参数未在技能内联展示,应先查阅 references/api-details.md。使用附加操作前需阅读可选参数与响应模式章节。资料未提供具体收费、价格、平台限制或实际效果信息。