トラブルシューティング
認証、権限、validation、競合、課金エラーを切り分けます。
| 状況 | 確認すること |
|---|---|
| 401 / 未認証 | epismo whoami、token 期限、login 状態 |
| 403 / 権限なし | workspace、scope、owner role、object ACL |
| 404 / 見つからない | ID、archive 状態、現在の ACL。見えない object も404になり得る |
| 409 / conflict | 最新 Case・Task・Playbook Version を再取得して変更を再評価 |
| 422 / validation | input schema、required field、Step ID、resource ref |
| 402 / credit 不足 | active workspace と credit balance |
| 429 / rate limit | 即時 loop を止め、backoff して retry |
CLI では stderr の error code、message、retryable を確認します。MCP では tool error をそのままユーザーへ転記せず、認証・入力・競合のどれかを判定します。
idempotency key は同一内容の不確実な request にだけ再利用します。validation error を直した request や、state を読み直して作り直した request には新しい key を使います。