Skip to main content
このページは、AdCP で構築するための 2 つの基礎的なリソース — すべてのリクエストとレスポンスを定義する JSON スキーマと、それらのスキーマを型付きコードに変える SDK — への道案内をします。

SDK

AdCP は TypeScript、Python、Go 向けの公式 SDK を提供します。各 SDK はプロトコルレイヤー(ワイヤーフォーマット、署名、認証、ライフサイクルセマンティクス)を吸収するため、あなたはビジネスロジックだけを書けばよいのです。

TypeScript

npm install @adcp/sdk

Python

pip install adcp

Go

go get github.com/adcontextprotocol/adcp-go
完全なカバレッジマトリクス(各 SDK が現在提供するレイヤー)、バージョンピン留めのガイダンス、パッケージエクスポートの詳細は Choose your SDK を参照してください。 SDK の背後にあるレイヤーモデル — L0 から L4 がそれぞれ何を含むか、そしてなぜ SDK が単純なプロトコルよりも AdCP で重要なのか — は、SDK stack リファレンス を参照してください。

スキーマ URL

AdCP スキーマは、現在のメジャーバージョンエイリアスの下、https://adcontextprotocol.org/schemas/ で公開されています: スキーマは、すべてのタスクのリクエストとレスポンス、共有 enum、ガバナンスオブジェクト、クリエイティブフォーマット、シグナル定義をカバーします。本番と CI では現在のメジャーバージョン URL を使用し、メジャーリリースをまたいでリンクが安定するようにします。 ワイヤーレベルの adcp_protocol_version がスキーマバンドルバージョンとどう関係するか、そしてなぜそれらが別物なのかは、Versioning & governance を参照してください。

adagents.json の認可

パブリッシャーは、エージェントエンドポイントと認可スコープを adagents.json で宣言します。スキーマは 6 つの認可タイプ — property_idsproperty_tagsinline_propertiespublisher_propertiessignal_idssignal_tags — をサポートし、それぞれがエージェントが行動を認可されるインベントリをスコープします。 認可タイプの完全なリファレンスと実例は、ガバナンスドキュメントの Authorization Patterns を参照してください。

次のステップ

Choose your SDK

各言語のカバレッジマトリクス、インストールコマンド、バージョンピン留め。

Build an agent

セラーエージェント構築のためのスキルファイルとステップバイステップガイド。

Build a caller

ケイパビリティの発見とレスポンス処理のためのバイヤー側リファレンス。

Validate your agent

コンプライアンススイートを実行して実装を検証します。