telnyx-missions-java

Telnyx Missions - Java 技能用于通过 Telnyx Java SDK 管理 Missions，即面向 AI 驱动电信运营的自动化工作流、任务与子资源。

安装：Maven 引入 com.telnyx.sdk:telnyx:6.89.0；Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.89.0")。初始化：TelnyxClient client = TelnyxOkHttpClient.fromEnv();（后续示例均假设已初始化）。

主要能力围绕 Missions 的 REST 资源：

1. 任务管理：GET /ai/missions 列出任务；POST /ai/missions 创建（必填 name，可选 description、execution_mode（external/managed）、instructions、metadata、model）；GET/PUT/DELETE /ai/missions/{mission_id} 查改删；POST /ai/missions/{mission_id}/clone 克隆。
2. 知识库：/ai/missions/{mission_id}/knowledge-bases 的增删改查。
3. MCP 服务器：/ai/missions/{mission_id}/mcp-servers 的增删改查。
4. 运行：/ai/missions/runs 列出全部运行；/ai/missions/{mission_id}/runs 列出并按 mission 启动运行（可选 input、metadata）；查详情、PATCH 更新状态与结果（error、metadata、result_payload、result_summary、status）、POST .../cancel 取消。
5. 事件：/ai/missions/events 列出全局近期事件；/ai/missions/{mission_id}/runs/{run_id}/events 分页列出并记录事件（必填 type、summary，可选 agent_id、idempotency_key、payload、step_id）；事件类型含 status_change、step_started、step_completed、step_failed、tool_call、tool_result、message、error、custom。

使用方式：以 Java SDK 方法调用对应端点，如 client.ai().missions().list()、create(params)、runs().create(id)、runs().events().log(params) 等，参数通过 Builder 构造。

错误处理：调用可能因网络、限流（429）、校验（422）、认证（401）失败，应捕获 TelnyxServiceException 并处理状态码；422 检查字段格式，429 采用指数退避重试。常见码：401 无效 API key、403 权限不足、404 资源不存在、429 限流。

分页：列表方法返回一页，可用 .autoPager() 自动迭代，或 .hasNextPage() 与 .nextPage() 手动控制。

限制与缺失：本资料为技能示例，未提供收费、价格、平台支持、配额或完整生产部署步骤等信息，暂未提供。