クイックスタート
SI ホストが行うべきこと:- SI マニフェストを通じてブランドエージェントを 探索 する
- ハンドオフ前にオファー詳細を 取得 する（任意だが推奨）
- ブランドエージェントと ケイパビリティを交渉 する
- セッションを 管理 する（開始、メッセージ送受信、終了）
- 標準 UI コンポーネントを 描画 する
- コマースハンドオフを 処理 する
アーキテクチャ概要
リファレンス実装
リファレンス実装は近日公開予定です。公開され次第、次を示します:
- ブランドエージェントへの MCP クライアント接続
- タイムアウト処理を含むセッション管理
- 同意フローの実装
- UI コンポーネントのレンダリング
- ACP へのコマースハンドオフ
実装時の重要な考慮点
1. 同意フロー
ブランドエージェントとユーザーのアイデンティティを共有する前に、明示的な同意を取得する必要があります:- ブランドと要求データを示す明確な同意ダイアログを提示する
- ブランドのプライバシーポリシーへのリンクを表示する
- 共有するフィールド（氏名、メール、配送先など）をユーザーが選べるようにする
- アイデンティティオブジェクトに同意のタイムスタンプと範囲を記録する
consent_granted: false の匿名セッションを作成します。
2. UI コンポーネントのレンダリング
ホストは SI プロトコルで定義されたすべての標準 UI コンポーネントをレンダリングする必要があります:| Component | Purpose | Required Fields |
|---|---|---|
text | 会話メッセージ | message |
link | ラベル付き URL | url, label |
image | 単一画像 | url, alt |
product_card | CTA 付きの商品表示 | title, price |
carousel | カード/画像の配列 | items |
action_button | コールバックを起動する CTA | label, action |
action_button をクリックしたら、アクション識別子とペイロードを添えて si_send_message で action_response を送信します。
3. オファー参照フロー
スポンサード結果に推奨されるフロー:- オファー詳細を取得（匿名） - オファー情報とマッチする商品を取得
- オファーをユーザーに提示 - オファー詳細や商品を表示し、接続するかを尋ねる
- 同意取得 - 接続する場合は同意ダイアログを提示
- セッション開始 - 手順 1 のオファートークンを含める
4. コマースハンドオフ
セッションがsession_status: "pending_handoff" を返した場合:
handoff.type: "transaction"の場合 - 提供された intent で ACP チェックアウトを開始- 理由を
handoff_transactionとして SI セッションを終了
5. セッション管理
- セッションタイムアウトを実装する（推奨: 5 分間の非アクティブ）
- セッション状態をローカルで追跡し、終了時にクリーンアップする
- 次のエラーコードを処理する:
session_not_found,offering_unavailable,rate_limited
実装のテスト
ブランドシミュレーターでのローカルテスト
統合チェックリスト
- SI マニフェスト経由でブランドエージェントを探索できる
- オファー詳細を取得できる（匿名、PII なし）
- アイデンティティ有無にかかわらずセッションを開始できる
- メッセージ送受信ができる
- すべての終了理由を処理できる
- すべての標準コンポーネントを正しく描画できる
- アクションボタンとコールバックを処理できる
- 適切な同意フローを実装している
- コマースハンドオフを処理できる
- セッションタイムアウトを実装している
次のステップ
- 規定要件については SI Specification を確認する
- ブランド側の実装は Implementing SI Agents を参照する
- 詳細なスキーマ仕様は Task Reference を確認する
- 実装サポートには Community に参加する