破壊的なアクションを確認する
412 confirmation_required に対応します。確認トークンを発行し、X-Trustvice-Confirmation を付けて呼び出しをやり直します。
利用場面作業内容
confirmationPolicy が "always" のアクション、つまり destructive と billing_impacting のすべてのアクションを呼び出す必要がある場合です。Trustvice は、リクエストに新しい確認トークンが付くまでこれらを実行しません。人、または明示的な自律権限が、最近このアクションについて承認している必要があります。
始める前の準備
- アカウント
- Trustvice のワークスペース
- 認証情報
- ほかに必要なもの
- 最初のレシピと同じ OAuth アクセストークン
curl
コードはシークレットを環境変数から読み込みます。シェルかシークレットストアに保管し、コミットするファイルには決して書かないでください。アクションの呼び出しでは X-Workspace-Id も送ります。
手順
アクションを呼び出す
保護されたアクションを通常どおり呼び出します。トークンがないと、コード
confirmation_requiredとともに412が返ります。ドキュメントではprivacy.dsr.submitを例にしています。curl -sS -X POST https://api.trustvice.com/api/v1/actions/privacy.dsr.submit \ -H "Authorization: Bearer $TRUSTVICE_TOKEN" \ -H "X-Workspace-Id: ws_…" \ -H "Content-Type: application/json" \ -d '{ … }'{ "ok": false, "error": { "code": "confirmation_required", "message": "This action requires an explicit confirmation." } }確認トークンを発行する
POST /api/v1/confirmations/mintに、そのアクション ID 用のトークンを求めます。トークンは呼び出し元のアクターとアクションのオーディエンスに結び付き、数秒で失効し、最初の使用で消費されます。curlcurl -sS -X POST https://api.trustvice.com/api/v1/confirmations/mint \ -H "Authorization: Bearer $TRUSTVICE_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "actionId": "privacy.dsr.submit" }'アクションをやり直す
トークンの
jtiをX-Trustvice-Confirmationに入れて、同じ呼び出しをもう一度送ります。今度はアクションが実行され、本来の結果が返ります。curlcurl -sS -X POST https://api.trustvice.com/api/v1/actions/privacy.dsr.submit \ -H "Authorization: Bearer $TRUSTVICE_TOKEN" \ -H "X-Workspace-Id: ws_…" \ -H "X-Trustvice-Confirmation: cnf_…" \ -H "Content-Type: application/json" \ -d '{ … }'エージェントに範囲内で任せる
呼び出しごとに人がクリックせずに保護されたアクションを実行する必要があるエージェントは、自律権限を持ちます。期限付きで、安全性の上限があり、ワークスペースに記録されます。付与するには、
agents.autonomy.grantオーディエンス向けに人が発行した確認トークンが必要です。対象をカバーする権限が有効な間、mint は範囲内のアクションにautonomous: trueのトークンを返します。HTTPPOST /api/v1/autonomy/grant { "maxSafetyLevel": …, "ttlSeconds": … } POST /api/v1/autonomy/revoke GET /api/v1/autonomy/status
転載元の資料: /docs/confirmations
返される内容
mint の呼び出しは、jti にトークンを、audience に結び付いたアクションを、そして有効期限を返します。
{ "ok": true,
"jti": "cnf_…",
"audience": "privacy.dsr.submit",
"autonomous": false,
"expiresAt": "2026-09-14T13:20:37.675Z" }頼りにできること
頼りにできること
- 確認トークンは再利用できず、別のアクションにも使えません。
- 保護されたアクションが黙って実行されることはありません。呼び出しごとに新しいトークンか、対象をカバーする自律権限が必要です。
- 自律権限を自律的に作ることは決してできません。
前提にしてはいけないこと
- 確認済みの 2 回目の呼び出しが無害であること。安全でないアクションは冪等ではないため、2 回目の呼び出しは 2 回目の効果になります。
- トークンが使い続けられること。有効なのは数秒だけです。
上記の内容はすべて、このページからリンクしている Trustvice のドキュメントに基づいています。ドキュメントのほうが詳しい場合は、そちらが基準です。
次の手順
関連するレシピ
Agentic API のアクションを呼び出す
OAuth アクセストークンを発行し、公開カタログでアクションを探して POST /api/v1/actions/<id> で呼び出します。
MCP クライアントをつなぐ
https://mcp.trustvice.com/mcp の Trustvice MCP サーバーを Claude Code、Cursor、VS Code に追加します。
ブラウザーでレシートを検証する
Trustvice の署名付きレシートを /verify に貼り付け、Ed25519 署名をご自身のブラウザーで確認します。
新しいレシピをメールで
レシピ集にレシピを追加したときだけ、短いメールを1通。ほかのメールは送らず、どのメールからも配信停止できます。
Agentic API から始めましょう。
登録済みアクションごとに POST エンドポイントがひとつあり、REST でも MCP でも同じように動きます。ドキュメントには各アクションの入力と権限が載っています。