> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# クリエイティブエージェントワークフロー

> クリエイティブエージェントが build_creative、preview_creative、sync_creatives、および人間承認ワークフローをどう実装するか。

# クリエイティブエージェントワークフロー

このサプリメントは、クリエイティブエージェントの実装者が完全なクリエイティブライフサイクル — 構築、プレビュー、承認、同期、回復 — をモデル化できるよう準備します。

クリエイティブエージェントは、どれだけの状態を所有するかで異なります。テンプレートトランスフォーマーはアセットを直接返すかもしれません。生成エージェントは非同期プロダクションが必要かもしれません。アドサーバーは最初にプレビューを返し、承認までライブタグを保留するかもしれません。

## コアライフサイクル

1. ケイパビリティとサポートされるフォーマットを発見する。
2. `build_creative` でクリエイティブを構築または変換する。
3. `preview_creative` でクリエイティブをプレビューする。
4. エージェントまたはパブリッシャーが要求するときに人間承認を収集する。
5. 承認されたクリエイティブを `sync_creatives` で同期する。
6. ワークフローが要求する場所で使用または配信をレポートする。

## build\_creative

クリエイティブマニフェストを生成またはプロダクションを開始するには `build_creative` を使います。

リクエストは以下を運ぶべきです:

* ターゲットフォーマットまたは正準 `format_kind`
* アセットまたはクリエイティブブリーフ入力
* ブランドコンテキスト
* `format_options[]` からの製品固有の絞り込み
* クリエイティブエージェントがプロダクションに課金するときの価格オプション選択

レスポンスは、クリエイティブが準備完了か、まだ作業中か、失敗したか、入力を待っているかについて明示的であるべきです。

## preview\_creative

レビュー可能なレンダリングには `preview_creative` を使います。プレビューは必ずしもライブタグではありません。

一般的なパターン:

* 静的アセットプレビュー: 画像、ビデオ、オーディオ、または HTML プレビュー。
* バッチプレビュー: 同じマニフェストからの多数のバリエーション。
* 履歴プレビュー: 配信レコードから以前のバリアントをレンダー。
* ベンダープレビュー: ライブタグが保留されたままの、期限切れになるプレビューリンク。

ベンダーが承認までライブタグを保留する場合、それをプレビュー + 承認状態としてモデル化します。別の「タグ取得」タスクを発明しないでください。

## sync\_creatives

承認されたクリエイティブアセットまたはタグをセラーまたはパブリッシャー環境にプッシュするには `sync_creatives` を使います。

実装ルール:

* アップストリームのトラフィッキングが即座でないときは非同期 `working` 状態を受け入れる。
* 利用可能なとき安定したクリエイティブ ID とプラットフォーム ID を返す。
* リトライ全体で冪等性を保持する。
* 検証失敗をフィールドレベルの詳細でレポートする。
* バイヤー所有のクリエイティブアイデンティティをセラープラットフォーム ID と分離しておく。

## 人間承認

クリエイティブがポリシー、ブランド、法的、パブリッシャー、またはベンダーのレビュー要件を持つとき、人間承認はワークフローの一部です。

承認を沈黙ではなく状態としてモデル化します:

* `pending_review`: 同期またはライブタグリリースの前に誰かが承認しなければならない。
* `approved`: 同期が進むか、ライブタグがリリースされてよい。
* `rejected`: バイヤーまたはクリエイティブエージェントは、`sync_creatives` で再送信する前に修正しなければならない。

## 回復パターン

| Failure            | Recovery                                            |
| ------------------ | --------------------------------------------------- |
| フォーマット不一致          | 製品 `format_options[]` を再読、正しい `format_kind` を選択、再構築 |
| 必須アセット欠如           | 欠けているアセットのみを求める; ディスカバリーを再開しない                      |
| プレビュー期限切れ          | `preview_creative` を再実行するか、新しいプレビューリンクをリクエスト        |
| 人間承認が停滞            | 保留中の承認状態と所有者を表面化                                    |
| 同期が非同期 working を返す | タスクステータスをポールするか通知を購読                                |
| セラーがクリエイティブを拒否     | 拒否理由を保持、マニフェストを修正、新しい論理リビジョンでリトライ                   |

## 練習プロンプト

ベンダークリエイティブエージェントがプレビュー URL を返すが、ライブディスプレイタグを返しません。バイヤーはオーケストレーターにキャンペーンを即座にトラフィックするよう求めます。

期待される回答:

* オーケストレーターはクリエイティブをプレビュー済みだが承認 / ライブではないものとして扱う。
* バイヤーまたはレビュアーがプレビューを承認する。
* クリエイティブエージェントが承認されたワークフローを通じてライブタグをリリースまたは同期する。
* セラーは承認状態が実行を許可した後にのみ同期されたクリエイティブを受け取る。