AdCP — Build an Agent

AdCP エージェントを構築する最速の方法は、コーディングエージェント（Claude Code、Codex、Cursor、Windsurf）を AdCP SDK のスキルファイルに向けることです。各スキルは 2〜8 分でプロトコル準拠、ストーリーボード検証済みのエージェントを生成します。

エンジニアリングチームのないパブリッシャー？ プロトコルコンプライアンスはローンチの一部です — プロダクト管理、アドサーバーへのアクティベーション、ホスティングは別の労力です。3 つのパス（マネージドプラットフォームと提携、事前構築されたエージェントをセルフホスト、独自に構築）については エージェントの運用 を参照。

SDK をインストール

各 SDK はプロトコルコンプライアンス — スキーマ検証、エラー形式、バージョンネゴシエーション、レスポンスビルダー — を扱うため、あなたはプロトコル配管ではなくビジネスロジックを書きます。

JavaScript/TypeScript
Python
Go

npm install @adcp/sdk

JS/TS SDK は、型付きツール登録、レスポンスビルダー、組み込みのストーリーボードランナーを提供します。本番のほとんどのエージェントがこの SDK を使います。

pip install adcp

Python SDK は同じケイパビリティを提供します — ADCPHandler をサブクラス化し、ツールを実装し、すべての返り値にレスポンスビルダーを使います:

from adcp.server import ADCPHandler, serve
from adcp.server.responses import capabilities_response

class MySeller(ADCPHandler):
    async def get_adcp_capabilities(self, params, context=None):
        return capabilities_response(["media_buy"])

    # ... implement tools, use response builders for every return

serve(MySeller(), name="my-seller")

レスポンスビルダー（adcp.server.responses）はスキーマコンプライアンスを扱うため、生の JSON を構築しません。すべてのツールの返りにそれらを使ってください。

go get github.com/adcontextprotocol/adcp-go/adcp

Go SDK は、型付きツール登録、レスポンスビルダー、コンプライアンステストコントローラーを提供します。型は正準 AdCP スキーマから生成されます。

Component	Import
ツール登録	`adcp.AddTool(server, name, desc, handler)`
HTTP サーバー	`adcp.Serve(createAgent)`
レスポンスビルダー	`adcp.ProductsResponse(data)`、`adcp.MediaBuyResponse(data)`
テストコントローラー	`adcp.RegisterTestController(server, store)`

完全な例については Go SDK README を参照。レスポンスビルダー（adcp.ProductsResponse()、adcp.MediaBuyResponse() など）はスキーマコンプライアンスを扱うため、生の JSON ではなく型付き struct を返します。

GitHub Repository

あなたの言語の SDK を使ってください。 3 つすべての SDK — JS/TS、Python、Go — がスキーマ検証、エラー形式、プロトコルネゴシエーションを扱います。プロトコルコンプライアンスのために異なる言語を使う必要はありません。

スキルを選ぶ

各 SDK は、コーディングエージェントに特定のエージェントタイプの構築を案内するスキルを出荷します。SDK 横断の一般的なスキル:

build-seller-agent — インベントリを販売するパブリッシャー、SSP、メディアネットワーク
build-signals-agent — オーディエンスセグメントを提供する CDP またはデータプロバイダー
build-creative-agent — クリエイティブをレンダリングするアドサーバーまたは CMP
build-generative-seller-agent — ブリーフから広告を生成する AI アドネットワーク
build-retail-media-agent — カタログ駆動のクリエイティブを持つリテールメディアネットワーク

例えば、JS/TS セラースキルは adcp-client/skills/build-seller-agent/SKILL.md にあります。各 SDK がそのスタック固有の実装ガイダンスを含むため、スキルカバレッジと命名は言語ごとに異なります。あなたの言語のディレクトリを参照:

JS/TS — adcp-client/skills
Python — adcp-client-python/skills
Go — adcp-go/skills

どのドメインと専門分野を主張するか？

各エージェントは get_adcp_capabilities で supported_protocols（ドメイン）と specialisms を宣言します。各スキルのストーリーボードはドメインベースラインを検証します — 専門分野も主張するには、エージェントはその専門分野のストーリーボードに合格しなければなりません。スキルから専門分野へのマッピング:

Skill	Typical `supported_protocols`	Typical `specialisms` (pick one or combine)
`build-seller-agent`	`["media_buy", "creative"]`	`sales-guaranteed`、`sales-non-guaranteed`
`build-generative-seller-agent`	`["media_buy", "creative"]`	`creative-generative` + `sales-non-guaranteed`
`build-retail-media-agent`	`["media_buy", "creative"]`	`sales-catalog-driven`
`build-signals-agent`	`["signals"]`	`signal-owned`、`signal-marketplace`
`build-creative-agent`	`["creative"]`	`creative-ad-server`、`creative-template`

セールス専門分野の選択: 完全な決定木については Compliance Catalog のセールス専門分野の選択を参照。クイックリファレンス:

sales-guaranteed — IO 承認、固定価格。RFP/プロポーザルフローをサポートするなら media_buy.supports_proposals: true を設定。直接購入のみなら false（または省略）。
sales-non-guaranteed — オークション / PMP。
sales-broadcast-tv、sales-catalog-driven、sales-social — チャネル固有。決定木を参照。

複数主張できます。完全なタクソノミーと専門分野ごとのストーリーボードについては Compliance Catalog を参照。 ブランド権利 エージェント（タレント、音楽、ストックメディアのライセンス）を構築している？今日スキルはありません — Brand Protocol ドキュメントを参照し、brand ドメインの下で brand-rights を主張してください。ストーリーボードとステータス（stable、preview、deprecated）を持つすべてのドメインと専門分野については Compliance Catalog を参照。ストーリーボード合格は AAO Verified (Spec) 修飾子を獲得します — テストモードエンドポイントでシードされたテストデータに対して検証。エージェントが実際の本番インベントリに対して実行されたら、専用のコンプライアンスアカウントで実際の配信の継続的な可観測性を追加する (Live) 修飾子への登録を検討してください。エージェントは (Spec)、(Live)、または両方を保持できます。AdCP を本番インフラとして扱うエンタープライズバイヤーは (Live) でフィルターします。

エージェントを構築する

コーディングエージェントをあなたのエージェントタイプのスキルファイルに向けます。Claude Code で:

JavaScript/TypeScript
Python
Go

Fetch https://raw.githubusercontent.com/adcontextprotocol/adcp-client/main/skills/build-seller-agent/SKILL.md, then build a seller agent for a premium sports news publisher with guaranteed CTV and OLV inventory.

Fetch https://raw.githubusercontent.com/adcontextprotocol/adcp-client-python/main/skills/build-seller-agent/SKILL.md, then build a seller agent for a premium sports news publisher with guaranteed CTV and OLV inventory.

あなたのエージェントタイプの adcp-client-python スキルに向けてください。正確なスキルがまだない場合、最も近いマッチについて adcp-client-python/skills を参照。

Fetch https://raw.githubusercontent.com/adcontextprotocol/adcp-go/main/skills/build-seller-agent/SKILL.md, then build a seller agent for a premium sports publisher.

Cursor または Windsurf では、スキルファイルをダウンロードしプロンプトのコンテキストとして含めます。各スキルはコーディングエージェントを次を通じて案内します:

ビジネスモデルの決定（何を販売、どう価格設定、承認ワークフロー）
正しいスキーマでのツール登録
ストーリーボード検証を通過するレスポンス形状
エラー処理とエッジケース

ストーリーボードで検証する

ストーリーボードランナーは、エージェントがどの言語で書かれているかにかかわらず Node.js を必要とします。

エージェントが実行されたら、一致するストーリーボードに対して検証します:

# JS/TS agent
npx tsx agent.ts &
npx @adcp/sdk@latest storyboard run http://localhost:3001/mcp media_buy_seller --json

# Python agent
python agent.py &
npx @adcp/sdk@latest storyboard run http://localhost:3001/mcp media_buy_seller --json

# Go agent
go run main.go &
npx @adcp/sdk@latest storyboard run http://localhost:3001/mcp media_buy_seller --json

ストーリーボードはすべての必須ツール呼び出しを実行しレスポンス形状を検証します。ストーリーボードランナーはデフォルトでサンドボックスモードを使います — あなたのエージェントはすべてのアカウント参照で sandbox: true を受け取り、実際のプラットフォーム呼び出しなしにシミュレートされたデータを返すべきです。合格する実行はエージェントがプロトコル準拠であることを意味します。

media_buy_seller (9 steps)
  ✓ get_adcp_capabilities
  ✓ sync_accounts
  ✓ get_products
  ✓ create_media_buy
  ✓ list_creative_formats
  ✓ sync_creatives
  ✓ list_creatives
  ✓ get_media_buy_delivery
  ✓ provide_performance_feedback
  9/9 passed

プロトコル準拠 ≠ 本番準備完了。 合格する実行はエージェントが AdCP を正しく話すことを意味します。ローンチには各ツール呼び出しの背後にビジネスインフラが必要です — プロダクトと価格、アドサーバーへのアクティベーション、オーダー管理、ホスティング、adagents.json 経由のディスカバリー登録。完全なリストと提携・セルフホスト・構築のいずれかについては エージェントの運用 を参照。

各スキルは異なるビジネスモデル用のバリアントストーリーボードを含みます — non-guaranteed、承認付き guaranteed、proposal モードなど。すべての利用可能なストーリーボードを見るには npx @adcp/sdk@latest storyboard list を実行。

完全なテストワークフロー — 失敗ステップのデバッグ、コンプライアンスチェックの実行、Addie を通じたインタラクティブな検証 — については エージェントを検証する を参照。エージェントが 上流プラットフォームをラップ する（DSP、SSP、リテールデータ、クリエイティブサーバー、シグナルマーケットプレイス）場合、ストーリーボードだけでは捕まえないファサードバグをサーフェスする事前ステージングゲートについては モック上流フィクスチャでアダプターエージェントを検証する を参照。

追加リソース

JS/TS SDK は、人間とコーディングエージェントの両方のために設計されたドキュメントを含みます:

Resource	JS/TS location	Purpose
プロトコル仕様	`node_modules/@adcp/sdk/docs/llms.txt`	1 ファイルの完全なプロトコル — ツール、型、エラーコード、例
サーバーガイド	`node_modules/@adcp/sdk/docs/guides/BUILD-AN-AGENT.md`	サーバー側実装パターン

Python と Go の同等物は各 SDK の GitHub リポジトリにあります。adcp-client-python と adcp-go を参照。

次は

エージェントを検証する — ストーリーボード、コンプライアンスチェック、build-validate-fix ループ
エージェントの運用 — プロトコル層の背後にあるもの、提携・セルフホスト・構築のいずれか
SDK を選ぶ — スキーマアクセス、CLI ツール、SDK パッケージエクスポート
MCP 統合ガイド — トランスポート、セッション、認証の詳細
タスクライフサイクル — ステータス値、遷移、ポーリング
エラー処理 — エラーカテゴリー、コード、リカバリー

はじめに

AdCP で構築する

プロトコル

FAQ

トラストとセキュリティ

リファレンス

AAO

認定

エージェントを構築する

SDK をインストール

スキルを選ぶ

どのドメインと専門分野を主張するか？

エージェントを構築する

ストーリーボードで検証する

追加リソース

次は

​SDK をインストール

​スキルを選ぶ

​どのドメインと専門分野を主張するか？

​エージェントを構築する

​ストーリーボードで検証する

​追加リソース

​次は

SDK をインストール

スキルを選ぶ

どのドメインと専門分野を主張するか？

エージェントを構築する

ストーリーボードで検証する

追加リソース

次は