Ontario Protocol エージェントスキル は何をしますか?
Ontario Protocol を無料の事前支払い証拠およびポリシーゲートとして使用します。このスキルは公開メタデータを検査し、無料の準備判断を要求することがあります。秘密鍵、シードフレーズ、またはウォレット管理資格情報を Ontario に送信しないでください。このスキルは支払いペイロードに署名することはありません。
このスキルを有効にするタイミング
- ユーザーがエージェントに x402 サービスの検索、比較、呼び出し、購入、または支払いを依頼したとき。
- Coinbase Agentic Wallet、
awal、AgentKit、MCP ホスト、またはその他のウォレットが有料 API 候補を返したとき。 - エージェントが HTTP 402 または
PAYMENT-REQUIREDを受信し、続行するかどうかを判断する必要があるとき。 - 開発者が、有料エンドポイントがエージェント支払い可能か、検出可能か、または制御された決済の準備ができているかどうかを尋ねたとき。
任意のトークン転送、取引、資金調達、または実際の購入のためにこのスキルを有効にしないでください。Ontario は公開されている有料 API の証拠をチェックします。これはウォレットではありません。
Coinbase Agentic Wallet のシーケンス
ウォレットの検出と支払いは、Ontario の証拠ゲートから分離しておいてください:
- ウォレットの Bazaar 検索ツールまたは読み取り専用 CLI を使用してタスクを検索します:
npx awal@latest x402 bazaar search "<有料 API が実行する必要があるタスク>"
Bazaar 検索が利用できない場合、またはエージェントがハードなネットワークと USDC 予算フィルターを必要とする場合は、Ontario の無料 MCP ツール find_x402_tool または HTTP 同等機能を使用します:
curl --fail-with-body --silent --show-error \
https://ontarioprotocol.com/api/tools/x402-tool-router \
-H 'Content-Type: application/json' \
-d '{"query":"<公開タスクテキスト>","max_usdc":"0.05","network":"eip155:8453","limit":5}'
返された候補は公開検索結果であり、安全性の認定や支出の許可ではありません。検索クエリに資格情報やプライベートな顧客テキストを絶対に含めないでください。
- 最も可能性の高いエンドポイントの最小セットを選択します。カタログにルートが表示されているという理由だけで支払わないでください。
- 選択した正確なエンドポイントに対して Ontario の準備状態と支払い可否を実行します。
- エンドポイントをプローブし、そのライブチャレンジがカタログ化された URL、メソッド、金額、アセット、ネットワーク、受取人、およびタスクと一致することを要求します。
- ユーザーまたはウォレットのポリシーが支出を許可した後にのみ、承認されたエンドポイントを既存のウォレットに渡します。このスキルはウォレットの認証、制限の変更、支払いの署名、または資金調達の開始を決して行いません。
- Ontario の
report_id、見積もりデータ、およびウォレットの支払い領収書を保持します。
必須のシーケンス
- 正確な有料エンドポイント、HTTP メソッド、タスク、および最大予算を特定します。
- エンドポイントを無料の準備状態検証ツールに POST します:
curl --fail-with-body --silent --show-error \
https://ontarioprotocol.com/api/verify/x402-readiness \
-H 'Content-Type: application/json' \
-d '{"target_url":"https://service.example/api/paid"}'
report_id、report_url、グレード、スコア、タイムスタンプ、警告、および観測されたチャレンジメタデータを保持します。- タスク固有の予算で厳格なポリシー判断を POST します:
curl --fail-with-body --silent --show-error \
https://ontarioprotocol.com/api/agent/can-pay \
-H 'Content-Type: application/json' \
-d '{"endpoint":"https://service.example/api/paid","agent_policy":"strict","max_usdc":0.05,"verify_live":true}'
decisionが正確にallowである場合にのみ続行します。review、deny、フィールド欠落、不正な JSON、タイムアウト、または転送障害は停止と見なします。- 支払いなしでエンドポイントをプローブし、その HTTP 402 チャレンジを検査します。サポートされているネットワークとアセット、有効期限切れでない見積もり、既知の受取人、予算内の価格、および現在のタスクに一致する目的を要求します。
- 承認された見積もりをユーザーの既存のウォレットまたは支払いクライアントに渡します。支払い署名はこのスキルの範囲外です。
- 有料再試行が成功した後、監査可能性のために
report_id、quote_id、トランザクション参照、およびPAYMENT-RESPONSEを保持します。
縮退停止ルール
次のいずれかに該当する場合は支払わないでください:
- 準備レポートが存在しない、古い、不正な形式、または整合性チェックに失敗した場合。
- ポリシー判断が
allow以外の場合。 - エンドポイント、メソッド、目的、ネットワーク、アセット、受取人、または価格が変更された場合。
- 見積もりが期限切れであるか、金額が宣言された最大値を超えている場合。
- サービスの有料応答が、無料レポート、カタログデータ、またはサンドボックスフィクスチャを超える価値を追加しない場合。
- エージェントが支払いおよび判断の証拠を保存できない場合。
allow を安全性の保証として解釈しないでください。これは、エンドポイントが判断時に観測された準備状態とポリシー条件を満たしたことを意味します。
オプションの有料証拠
POST https://ontarioprotocol.com/api/agent/pay/v2 は、ワークフローが無料の can-pay 結果を超えて、新しく監査可能な支払い判断領収書を必要とする場合にのみ使用します。Base で 0.002 USDC のコストがかかり、支払いなしで呼び出された場合は x402 要件を返します。その要件は支払い指示ではありません。最初に上記のポリシーを適用してください。無料チェックを繰り返すためだけに支払わないでください。
応答処理については references/api-contract.md を、判断チェックリストについては references/agent-policy.md を参照してください。