确认破坏性操作

前置准备条件

开始之前的准备

账户

一个 Trustvice 工作区

所需的凭据

• OAuth 访问令牌

您还需要准备

• 与第一个示例相同的 OAuth 访问令牌
• curl

代码从环境变量中读取密钥。请将其保存在 shell 或密钥存储中，切勿写入要提交的文件。操作调用还需要发送 X-Workspace-Id。

分步讲解

步骤

1. 1

   调用操作

   照常调用受保护的操作。没有令牌时，它会返回 412 和代码 confirmation_required。文档以 privacy.dsr.submit 为例。

   curlJSON

   复制

   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 '{ … }'

2. 2

   签发确认令牌

   向 POST /api/v1/confirmations/mint 请求该操作 ID 的令牌。令牌绑定到调用方和该操作的受众，只存活几秒，并在首次使用时被消耗。

   curl

   复制

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

3. 3

   重新调用操作

   将令牌的 jti 放入 X-Trustvice-Confirmation，再次发送同一调用。此时操作会执行并返回真实结果。

   curl

   复制

   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 "X-Trustvice-Confirmation: cnf_…" \
     -H "Content-Type: application/json" \
     -d '{ … }'

4. 4

   让智能体在限度内行动

   需要在每次调用时无需人工点击就执行受保护操作的智能体，持有一项自主授权：有时限、有安全上限，并记录在工作区中。授予自主权本身需要一个针对 agents.autonomy.grant 受众、由人签发的确认令牌。在有覆盖范围的授权生效期间，mint 会为范围内的操作返回 autonomous: true 的令牌。

   HTTP

   复制

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

证明内容

您可以依赖什么

以上每一条说明都来自本页链接的 Trustvice 文档。如果文档页面写得更详细，以文档为准。

继续深入

后续步骤

相关的其他示例

邮件简报

新示例邮件通知

通过邮件接收新的示例

当我们向实用示例中添加新示例时，会发送一封简短的邮件。不会发送其他任何邮件，而且您可以从任意一封邮件中退订。

电子邮件地址立即订阅

请就我所选择的主题给我发送电子邮件。我可以随时通过任意一封邮件取消订阅。 我们的隐私政策