Skip to main content
AdCP SDK は L0–L3(ワイヤー、署名、認証、プロトコルセマンティクス)を吸収するため、あなたは L4 ビジネスロジックを書きます。既にいる言語の SDK を選んでください — 3 つの SDK すべてが同じワイヤー適合性のラインをターゲットにします。 この背後にある層モデル — 各層が何を含み、各層の SDK が何を提供すべきか — については SDK スタックリファレンス を参照。

カバレッジマトリクス

各層で「出荷済み」が何を意味するかは L0–L3 チェックリスト です。 最終更新: 2026-05-03。 凡例: ✅ 出荷済み · ⚠️ 部分的 / 進行中 · ❌ まだ未カバー。Production GA は今日ピン留めすべきラインです。Beta / dev は次のメジャーで進行中のものです。 @adcp/sdk 6.x は完全な L0–L3 を出荷します(AdCP 3.0)— 採用者は L4 のみを書きます。5.x ラインはセキュリティのみのサポートで新しいビルドに推奨されません。6.x に切り替えてください。adcp(Python)3.x は本番ライン で、完全な L0 型カバレッジ付き。4.x 書き直し(PyPI でベータ)が L1–L3 のギャップを閉じます — アウトバウンド RFC 9421 署名、ブランド解決ヘルパー、webhook 発出。4.0 GA カットについては adcp-client-python リリース を追跡してください。adcp-go は活発に開発中で、型 + トランスポートが最初に着地します。リリースごとに何がスコープ内かは adcp-go README を参照。 3.0 以前の呼び出し元は、アップグレード前に 3.0 移行ガイド を進めるべきです。公開されたすべてのプロトコルバージョンの一目でのステータスについては バージョンと互換性 を参照。サポートウィンドウの調達グレードのコンテキストについては、v2 サンセットタイムラインバージョニングとガバナンス を参照。 Python と TypeScript は、ファーストクラスのサポート言語として完全な L0–L4 カバレッジを運びます。 Go は同じ方向に動いています。他の言語 は公式ロードマップにありません。コミュニティ保守のポートは歓迎されます — Builders Working GroupSlack コミュニティ を参照。

JavaScript / TypeScript

npm version
リソース: パッケージエクスポート:
  • @adcp/sdk — メインエントリ: 呼び出し元(createSingleAgentClientADCPMultiAgentClient)と共有型
  • @adcp/sdk/server — エージェント側サーバープリミティブ(createAdcpServerFromPlatformcreateAdcpServer、決定プラットフォームインターフェース)
  • @adcp/sdk/server/legacy/v5 — レガシー v5 ハンドラーバッグエントリ、移行中盤のコードベース向けにまだサポート
  • @adcp/sdk/signing — RFC 9421 署名プリミティブ
  • @adcp/sdk/signing/server — webhook + リクエスト検証者(createWebhookVerifierverifyRequestSignaturecreateExpressVerifier
  • @adcp/sdk/signing/client — アウトバウンド署名(signRequestsignWebhookcreateSigningFetch
  • @adcp/sdk/testing — バイヤー側ストーリーボードランナー(runStoryboardcomplytestAgent)とセラー側コントローラースキャフォールド(createComplyControllerGet Test-Ready を参照)
  • @adcp/sdk/conformance — 適合性ハーネスのためのアサーション + ストーリーボードヘルパー
  • @adcp/sdk/schemas — バンドルされた AdCP JSON Schema
  • @adcp/sdk/types — TypeScript 型定義
  • @adcp/sdk/types/v2-5 — クロスバージョン呼び出し元のための v2.5 型共存インポート

Python

PyPI version
リソース:

Go

Go SDK は、型付きツール登録、レスポンスビルダー、コンプライアンステストコントローラーを提供します。型は正準 AdCP スキーマから生成されます。 完全な API リファレンスについては Go SDK README を参照。 リソース:

CLI ツール

JavaScript と Python の SDK は、テストと開発のためのコマンドラインツールを含みます。 両 SDK は同じ位置形状を共有します: adcp <agent> [tool] [payload]。最初の位置引数はエイリアス、ビルトイン(test-mcptest-a2a)、または URL — プロトコルは自動検出されます。再入力を避けるため --save-auth でエイリアスを保存します。

JavaScript CLI

CLI はストーリーボード(adcp storyboard run)、適合性グレーディング(adcp grade)、レジストリ診断も駆動します。完全なサーフェスについては --help を参照。

Python CLI

次は

  • Build an agent — サーバー側 L4 パス。スキルファイル + コーディングエージェント。
  • Build a caller — クライアント側 L4 パス。インストール、呼び出し、レスポンス処理、レポート取り込み。
  • Schemas — スキーマバンドル、型生成、バージョンピン留め。
  • Migrate from hand-rolled — SDK が多くをカバーする前に構築された AdCP エージェントを既に実行している? 一度に 1 層ずつスワップする。