仕様

​

Protocol Overview

1. ディスカバリー - ホストがブランドエージェントとその機能を発見する方法
2. 提供内容の照会 - セッション引き継ぎ前の匿名チェック
3. セッション管理 - 開始、メッセージ交換、終了
4. 機能ネゴシエーション - 利用できる機能の決定
5. UI コンポーネント - 描画用の標準的なビジュアル要素

​

Transport Requirements

​

サポートするトランスポート

​

トランスポートの宣言

{
  "adcp": { "major_versions": [2] },
  "supported_protocols": ["sponsored_intelligence"],
  "sponsored_intelligence": {
    "endpoint": {
      "transports": [
        { "type": "mcp", "url": "https://brand.example/mcp" }
      ],
      "preferred": "mcp"
    },
    "capabilities": { ... },
    "brand_manifest_url": "https://brand.example/.well-known/brand-manifest.json"
  }
}

​

Discovery

​

機能ディスカバリー

• supported_protocols 配列内の sponsored_intelligence
• 次を含む sponsored_intelligence オブジェクト:
  • endpoint - トランスポートの設定（必須）
  • capabilities - サポートするモダリティとコンポーネント（必須）

• brand_manifest_url - ブランドアイデンティティの参照

​

Get Offering

​

Purpose

​

Requirements

1. リクエストにユーザーの PII を含めてはいけません
2. リクエストには offering_id を含める必要があります
3. パーソナライズ結果のために context を含めてもかまいません（例: “mens size 14 near Cincinnati”）
4. 一致する商品を得るために include_products: true を設定してもかまいません
5. ブランドエージェントは可能であれば offering_token を返さなければなりません
6. ブランドエージェントは有効期限を示す ttl_seconds を返すことが望まれます

​

Offering Token Flow

1. 後続の si_initiate_session リクエストにこのトークンを含めることが望まれます
2. ブランドエージェントはトークンを使って照会とセッションを関連付けることができます
3. ホストはトークンを不透明な値として扱わなければなりません

{
  "offering_token": "offering_abc123xyz"
}

​

Matching Products

{
  "available": true,
  "offering_token": "offering_abc123xyz",
  "offering": {
    "title": "Nike Summer Sale",
    "summary": "Up to 50% off summer collection",
    "price_hint": "from $89"
  },
  "matching_products": [
    {
      "product_id": "nike-air-max-90",
      "name": "Nike Air Max 90",
      "price": "$129",
      "availability_summary": "Size 14 in stock"
    }
  ],
  "total_matching": 12
}

​

Session Lifecycle

​

Session States

​

Initiate Session

​

Request Requirements

• context - ユーザー意図の自然言語説明
• identity - 同意状態を含むユーザーのアイデンティティ

• supported_capabilities - ネゴシエーション用のホスト側機能セット
• offering_token - si_get_offering を実行した場合のトークン

• media_buy_id - 広告起点の場合の AdCP メディアバイ ID
• offering_id - 適用するブランド固有のオファー
• placement - セッションがトリガーされた場所

​

Response Requirements

• session_id - セッションの一意識別子

• response.message - 最初の会話メッセージ
• negotiated_capabilities - ブランドとホストの機能の交差集合

​

Send Message

​

Request Requirements

• session_id - アクティブなセッション ID

• message - ユーザーのテキストメッセージ
• action_response - UI アクションへの応答

​

Response Requirements

• session_id - セッション ID
• session_status - 現在のセッション状態（active、pending_handoff、complete）

• response.message - 会話の応答

• handoff - コマースフローへのハンドオフ設定

​

Terminate Session

​

Request Requirements

• session_id - 終了するセッション ID
• reason - 終了理由

​

Termination Reasons

​

Capability Negotiation

​

Negotiation Process

1. ブランドが SI マニフェストで機能を宣言する
2. ホストがセッション開始時にサポート機能を送る
3. ブランドがレスポンスでネゴシエート済み（交差）の機能を返す
4. セッションは交差した機能のみを使用する

​

Capability Categories

​

Modalities

​

Standard Components

​

Extension Components

​

UI Element Requirements

​

Standard Component Data

​

Action Handling

1. ホストは si_send_message を介して action_response を送信しなければなりません
2. action_response には action 識別子を含めなければなりません
3. payload が提供されている場合、action_response に含めることが望まれます

​

Integration Actions

{
  "type": "integration_actions",
  "data": {
    "actions": [
      { "type": "mcp", "label": "Add as MCP Tool", "highlighted": true },
      { "type": "a2a", "label": "Connect via A2A" }
    ]
  }
}

​

Identity and Privacy

​

Consent Requirements

1. 共有するデータを明示する
2. ブランドのプライバシーポリシーを参照させる
3. ユーザーに拒否する選択肢を提供する

​

Identity Object

• consent_granted: true
• consent_timestamp - 同意を取得した時刻
• consent_scope - 同意したデータ種別の配列
• privacy_policy_acknowledged.brand_policy_url

• email
• name
• locale
• shipping_address

​

Anonymous Sessions

• identity.consent_granted は必ず false
• identity.anonymous_session_id を提供することが望まれます
• PII を送信してはなりません

​

Commerce Integration

​

ACP Handoff

1. ホストは ACP のチェックアウトフローを開始することが望まれます
2. handoff.intent には購入意図を記述しなければなりません
3. handoff.context_for_checkout には会話コンテキストを含めてもかまいません

​

Commerce Actions

​

Error Handling

​

Error Response

{
  "errors": [
    {
      "code": "session_not_found",
      "message": "セッションが期限切れ、または存在しません"
    }
  ]
}

​

Error Codes

​

Security Considerations

​

Transport Security

​

Token Security

• Availability トークンは不透明かつ予測不能でなければなりません
• セッション ID は一意で予測不能でなければなりません
• トークンは妥当な期間内に期限切れにすることが望まれます

​

Data Minimization

• 同意なしにホストは PII を送信してはなりません
• ブランドエージェントはデータ収集を最小限にすることが望まれます
• セッション終了後はセッションデータを削除することが望まれます

​

Conformance

​

Host Conformance

1. MCP トランスポートをサポートする
2. すべてのスタンダードコンポーネントを描画する
3. セッションライフサイクル（開始、送信、終了）を実装する
4. アイデンティティ共有前に同意を取得する
5. 機能ネゴシエーションをサポートする

​

Brand Agent Conformance

1. SI マニフェストを公開する
2. 指定されたトランスポートの少なくとも 1 つをサポートする
3. 会話モダリティをサポートする
4. 有効なセッション ID を返す
5. すべての終了理由を処理する

​

Version History