SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场telnyx-missions-javascript

telnyx-missions-javascript

智能体与模型

查看项目

更新于 10-16 02:25

技能介绍

Telnyx Missions - JavaScript 是一个面向 Telnyx Missions 的 JavaScript SDK 使用示例技能，目标是通过 Telnyx 的 Node.js SDK 创建并管理 Telnyx Missions，即面向 AI 驱动电信运营的自动化工作流、任务及其子资源。

【用途】 资料将该技能定位为“JavaScript SDK examples”，即为开发者提供用 JavaScript 操作 Telnyx Missions 的接口调用范例。通过它可以用代码定义任务（mission）、发起运行（run）、记录事件（event）、维护执行计划（plan）及其步骤，并管理知识库与 MCP 服务器等子资源。

【安装与初始化】 安装命令为：npm install telnyx@6.74.2 初始化方式： import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }); 资料说明 apiKey 为默认项，可省略（默认读取环境变量）。后续所有示例均假定 client 已按上述方式初始化。

【错误处理】 资料指出所有 API 调用都可能因网络错误、限流（429）、校验错误（422）或认证错误（401）而失败，并给出生产环境建议的 try/catch 结构：捕获 Telnyx.APIConnectionError（网络错误，检查连通性并重试）、Telnyx.RateLimitError（429，按 retry-after 头等待后以指数退避重试）、Telnyx.APIError（输出 status 与 message，422 时提示检查必填字段与格式）。常见错误码包括 401 无效 API key、403 权限不足、404 资源不存在、422 校验错误、429 限流。

【主要能力（按接口分组）】

  1. Missions：列出全部任务（GET /ai/missions）、创建任务（POST /ai/missions，必填 name；可选 description、execution_mode、instructions、metadata、model）、获取任务详情（GET /ai/missions/{mission_id}，包含 tools、knowledge_bases、mcp_servers）、更新任务（PUT /ai/missions/{mission_id}）、删除任务（DELETE /ai/missions/{mission_id}）、克隆任务（POST /ai/missions/{mission_id}/clone）。
  2. 全局事件与运行：列出所有任务的近期事件（GET /ai/missions/events）、列出所有任务的近期运行（GET /ai/missions/runs）。
  3. 任务下的运行：列出某任务的运行（GET /ai/missions/{mission_id}/runs）、启动运行（POST，可选 input、metadata）、获取运行详情（GET）、更新运行（PATCH，可选 error、metadata、result_payload、result_summary、status）、取消运行（POST .../cancel）、暂停运行（POST .../pause）。运行状态枚举为 pending、running、paused、succeeded、failed、cancelled。
  4. 运行事件：列出运行的事件（GET .../events，分页）、记录事件（POST .../events，必填 type、summary；可选 agent_id、idempotency_key、payload、step_id）、获取事件详情（GET .../events/{event_id}）。事件类型枚举为 status_change、step_started、step_completed、step_failed、tool_call、tool_result、message、error、custom。
  5. 执行计划与步骤：获取计划（GET .../plan）、创建初始计划（POST .../plan，必填 steps）、向计划追加步骤（POST .../plan/steps，必填 steps）、获取步骤详情（GET .../plan/steps/{step_id}）、更新步骤状态（PATCH .../plan/steps/{step_id}，可选 metadata、status）。步骤状态枚举为 pending、in_progress、completed、skipped、failed。
  6. 知识库：列出（GET .../knowledge-bases）、创建（POST）、获取（GET .../knowledge-bases/{knowledge_base_id}）、更新（PUT）、删除（DELETE）。
  7. MCP 服务器：列出（GET .../mcp-servers）、创建（POST）、获取（GET .../mcp-servers/{mcp_server_id}）、更新（PUT）、删除（DELETE）。

【使用方式】 资料给出的典型模式是直接调用 client.ai.missions.* 下的方法，例如创建任务 client.ai.missions.create({ name: 'my-resource' })，启动运行 client.ai.missions.runs.create('...')，记录事件 client.ai.missions.runs.events.log('...', { mission_id, summary, type }) 等。列表类方法返回自动分页迭代器，可用 for await (const item of result) { ... } 自动遍历所有页。

【返回字段概览】 任务返回 created_at、description、execution_mode（external/managed）、instructions、metadata、mission_id、model、name、updated_at；运行返回 error、finished_at、input、metadata、mission_id、result_payload、result_summary、run_id、started_at、status、updated_at；事件返回 agent_id、event_id、idempotency_key、payload、run_id、step_id、summary、timestamp、type；计划步骤返回 completed_at、description、metadata、parent_step_id、run_id、sequence、started_at、status、step_id。

【适用场景与限制】 适用场景为在 Node.js / JavaScript 项目中以编程方式创建、编排、监控 AI 驱动的任务工作流，并管理其知识库与 MCP 服务器等资源。限制方面：资料未提供具体的计费方式、价格、服务等级、平台支持范围或性能指标，这些信息暂未提供；实际调用行为取决于 Telnyx API 与 SDK 版本（示例固定为 telnyx@6.74.2），资料亦未说明对浏览器环境的支持情况。