幂等性

每项操作保留一个 UUID，超时或重试时重复使用。同一 UUID 对应不同输入会被拒绝。

每个操作一个意图#

HTTP

Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03

REST 请求将工具参数封装在 input 中。MCP 调用直接发送相同参数。

JSON

{  "_meta": {    "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03"  }}

超时后恢复#

决定是否重新提交前，请按意图标识查找原操作。

curl 'https://platform.tongai.io/v1/operations/by-intent/45be69f1-c266-4a09-a82c-bf3c6303eb03' \  -H "Authorization: Bearer $TONG_API_KEY"

配置

curl --version

错误与速率限制了解错误响应，安全重试并恢复失败的生成任务。请求与日志请求被接受不代表生成已完成。请跟踪已保存的任务，直到输出就绪。

操作意图冲突#

JSON

{  "error": {    "code": "IDEMPOTENCY_CONFLICT",    "message": "This intent was already used for different details.",    "request_id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",    "retryable": false  },  "request_id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8"}

仅在输入完全相同时复用意图标识。新的操作请使用新的 UUID。