Skip to main content
営業エージェントがサポートするクリエイティブフォーマットを探索します。稼働中のプロダクトで使われているフォーマットを、権威となるクリエイティブエージェントへの参照付きで返します。 リクエストパラメーター、レスポンス構造、テスト可能な例を含む完全な API ドキュメントは list_creative_formats タスクリファレンス を参照してください。

営業エージェントの挙動

営業エージェントは、クリエイティブエージェントとは異なる形で list_creative_formats を実装します: 営業エージェント(例: https://test-agent.adcontextprotocol.org):
  • 稼働中のプロダクトで使われているフォーマットのみ を返す
  • 権威となるフォーマット仕様についてクリエイティブエージェントを参照する
  • 実際に購入可能なものに基づいて結果をフィルタリングする
クリエイティブエージェント(例: https://creative.adcontextprotocol.org):
  • 自身が保有する 権威あるフォーマット定義 を返す
  • クリエイティブを構築・検証するための完全な仕様を提供する

レスポンス構造

営業エージェントのレスポンスには次が含まれます:
{
  "formats": [
    {
      "format_id": {
        "agent_url": "https://creative.adcontextprotocol.org",
        "id": "display_300x250"
      },
      "name": "Display 300x250",
      "type": "display"
    }
  ],
  "creative_agents": [{
    "agent_url": "https://creative.adcontextprotocol.org",
    "agent_name": "AdCP Reference Creative Agent",
    "capabilities": ["validation", "assembly", "preview"]
  }]
}
クリエイティブエージェントとの主な違い:
  • フォーマットは format_id.agent_url で外部のクリエイティブエージェントを参照する場合がある
  • creative_agents 配列が完全なフォーマット仕様への入り口を提供する
  • フォーマットリストは購入可能な在庫に絞られる

典型的なワークフロー

  1. 営業エージェントの list_creative_formats を呼び出し、利用可能なフォーマットを確認する
  2. 完全な仕様が必要な場合は format_id.agent_url のクリエイティブエージェントに問い合わせる
  3. フォーマット仕様を使ってクリエイティブを構築・検証する

関連ドキュメント