Capability Marketplace
ケイパビリティ品質ガイド
Xenodia が公開する各ケイパビリティで確認できる情報と利用上の保証です。
公開済みの各ケイパビリティには、ユーザーや Agent が利用可否と Xenodia 経由の安全な呼び出し方法を判断するための情報が含まれます。
公開情報
| フィールド | 内容 |
|---|---|
slug | Xenodia の公開ルートで使う安定した識別子。 |
name | カタログに表示される名称。 |
category | 対応するタスクの分類。 |
short_description | 用途の簡潔な説明。 |
default_version | 現在公開されている API バージョン。 |
funding_modes | 対応する支払い方法。 |
invoke_path | 既定操作の Xenodia 公開ルート。 |
operations | 利用可能な操作、入力、出力、価格。 |
agent_doc_what | Agent がこの機能を選ぶ条件。 |
agent_doc_how | 推奨手順と安全ルール。 |
trust_signals | 証拠、鮮度、可用性、冪等性、監査の情報。 |
操作情報
各操作には、Xenodia のメソッドとパス、目的、価格、入力項目、最小リクエスト例、期待される出力、実行モード、Idempotency-Key の要否が示されます。
バージョンと互換性
公開済みの slug とルートは安定して維持されます。互換性のない変更が必要な場合、Xenodia は新しいバージョンを公開し、必要に応じて既存の互換ルートを維持します。
説明、タグ、例、利用ガイドは、既存バージョンの動作を変えずに改善されることがあります。
価格と安全性
価格は unit_price_micro_usdc で表され、1000000 は 1 USDC です。複数操作を持つ機能では、呼び出し前に操作ごとの価格を確認できます。
有料操作を呼び出す前に、次を確認してください。
- 操作が現在利用可能であること。
- 現在の価格と支払い方法が目的に合うこと。
- リクエストが公開された入力形式に従うこと。
- 同じ有料または非同期リクエストを再試行する場合だけ、同じ
Idempotency-Keyを使うこと。 - 問い合わせや監査のため、返されたリクエスト ID と請求概要を保持すること。
ユーザー向けカタログには、機能の選択、呼び出し、価格確認、再試行、監査に必要な情報だけが表示されます。