エージェントの消費量を管理し、リクエストを承認する
エージェントが有料の作業を開始する方法：見積もり、ジョブ・1日・1ヶ月あたりの消費上限、以下を自動的に承認、エージェントのリクエストの承認または拒否について。誰が決定権を持つか、有効期限、およびすべての拒否メッセージについて解説します。
エージェントは、製品デモ動画やソーシャルクリップなどのクレジットを消費する作業を開始できますが、それはトークンに設定した制限の範囲内に限られます。また、トークンの自動承認ラインを超える作業には、人の承認が必要です。この記事では、消費上限、自動承認、およびエージェントのリクエストを承認または拒否する方法について説明します。
クレジットを消費するもの
| エージェントは無料 | クレジットを消費（アプリ内と同じ） |
|---|---|
| 読み取り、検索、一覧表示 | 録画からの動画（ハウツー、製品デモ、クリーンアップ、スタイル適用） |
| 見積もりとドライラン | ソーシャルクリップ |
| ジョブの確認と待機 | 録画からの記事 |
| 動画エクスポート（最大4KのMP4） | 動画の翻訳 |
| 素材と画像のアップロード | ドキュメントサイトの記事、変更履歴、サイトページの翻訳、およびAI生成されたサイトページ |
有料の作業を開始するには、トークンに credits:spend および その作業に対する権限（例： videos:create）が必要です。プロデューサー と ワークスペースエージェント のプリセットには、その両方が含まれています。
有料作業の開始がチェックされる仕組み
有料の作業を開始する際は、必ず最初に見積もりが作成されます。見積もりにはクレジットの範囲（例：45〜60クレジット）が示され、15分間有効で、1回のみ使用可能です。エージェントが作業を開始すると、Cleveraは以下の順序でチェックを行います。
- プラン。 有料のエージェント作業は、Pro、Business、およびCustomプランで利用可能です。それ以外の場合：「お使いのプランには有料のエージェント作業が含まれていません。エージェントが作業を開始できるようにアップグレードしてください。」
- クレジット。 アプリ内で作業を開始する場合と同様に、ワークスペースに見積もり分の十分なクレジットが必要です。
- トークンの上限。 見積もりの上限額が ジョブあたり の制限に収まり、かつ 1日あたり および 1ヶ月あたり の残額（その日またはその月に消費されたクレジットに、現在実行中のトークンのジョブの見積もりを加えたもの）に収まっている必要があります。上限を超える場合：「この操作はトークンの消費上限を超えます。ワークスペース管理者が上限を引き上げることができます。」
- 承認。 見積もりの上限額がトークンの 以下を自動的に承認 の値以下であれば、作業が開始されます。それ以外の場合は、エージェントのリクエスト にて人の操作を待機します。
作業には、アプリ内と同様に実際に使用した分のクレジットが課金されます。1日および1ヶ月は、暦日および暦月を指します。
上限を設定する
上限は、トークンを作成する 際の 制限 ステップで設定します。消費量 は、トークンに credits:spend がある場合にのみ表示されます。
| フィールド | 動作 | 空または0の場合 |
|---|---|---|
| ジョブあたり | 1回の開始で見積もられる最大額。 | 空：制限なし。 |
| 1日あたり | トークンが暦日に消費できる最大額。 | 空：制限なし。 |
| 1ヶ月あたり | トークンが暦月に消費できる最大額。 | 空：制限なし。 |
| 以下を自動的に承認 | このクレジット数未満で見積もられた開始は、人の介入なしで実行されます。 | 0：「すべての有料開始に人の承認が必要」。 |
| プラン | 以下を自動的に承認 の上限 |
|---|---|
| Pro, Business | 500クレジット |
| Custom | 1,000クレジット |
上限は整数単位のクレジットです。トークンの上限は後から変更できないため、引き上げや引き下げを行う場合は、新しいトークンを作成して古いトークンを取り消してください。シークレットを再生成しても、上限は維持されます。
リクエストを承認または拒否する
エージェントのリクエストを開く
エージェントが待機状態になると、ワークスペースのオーナー、管理者、およびトークンの所有者に「agent があなたの承認を必要としています」という通知が届き、「最大 n クレジットを消費しようとしています」と表示されます。確認 をクリックするか、AIエージェントとAPI → エージェントのリクエスト を開いてください。タブには待機中の件数が表示されます。
リクエストを確認する
あなたの操作を待機中 にある各リクエストには、エージェント、種類（クレジットを消費）、クレジットの範囲、作成しようとしているもの、依頼済み の日時、有効期限、および使用されたトークンが表示されます。
各リクエストには、エージェントが実行したい内容とクレジットの範囲が表示されます。 決定する
承認 をクリックし、「このリクエストを承認しますか？」で確定すると、ジョブが開始されます。拒否 をクリックすると、ジョブはキャンセルされ、課金は発生しません。ワークスペースがPro以上のプランでなくなった場合、承認 をクリックすると「APIおよびエージェントへのアクセスはお使いのプランに含まれていません。」と表示されますが、拒否 は引き続き機能します。
- 消費量を決定できるのはワークスペースのオーナーと管理者のみです。 他のメンバーには「オーナーまたは管理者が決定します」と表示されます。エージェントが自身のリクエストを承認することはできず、エージェントトークンは承認エンドポイントを呼び出すこともできません。
- リクエストは24時間で期限切れになります。 期限切れになったリクエストのジョブはキャンセルされ、エージェントは再度依頼する必要があります。
- 決定済みおよび期限切れのリクエストは 履歴（「決定済みまたは期限切れのリクエスト」）に移動し、結果（承認済み、拒否されました、期限切れ、キャンセル済み）と決定者が記録されます。
- エージェントは待機中、自身のジョブを
needs_inputとして認識し、あなたが決定を下すと結果を確認します。Webhook を使用すると、システム側でapproval.requestedおよびapproval.decidedを受け取ることができます。
オーナーや管理者ではないメンバーは、自分自身のエージェントのリクエストのみを確認できます：「エージェントがクレジットを消費または公開する前に、ここで依頼を行い、オーナーまたは管理者の承認を待機します。」
その他の消費制限
| 制限 | 発生する事象 |
|---|---|
| トークンあたり1時間20回、ワークスペースあたり1日100回の有料開始 | 期間が経過するまで、それ以降の開始は rate_limited で拒否されます。 |
| 1つのトークンによる異常な速度でのクレジット消費 | 24時間、そのトークンは有料作業を開始できなくなります。所有者には「token で異常なアクティビティ」という通知が届きます：「短時間で異常に多くのクレジットが消費されたため、現在有料作業を開始できません。」 |
| 同時に2つの開始がチェックされた場合 | 「別の開始がチェックされています。しばらくしてから再試行してください。」 |
トラブルシューティング
| メッセージ | 原因 | 解決策 |
|---|---|---|
| 「この操作はトークンの消費上限を超えます。ワークスペース管理者が上限を引き上げることができます。」 | 見積もりが ジョブあたり、または 1日あたり や 1ヶ月あたり の残額に収まっていません。 | 翌日または翌月まで待つか、より高い上限を持つトークンを作成してください。 |
| 「お使いのプランには有料のエージェント作業が含まれていません。エージェントが作業を開始できるようにアップグレードしてください。」 | ワークスペースがPro、Business、またはCustomプランではありません。 | アップグレードしてください。 |
| 「クレジット不足」というメッセージ | ワークスペースに見積もり分の十分なクレジットがありません。 | クレジットを購入 するか、付与されるまで待ってください。 |
| 「この見積もりは期限切れです。新しい見積もりを依頼してください。」 | 見積もりから15分以上経過しています。 | エージェントに新しい見積もりを依頼させてください。 |
| 「この見積もりは既に使用されています。新しい見積もりを依頼してください。」 | 見積もりは既にジョブを開始するために使用されました。 | エージェントに新しい見積もりを依頼させてください。 |
| 「お使いのプランでは、500クレジット未満のエージェント作業が自動的に承認されます。」 | 以下を自動的に承認 がプランの最大値を超えています。 | 値を下げてください。 |
| 「APIおよびエージェントへのアクセスはお使いのプランに含まれていません。」（承認 時） | ワークスペースがProプランから外れました。 | Proプランにアップグレードするか、リクエストを拒否してください。 |
| 「このリクエストは既に決定済みか、期限切れです。」 | 他の誰かが決定したか、24時間が経過しました。 | 対応不要です。履歴 を確認してください。 |
| 「このリクエストを決定することはできません。」 | あなたの権限では消費を承認できません。 | ワークスペースのオーナーまたは管理者に依頼してください。 |
| エージェントが待機したまま何も起こらない | リクエストが エージェントのリクエスト で待機中です。 | 24時間以内に承認または拒否してください。 |