---
url: "/ja/emailify/design/ai-designer.md"
description: "エージェントSkill、コピー＆ペーストのLLMワークフロー、または接続したAIプロバイダーを使って、ブランドに沿ったEmailifyテンプレートを作成します。"
---

# AI Designerでメールを作成する

> エージェントSkill、コピー＆ペーストのLLMワークフロー、または接続したAIプロバイダーを使って、ブランドに沿ったEmailifyテンプレートを作成します。

**AI Designer**タブは、EmailifyのコンポーネントライブラリをAIツールにつなぎます。結果の検証と、完成したFigmaテンプレートの作成は引き続きEmailifyが担当します。作業方法に応じて、**Agent (Skill)**、**Copy & Paste Prompt**、**LLM Provider API**のいずれかを選んでください。

> **Note:** AI Designerは現在ベータ版で、積極的に改善を続けています。お客様からのフィードバックをもとに使い勝手を改良していく中で、インターフェース、ダウンロードするSkill、エージェントへの指示、プロンプト、検証、ワークフローの手順が変わる場合があります。

繰り返し使う場合や、ブランドの大規模なライブラリを使う場合は、**Agent (Skill)** をデフォルトとしておすすめします。Skillには、コンポーネントカタログ、編集可能なスロットの参照、ブランドプロファイル、コピーポリシー、レスポンススキーマ、バリデーターがまとめて含まれています。コンパクトなインデックスを使い、必要なときだけ詳細なコンポーネントファイルを開くため、すべてのブリーフにカタログ全体が含まれることはありません。

> **Warning:** Agent (Skill)とCopy & Paste Promptでは、プラグイン内からブリーフやコンポーネントライブラリがAIモデルに送信されることはありません。LLM Provider APIでは、生成されたリクエストが、お客様自身のAPIキーを使って選択したAIプロバイダーに送信されます。

## 仕組み {#how-it-works}

1. FigmaでEmailifyを開きます。
2. メール選択欄の横にある **+** アイコンをクリックして、**New Email**モーダルを開きます。
3. **AI Designer**を選択します。
4. 3つのワークフロータブから1つを選びます。
   - **Agent (Skill):** 再利用できるSkillをダウンロードし、CodexまたはClaude Codeに読み込ませてから、エージェントにブリーフを渡します。
   - **Copy & Paste Prompt:** ブリーフを追加し、生成されたプロンプトを対応する任意のLLMにコピーして、返ってきたJSONをEmailifyに貼り付けます。
   - **LLM Provider API:** ブリーフを追加し、お客様自身のAPIキーを使ってChatGPT、Claude、GeminiでJSONを直接生成します。
5. 最後のステップで、生成されたJSONを確認するかインポートします。
6. レスポンスが有効であれば、**Create Email**をクリックします。複数のメールを含むレスポンスの場合は**Create 2 Emails**（以下同様）をクリックします。

Emailifyは、挿入前にレスポンスを検証し、Figmaに新しいEmailifyフレームを作成して、選択されたコンポーネントのインスタンスを返された順序で挿入します。さらに、対応しているテキスト、リンク、画像、代替テキスト、非表示レイヤーの上書きを適用します。ブランドのコンポーネントは、内容が更新されたあとも、リンクされたインスタンスのまま保たれます。

## ワークフローを選ぶ {#choose-a-workflow}

### Agent (Skill) {#agent-skill}

同じブランドのコンポーネントライブラリから定期的にメールを生成する場合、カタログが大規模な場合、またはエージェントにファイルを返す前にローカルで検証させたい場合は、**Agent (Skill)** を使います。カタログは一度インストールすれば段階的に参照されるため、繰り返しの作業でもっともトークン効率の高いモードです。

### Copy & Paste Prompt {#copy-paste-prompt}

ChatGPT、Claude、Gemini、またはその他の高性能なLLMで手早く手動のワークフローを進めたい場合は、**Copy & Paste Prompt**を使います。

1. ブリーフを**Add Email Brief**に貼り付けます。
2. **Copy Prompt**をクリックします。
3. プロンプトをLLMに貼り付け、指定したJSONだけを返すよう依頼します。
4. レスポンスを**Paste LLM Result**に貼り付けるか、インポートします。
5. 検証に通ったら**Create Email**をクリックします。

複数のメールを含むブリーフの場合、Emailifyはコピーするプロンプトを一度に1通のメールに絞ります。ボタンには現在のメール番号が表示されるため、各レスポンスが欠けることなく、モデルの出力上限内に収まります。

### LLM Provider API {#llm-provider-api}

アプリ間でコピーせずに、プロンプトの生成とJSONの生成をEmailifyに任せたい場合は、**LLM Provider API**を使います。

1. ブリーフを**Add Email Brief**に貼り付けます。
2. ChatGPT、Claude、Geminiのいずれかを選択します。
3. AI DesignerでまだAPIキーを設定していない場合は、プロバイダーのAPIキーを追加します。
4. **Generate 1 Email Draft**をクリックします。数字はブリーフ内のメールの数に合わせて変わります（例：**Generate 3 Email Drafts**）。
5. 生成されたJSONを確認し、検証に通ったら**Create Email**をクリックします。

APIキーの入力欄はデフォルトで表示されます。キーを保存すると、Emailifyはそれを伏せ字の読み取り専用パスワード欄として表示します。キーを置き換えるには、鉛筆の**Edit**ボタンをクリックします。APIキーはFigmaユーザーごとにお使いのデバイスに保存され、Figmaファイルには書き込まれません。複数のメールを含むブリーフは、プロバイダーへの個別のリクエストとして生成され、途中で切れたレスポンスを減らすため、1つの検証済みの結果にまとめられます。

Emailifyは、生成された各結果を検証してから**Create Email**を有効にします。プロバイダーが有効なJSONを返しても、コンポーネントや編集可能なスロットの参照が正しくない場合、Emailifyはカタログを踏まえた修正リクエストを同じプロバイダーに1回だけ自動的に送信します。生成と自動修正の処理中は、New Emailモーダルは操作できません。修正された結果が検証に通ると、追加の操作なしで**Create Email**が使えるようになります。

自動修正でレスポンスを解決できない場合、Emailifyは生成されたJSONを保持したまま、残っている検証エラーを表示し、再試行できるように**Repair**を表示します。自動修正でプロバイダーのAPIリクエストが追加で使われるのは、最初の結果に処理を妨げる検証エラーがある場合だけです。

> **Note:** APIの利用料金は、選択したプロバイダーから請求されます。Emailifyがモデルの利用料金を上乗せすることはありません。

## Agent (Skill)のワークフロー {#agent-skill-workflow}

### ステップ1：Skillをダウンロードする {#step-1-download-skill}

AI Designerは、現在のFigmaファイルにあるEmailifyコンポーネントを、Skillのメインのカタログとして自動的に使用します。これには、ファイル内ですでに使われているローカルコンポーネントとデザインシステムのコンポーネントインスタンスが含まれるため、ソースを選択する手順は別途ありません。

現在のファイルにEmailifyコンポーネントが1つもない場合、AI Designerは代わりに**Default Emailify Presets**を自動的に使用します。ブランドのFigmaコンポーネントがある場合はEmailifyのプリセットは代替として含まれず、生成されるメールは厳密にブランドに沿ったモードになります。

ステップ1の操作は、あえて**Download Skill**の1つだけにしています。現在のコンポーネントライブラリが変わったときや、**Copy Instructions**が無効になったときは、もう一度ダウンロードし、インストール済みの古いSkillを新しいパッケージに置き換えてください。

> **Note:** もっともブランドに沿った結果を得るには、Skillをダウンロードする前に、再利用するヘッダー、フッター、ヒーローの行、CTAの行、免責事項、商品の行、コンテンツブロックを同じFigmaファイルにまとめておいてください。

### 固定コンテンツや法的なコンテンツを保護する {#protect-fixed-and-legal-content}

エージェントに固定の文面を変更させないようにするには、Figmaでそのレイヤーまたは親グループをロックします。レイヤー名やグループ名の先頭に`🔒`を付けることもできます（例：`🔒 Legal`）。

AI Designerは、これらのレイヤーを保護されたスロットとしてエクスポートします。ダウンロードしたSkillは、それらを上書きしたり非表示にしたりしないようエージェントに指示し、そのバリデーターは変更の試みをすべて拒否します。Emailifyもインポート時に元のコンポーネントの内容を変更しません。承認済みの法的なテキスト、免責事項、フッターの詳細、コンプライアンス関連の文面など、固定しておく必要のあるコンテンツに使ってください。

### Figma MCPで直接作成する {#build-directly-with-figma-mcp}

Figmaの書き込みツールが使える場合、ダウンロードしたSkillは、Emailifyコンポーネントを元のメインコンポーネントにリンクしたまま、Figmaで直接メールを組み立てたり更新したりできます。プラグインがその結果を取り込めるようにするには、エージェントがEmailifyのフレーム、インスタンス、件名・プリヘッダーのメタデータの規則に正確に従う必要があります。

エージェントへの正式な指示、命名規則、編集時の安全対策、トラブルシューティングの手順については、[Figma MCPでEmailifyを使う](/ja/emailify/design/figma-mcp)をご覧ください。Figmaに直接書き込めない場合は、検証済みのJSONをインポートするワークフローを引き続き使えます。

### ステップ2：エージェントで生成する {#step-2-generate-with-your-agent}

ステップ1でダウンロードしたEmailify Skillは、すぐにインストールできる`emailify-ai-designer`フォルダを1つ含む、バージョン付きのZIPです。一意のファイル名には、Skillのバージョン、ミリ秒単位のUTCエクスポート時刻、カタログのフィンガープリント、設定のフィンガープリントが含まれます（例：`emailify-ai-designer-v11-20260722T130512123Z-a1-5bixn7-k11-abc123.zip`）。

- `SKILL.md`：再利用できるエージェントのワークフローと出力ルール。
- `INSTALL.md`：CodexとClaude Codeのセットアップ先のパスと、エージェントへの一括指示。
- `manifest.json`：正確なパッケージのファイル名、Skillのバージョン、エクスポート時刻、カタログのフィンガープリント、設定のフィンガープリント、ソース、代替の状態、有効なプロファイル。
- `profile.json`：コピーポリシー、必須のロール、承認済みのリンク、チームへの指示。
- `catalog-index.json`：コンポーネントを探すためのコンパクトなインデックス。
- `previews/*.jpg`：正常にエクスポートされた各コンポーネントの1倍のビジュアル参照。
- `components/*.json`：保護されたスロットを含む、正確なコンポーネントとスロットの参照をまとめたロール別のファイル。
- `plan-schema.json`と`scripts/validate-plan.js`：文面を割り当てる前にコンポーネントのプランを検証するためのもの。
- `response-schema.json`：スキーマで制約された生成のためのもの。
- `scripts/search-components.js`と`scripts/inspect-component.js`：ライブラリ全体をコンテキストに読み込まずに、トークン効率よくカタログを探すためのもの。
- `scripts/create-response-skeleton.js`：検証済みのプランから、正確なJSONの外枠と上書きの配列を作成するためのもの。
- `scripts/validate-response.js`：エージェントがファイルを返す前に実行するローカルのバリデーター。
- `scripts/self-test.js`と`integrity.json`：パッケージのファイル、カタログの参照、プレビュー、SHA-256ハッシュを確認するためのもの。
- `data-inventory.json`：パッケージの内容を示し、ブリーフ、生成されたメールの文面、APIキー、Figmaのアクセストークンが含まれていないことを確認するもの。
- `agents/openai.yaml`：現在のCodex Skillのメタデータ。
- `integration-contract.json`：Figmaに直接書き込むMCPのフレーム規則と、その正式なドキュメントのURLを含む、小さな操作マップ。

このSkillは、決定的な段階的読み込みを使います。エージェントは、同梱のスクリプトでコンパクトなインデックスを検索し、候補に絞ったコンポーネントとその`previewFile`の画像だけを確認して、コンパクトなコンポーネントのプランを検証し、レスポンスの骨組みを作成して、正確なスロットの参照を埋め、完成したレスポンスを検証します。カタログ全体をモデルのコンテキストに入れる必要はありません。

### Skillをインストールする {#install-the-skill}

最新のパッケージをダウンロードしたら、**Copy Instructions**をクリックします。ボタンが**Instructions Copied**に変わり、Emailifyが次の操作を案内します。コピーした指示を、CodexまたはClaude Codeの新しいタスクに貼り付けてください。この指示には、ダウンロードしたZIPの正確な名前が含まれており、プロジェクトのSkillをインストールまたは置き換えて、ファイル名、バージョン、エクスポート時刻、カタログのフィンガープリント、設定のフィンガープリントを確認します。いずれかの値が一致しない場合、エージェントは作業を止めて、新しくダウンロードし直すよう求めます。`emailify-ai-designer`の準備ができたことをエージェントが確認したら、次のメッセージでメールのブリーフを送ってください。

```text
Find the exact Emailify Skill ZIP named [filename copied by Emailify] in my Downloads folder; if it is not there, ask me where I saved it. Replace any existing project skill named emailify-email-assembler or emailify-ai-designer with the skill from that ZIP. Read its manifest.json and verify the exact package filename, Skill version, export time, catalog fingerprint, and configuration fingerprint supplied in this instruction. If any value does not match exactly, stop and ask me to download the current Skill again. Run the installed skill's scripts/self-test.js and stop if it reports an integrity or catalog error. Confirm the installed project-skill path and complete package identity, and that emailify-ai-designer is ready. Then use the emailify-ai-designer skill to turn my attached or pasted email brief into one validated .emailify-ai.json file per email. Preserve supplied copy, use only components from the installed catalog, and write the files locally instead of pasting JSON into chat. If this message does not include an email brief, ask me to attach or paste it before generating anything.
```

この一括指示により、現在のエージェントが対応しているプロジェクトSkillの保存場所を選び、そのままブリーフの作業に進めます。プロジェクトスコープにすることで、グローバルなSkillを置き換えることなく、Figmaファイルのブランドカタログとプロファイルを該当するワークスペースに結び付けておけます。

> **Note:** Skillバージョン11では、ガード付きのFigma直接書き込みMCPワークフローに件名とプリヘッダーの取り込みが追加されました。リンクされたインスタンスのチェック、保護されたスロットの適用、パッケージの正確な識別情報のチェックは引き続き行われます。以前のAI Designerベータ版でダウンロードしたパッケージは、このアップデート後は意図的に古いものとして扱われるため、新しいメールを生成する前に、最新のSkillを一度ダウンロードしてインストールしてください。

手動でインストールするには、ZIPを展開し、含まれている`emailify-ai-designer`フォルダを次のいずれかの場所に移動します。

- **Codexの個人用Skill：** `~/.agents/skills/emailify-ai-designer/`
- **CodexのプロジェクトSkill：** `.agents/skills/emailify-ai-designer/`
- **Claude Codeの個人用Skill：** `~/.claude/skills/emailify-ai-designer/`
- **Claude CodeのプロジェクトSkill：** `.claude/skills/emailify-ai-designer/`

フォルダ自体に、`SKILL.md`、`manifest.json`、`catalog-index.json`、`previews/`、`components/`、その他のダウンロードしたリソースが含まれている必要があります。インストール後にSkillがすぐに表示されない場合は、エージェントの新しいタスクを開始してください。

### エージェントにブリーフを渡す {#give-the-agent-your-brief}

可能であれば、キャンペーンの目的、対象者、ライフサイクルの段階、タイミング、件名、プリヘッダー、承認済みの文面、CTAの文言、リンク、画像のURL、代替テキスト、ブランドのガイドライン、法的な要件、メール配信プラットフォームの要件、差し込みタグ、希望するモジュールの順序を含めてください。

Skillは、検証済みの`.emailify-ai.json`ファイルを作業ディレクトリに書き出します。大規模なキャンペーンでは、チャットに不完全なJSONや途中で切れたJSONを出力するのではなく、メールごとに完全なファイルを1つずつ作成します。

Figmaのコンポーネントの説明に、`AI role: hero`、`AI intent: product launch`、`AI usage: use when an image and CTA are required`、`AI notes: preserve the secondary legal line`などの行を追加して、コンポーネントの照合をより明確にすることもできます。これらのヒントは任意です。AI Designerは、名前、説明、編集可能なレイヤー、Emailifyのメタデータからも、コンポーネントのロールと収容量を推測します。

### ステップ3：エージェントの結果をインポートする {#step-3-import-agent-result}

生のJSONを貼り付けるか、生成された`.emailify-ai.json`ファイルを1つ以上レスポンス欄にドロップするか、**Choose File**をクリックします。Emailifyが結果全体を自動的に検証します。

結果全体が有効であれば、**Create Email**が使えるようになります。複数のメールを含む有効なレスポンスの場合、ボタンには作成されるメールの数が表示されます。一部でも無効な箇所があると作成は無効のままになり、**Copy Fix Prompt**でコンパクトな修正リクエストをコピーして、同じエージェントのタスクに貼り付けられます。修正リクエストは、コンポーネントカタログを繰り返す代わりに、エージェントがすでに読み込んでいるSkillを使います。

インストールしたSkillのフォルダ内から、同梱のバリデーターを手動で実行することもできます。

```sh
node scripts/validate-response.js /path/to/email.emailify-ai.json
```

最後にダウンロードしたSkillが、現在のコンポーネントカタログ、ソース、プロファイル、コピーポリシー、代替の設定、Skillパッケージのバージョンと一致しなくなると、Emailifyが警告を表示します。これらのいずれかが変わったときは、Skillをダウンロードし、インストール済みのものを置き換えてください。同じ**New Email**モーダル内で別のタブに切り替えても、作業中のAI Designerの結果はそのまま残ります。

カタログが最新かどうかの判定には、コンポーネント名、ロール、カテゴリ、説明、AIノート、収容量、編集可能なスロットと保護されたスロットのメタデータ、軽量のビジュアルシグネチャーが使われます。EmailifyがSkillを古いと表示したときは、ダウンロードしてインストールし直してください。変更のないプレビュー画像は、現在のプラグインセッション中は再利用されるため、パッケージを繰り返しダウンロードする際の時間が短くなります。

Emailify Skillのレスポンスはブリーフではなくカタログに結び付いているため、`requestFingerprint`は必要ありません。レスポンスには、`workflowMode: "external"`、有効な`contentPolicy`、メールごとの`unresolved`配列、すべてのテキストの上書きに対する`source: "provided"`または`source: "generated"`を指定する必要があります。

## ブリーフの例 {#example-brief}

```md
# Product Launch Email - Brief + Draft Copy

Audience: Trial users who created an account but have not exported an email.
Goal: Announce the new AI Designer beta and drive users to create a test template.
Tone: Practical, confident, helpful.

Subject: Build branded emails faster with AI Designer
Preheader: Turn approved Emailify components into ready-to-review templates.

Module order:
- Header: use the standard logo header.
- Hero: introduce AI Designer and the main value proposition.
- Content: explain that the workflow uses approved Emailify components first.
- CTA: button linking to https://www.hypermatic.com/emailify/
- Footer: keep the standard footer unchanged.

Hero copy:
Create on-brand emails from your approved components.

Body copy:
Brief your campaign in Codex or Claude Code, let the Emailify Skill create a validated JSON response, and import it into Figma using your reusable branded components.

CTA:
Try AI Designer

Compliance:
Do not invent claims, discounts, testimonials, or legal copy.
```

## レスポンスの検証と形式 {#response-validation-and-formats}

**JSON Response**欄には、AIツールから貼り付けた生のJSON、ドロップしたファイル、またはインポートした1つ以上の`.json`ファイルや`.emailify-ai.json`ファイルを入力できます。

AI Designerが受け付ける形式は次のとおりです。

- 1つのJSONオブジェクトとしての1通のメール下書き。
- `emails`配列に入った複数のメール下書き。
- `templates`配列に入った複数のメール下書き。

Emailify Skillのレスポンスは、ダウンロードしたカタログのフィンガープリントと照合されます。そのため、Skillのダウンロード後にコンポーネントライブラリが変わった場合、Emailifyは古いJSONをブロックできます。

**Create Email**を有効にする前に、Emailifyはコンポーネントの参照、編集可能なスロット、URL、承認済みのリンク、画像の代替テキスト、仮のコンテンツ、必須のロール、ヘッダー・フッターの配置、コピーポリシー、代替の使用状況を裏側でチェックします。

JSONが有効でない場合は、**Copy Fix Prompt**をクリックし、結果を生成したCodexまたはClaude Codeの同じタスクに貼り付けます。レスポンス欄の内容を、エージェントが修正したJSONに置き換えてください。

## JSONレスポンスの例 {#example-json-response}

```json
{
  "schemaVersion": 1,
  "workflowMode": "external",
  "contentPolicy": "preserve",
  "catalogFingerprint": "a1-example",
  "emails": [
    {
      "name": "AI Designer Launch",
      "subject": "Build branded emails faster with AI Designer",
      "preheader": "Turn approved Emailify components into ready-to-review templates.",
      "timing": "",
      "job": "Introduce the feature and drive a test template",
      "unresolved": [],
      "components": [
        {
          "role": "hero",
          "componentRef": "c-example",
          "overrides": {
            "text": [
              {
                "slotRef": "t-example-title",
                "value": "Create on-brand emails from your approved components",
                "source": "provided"
              },
              {
                "slotRef": "t-example-body",
                "value": "Brief your campaign in Codex or Claude Code, let the Emailify Skill create a validated JSON response, and import it into Figma using your reusable branded components.",
                "source": "provided"
              },
              {
                "slotRef": "t-example-button",
                "value": "Try AI Designer",
                "source": "provided"
              }
            ],
            "links": [
              {
                "slotRef": "l-example-button",
                "value": "https://www.hypermatic.com/emailify/"
              }
            ],
            "images": [],
            "hidden": []
          }
        }
      ]
    }
  ]
}
```

上記のコンポーネントとスロットの参照は説明用の例です。必ず、最新のEmailify Skillでエクスポートされた参照を使ってください。

## JSONのフィールド {#json-fields}

最上位のレスポンスには次のフィールドが含まれます。

- `schemaVersion`：AI Designerのレスポンス規約のバージョン。
- `workflowMode`：Emailify Skillのレスポンスでは`external`。
- `contentPolicy`：有効なプロファイルのポリシー。`preserve`、`light-edit`、`draft-missing`のいずれか。
- `catalogFingerprint`：Skillにエクスポートされた、検出済みのコンポーネントライブラリを識別します。
- `emails`：1通以上の完全なメール下書き。複数のメールを1通ずつ扱うプロンプトでは、1通のメールが含まれます。

各メール下書きには次のフィールドが含まれます。

- `name`：生成されるメールのFigmaフレーム名。
- `subject`：メールの件名。
- `preheader`：メールのプリヘッダーテキスト。
- `timing`：ブリーフに記載された送信タイミング（任意）。ない場合は空の文字列。
- `job`：ブリーフに記載された目的（任意）。ない場合は空の文字列。
- `unresolved`：挿入前に解決する必要がある、不足している文面、リンク、画像、主張、法的なコンテンツ。
- `components`：挿入するEmailifyコンポーネントの順序付きリスト。

各コンポーネントには次のフィールドが含まれます。

- `role`：`header`、`hero`、`content`、`cta`、`disclaimer`、`footer`などのシンプルなレイアウトのロール。
- `componentRef`：プロンプトにコピーされたコンパクトなコンポーネント参照。Emailifyがローカルで、正確なFigmaコンポーネントまたは組み込みのプリセットに解決します。
- `overrides.text`：`{slotRef, value, source}`形式のテキストの置き換えの配列。`source`は`provided`または`generated`です。
- `overrides.links`：プレーンな`http`または`https`のURLを使った`{slotRef, value}`形式のリンクの置き換えの配列。
- `overrides.images`：`{slotRef, url, alt, href}`形式の画像の置き換えの配列。
- `overrides.hidden`：コンポーネントに未使用の任意コンテンツや仮のコンテンツがある場合に、非表示にするスロットの参照。

正確な`componentId`、`componentName`、`presetKey`と、名前付きの上書きオブジェクトを使った以前のレスポンスも、互換性のために引き続き対応しています。

## ベストプラクティス {#best-practices}

- 特定のブランドモジュールを使いたい場合は、Emailifyコンポーネントライブラリの正確なコンポーネント名を使ってください。
- ブリーフに別の指定がない限り、ヘッダーのコンポーネントは最初に、フッターのコンポーネントは最後に配置してください。
- キャンペーンで力強い導入のメッセージが必要な場合は、上部にヒーローまたはフィーチャーのコンポーネントを使ってください。
- ブリーフで複数のCTAが明示的に求められていない限り、1通のメールにつき明確なCTAを1つにしてください。
- Markdown形式のリンクではなく、プレーンな絶対URLを使ってください。
- すべての画像URLに、役立つ代替テキストを含めてください。
- 法的な文面、コンプライアンス、割引、タイミング、差し込みタグ、免責事項の文面は、必要な箇所でそのまま正確に保持してください。
- 複数のメールからなるキャンペーンでは、メールごとに明確な見出しを付けてください。Skillはメールごとに完全なレスポンスファイルを1つずつ書き出します。
- メール配信プラットフォームにエクスポートする前に、生成されたFigmaテンプレートを確認してください。

## トラブルシューティング {#troubleshooting}

- Emailifyに**The JSON could not be parsed**と表示された場合は、Markdownのコードフェンス、コメント、末尾のカンマ、JSONの前後にあるテキストを削除してください。
- コンポーネントが一致しない場合は、最新のSkillをダウンロードしてインストールし直し、エージェントがエクスポートされた`componentRef`と`slotRef`の値だけを使っていることを確認してください。
- 仮のコンテンツが表示されたままの場合は、未使用のレイヤー名またはスロット名を`overrides.hidden`に追加するか、よりシンプルなコンポーネントを選んでください。
- 出力がありきたりに感じられる場合は、Skillをダウンロードする前に、ブランドのEmailifyコンポーネントが現在のファイルにあることを確認してください。ブランドのコンポーネントがある場合、プリセットの代替は自動的に無効になります。
- Emailifyにコンポーネントライブラリが変更されたと表示された場合は、最新のSkillをダウンロードしてインストールし直し、新しいフィンガープリントに対してJSONを再生成してください。
- コピーした指示に記載された正確なZIPをエージェントが見つけられない場合は、別のダウンロードや古いダウンロードを選ばせるのではなく、そのファイルを保存した場所をエージェントに伝えてください。
- 再利用するAIワークフローでトークンを使いすぎている場合は、`catalog-index.json`やすべてのロールファイルをコンテキストに読み込むのではなく、`scripts/search-components.js`と`scripts/inspect-component.js`を実行していることを確認してください。
- ダウンロードしたパッケージが不完全または改変されているように見える場合は、インストールしたSkillのフォルダから`node scripts/self-test.js`を実行し、整合性チェックで失敗があれば新しいSkillをダウンロードしてください。
- プリフライトで、preserveポリシーの下で生成された文面が報告された場合は、テキストのソースを変更するか、不足している文面を用意するか、下書きを許可するプロファイルを使ってください。
- 複数のメールからなる大規模なキャンペーンでは、メールごとに完全な`.emailify-ai.json`ファイルを1つずつ書き出すようエージェントに依頼し、ブリーフでは`Email 1 - Welcome`、`Email 2 - Follow-up`、`Email 3 - Offer`のような見出しを使ってください。
