用途：该技能提供使用 curl 调用 Telnyx AI Assistants API 的参考，用于创建和管理 AI 语音助手，支持自定义指令、知识库与工具集成。
主要能力：核心操作包括创建助手（POST /ai/assistants，必填 name、instructions，可选 tags、model 等）、与助手聊天（POST /ai/assistants/{assistant_id}/chat，必填 content、conversation_id）、创建助手测试（POST /ai/assistants/tests，必填 name、destination、instructions、rubric）。辅助操作包括获取、更新、列出、删除助手，从外部提供商（elevenlabs、vapi、retell）导入助手，管理标签、测试套件与运行历史。附加操作涵盖金丝雀发布、SMS 聊天、克隆助手、增强指令、定时事件、工具管理、版本管理与 MCP 服务器等。
使用方式：curl 在 macOS、Linux 和 Windows 10+ 上预装。先设置环境变量：export TELNYX_API_KEY="YOUR_API_KEY_HERE"，随后在请求头中使用 Authorization: Bearer $TELNYX_API_KEY 认证。示例：curl -X POST -H "Authorization: Bearer $TELNYX_API_KEY" -H "Content-Type: application/json" -d '{"name":"my-resource","instructions":"You are a helpful assistant.","model":"openai/gpt-4o"}' "https://api.telnyx.com/v2/ai/assistants"。
适用场景：需要以脚本或命令行方式集成 Telnyx AI 语音助手、批量管理助手配置、运行自动化测试或进行版本发布的开发与运维流程。
限制与注意事项：电话号码须为 E.164 格式（如 +13125550001），包含 + 前缀和国家代码，不能有空格、短横线或括号。列表接口分页，使用 page[number] 和 page[size] 参数，并检查响应中的 meta.total_pages。常见错误码：401 无效 API 密钥、403 权限不足、404 资源未找到、422 验证错误、429 限流（需指数退避重试）。不要臆造参数、枚举、响应字段或 webhook 字段；未内联展示的字段需查阅 references/api-details.md。部分操作（如 tools）已标记为不推荐用于新集成。具体收费与价格信息暂未提供。