冪等性

各操作に1つのUUIDを割り当て、タイムアウトや再試行時にも再利用します。同じUUIDで異なる入力を送ると拒否されます。

操作ごとに1つの意図ID#

HTTP

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

RESTはツール引数をinputで囲み、MCPは同じ引数を直接送信します。

JSON

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

タイムアウト後に復旧#

再送信を判断する前に、意図IDで元の操作を検索してください。

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

設定

curl --version

エラーとレート制限エラーを理解し、安全に再試行して、失敗した生成を復旧します。リクエストとログ受理済みでも生成完了ではありません。出力が準備できるまで保存済みジョブを追跡します。

意図IDの競合#

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"}

意図IDは元の入力にのみ再使用し、新たな操作には新しいUUIDを使用してください。