AI Designer 탭은 Emailify 컴포넌트 라이브러리를 AI 도구와 연결해 줘요. 결과를 검증하고 완성된 Figma 템플릿을 만드는 일은 계속 Emailify가 맡아요. 작업 방식에 따라 Agent (Skill), Copy & Paste Prompt, LLM Provider API 중 하나를 고르세요.
AI Designer는 현재 베타 버전이며 계속 개선되고 있어요. 고객 피드백을 바탕으로 경험을 다듬으면서 인터페이스, 다운로드하는 Skill, 에이전트 지침, 프롬프트, 검증, 워크플로 단계가 바뀔 수 있어요.
반복 사용과 대규모 브랜드 라이브러리에는 Agent (Skill) 방식을 기본으로 권장해요. Skill에는 컴포넌트 카탈로그, 편집 가능한 슬롯 참조, 브랜드 프로필, 문구 정책, 응답 스키마, 검증기가 함께 들어 있어요. 간결한 인덱스를 사용하고 필요할 때만 상세 컴포넌트 파일을 열기 때문에, 브리프마다 전체 카탈로그를 함께 넣지 않아도 돼요.
Agent (Skill)과 Copy & Paste Prompt는 플러그인 안에서 브리프나 컴포넌트 라이브러리를 AI 모델로 보내지 않아요. LLM Provider API는 직접 선택한 AI 제공업체로 생성된 요청을 사용자 본인의 API 키를 사용해 보내요.
작동 방식
- Figma에서 Emailify를 여세요.
- 이메일 선택기 옆의 + 아이콘을 클릭해 New Email 모달을 여세요.
- AI Designer를 선택하세요.
- 세 가지 워크플로 탭 중 하나를 고르세요.
- Agent (Skill): 재사용할 수 있는 Skill을 다운로드해 Codex나 Claude Code에 불러온 다음, 에이전트에게 브리프를 전달하세요.
- Copy & Paste Prompt: 브리프를 추가하고, 생성된 프롬프트를 지원되는 LLM에 복사해 넣은 다음, LLM이 돌려준 JSON 응답을 Emailify에 다시 붙여 넣으세요.
- LLM Provider API: 브리프를 추가하고 본인의 API 키로 ChatGPT, Claude, Gemini를 통해 JSON을 바로 생성하세요.
- 마지막 단계에서 생성된 JSON을 검토하거나 가져오세요.
- 응답이 유효하면 Create Email을 클릭하세요. 이메일이 여러 개인 응답이라면 Create 2 Emails 등을 클릭하세요.
Emailify는 삽입하기 전에 응답을 검증하고, Figma에 새 Emailify 프레임을 만들고, 선택된 컴포넌트 인스턴스를 응답에 담긴 순서대로 삽입한 뒤, 지원되는 텍스트, 링크, 이미지, 대체 텍스트, 숨김 레이어 재정의를 적용해요. 브랜드 컴포넌트는 콘텐츠가 업데이트된 뒤에도 연결된 인스턴스로 유지돼요.
워크플로 고르기
Agent (Skill)
같은 브랜드 컴포넌트 라이브러리로 이메일을 자주 생성하거나, 카탈로그가 크거나, 에이전트가 파일을 돌려주기 전에 로컬에서 검증하게 하고 싶다면 Agent (Skill) 방식을 사용하세요. 카탈로그를 한 번만 설치하고 필요한 부분만 차례로 살펴보기 때문에 반복 작업에서 토큰을 가장 효율적으로 쓰는 방식이에요.
Copy & Paste Prompt
ChatGPT, Claude, Gemini 또는 다른 성능 좋은 LLM으로 빠르게 수동 작업을 하고 싶다면 Copy & Paste Prompt를 사용하세요.
- Add Email Brief에 브리프를 붙여 넣으세요.
- Copy Prompt를 클릭하세요.
- LLM에 프롬프트를 붙여 넣고 요청한 JSON만 돌려 달라고 하세요.
- Paste LLM Result에 응답을 붙여 넣거나 가져오세요.
- 검증을 통과하면 Create Email을 클릭하세요.
이메일이 여러 개인 브리프라면 Emailify는 복사되는 프롬프트를 한 번에 이메일 하나에 집중시켜요. 버튼에 현재 이메일 번호가 표시되므로, 각 응답이 빠짐없이 완성되고 모델의 출력 한도 안에 들어가요.
LLM Provider API
앱 사이를 오가며 복사하지 않고 Emailify가 프롬프트 생성과 JSON 생성을 처리하게 하고 싶다면 LLM Provider API를 사용하세요.
- Add Email Brief에 브리프를 붙여 넣으세요.
- ChatGPT, Claude, Gemini 중 하나를 선택하세요.
- AI Designer에 아직 설정하지 않았다면 제공업체 API 키를 추가하세요.
- Generate 1 Email Draft를 클릭하세요. 숫자는 브리프에 있는 이메일 수에 맞춰져요. 예: Generate 3 Email Drafts
- 생성된 JSON을 검토하고, 검증을 통과하면 Create Email을 클릭하세요.
API 키 필드는 기본으로 표시돼요. 키를 저장하면 Emailify는 키를 가려진 읽기 전용 비밀번호 필드로 표시해요. 키를 바꾸려면 연필 모양 Edit 버튼을 클릭하세요. API 키는 기기에 Figma 사용자별로 저장되고 Figma 파일에는 기록되지 않아요. 이메일이 여러 개인 브리프는 제공업체에 별도의 요청으로 생성된 뒤 검증된 결과 하나로 합쳐져서, 응답이 잘리는 일을 줄여 줘요.
Emailify는 Create Email을 활성화하기 전에 생성된 결과를 하나하나 검증해요. 제공업체가 유효한 JSON을 돌려줬지만 컴포넌트나 편집 가능한 슬롯 참조가 잘못되어 있다면, Emailify가 카탈로그를 반영한 수정 요청을 같은 제공업체에 자동으로 한 번 보내요. 생성과 자동 수정이 진행되는 동안에는 New Email 모달이 비활성화돼요. 수정된 결과가 검증을 통과하면 따로 조작하지 않아도 Create Email을 사용할 수 있게 돼요.
자동 수정으로도 응답을 해결하지 못하면 Emailify는 생성된 JSON을 그대로 두고 남은 검증 문제를 표시하며, 다시 시도할 수 있도록 Repair를 보여 줘요. 자동 수정은 처음 결과에 생성을 막는 검증 오류가 있을 때만 제공업체 API 요청을 한 번 더 사용해요.
API 사용료는 선택한 제공업체가 청구해요. Emailify는 모델 사용료를 따로 추가하지 않아요.
Agent (Skill) 워크플로
1단계: Skill 다운로드
AI Designer는 현재 Figma 파일에 있는 Emailify 컴포넌트를 Skill의 기본 카탈로그로 자동으로 사용해요. 여기에는 로컬 컴포넌트와 파일에서 이미 사용 중인 디자인 시스템 컴포넌트 인스턴스가 포함되므로, 소스를 따로 선택하는 단계가 없어요.
현재 파일에 Emailify 컴포넌트가 하나도 없다면 AI Designer는 대신 Default Emailify Presets를 자동으로 사용해요. 브랜드 Figma 컴포넌트가 있을 때는 Emailify 프리셋을 대체 수단으로 포함하지 않아, 생성되는 이메일이 엄격한 브랜드 모드로 유지돼요.
1단계에는 의도적으로 Download Skill 동작 하나만 있어요. 현재 컴포넌트 라이브러리가 바뀌거나 Copy Instructions가 비활성화되면 Skill을 다시 다운로드하고, 이전에 설치한 Skill을 새 패키지로 바꾸세요.
브랜드에 가장 잘 맞는 결과를 얻으려면 Skill을 다운로드하기 전에 재사용할 헤더, 푸터, 히어로 Row, CTA Row, 고지 문구, 상품 Row, 콘텐츠 블록을 같은 Figma 파일에 두세요.
고정 콘텐츠와 법적 콘텐츠 보호
에이전트가 고정 문구를 바꾸지 못하게 하려면 Figma에서 해당 레이어나 상위 그룹을 잠그세요. 레이어나 그룹 이름 앞에 🔒를 붙여도 돼요(예: 🔒 Legal).
AI Designer는 이런 레이어를 보호된 슬롯으로 내보내요. 다운로드한 Skill은 에이전트에게 이 슬롯을 재정의하거나 숨기지 말라고 지시하고, Skill의 검증기는 변경 시도를 모두 거부하며, Emailify는 가져오는 동안 원래 컴포넌트 콘텐츠를 바꾸지 않아요. 승인된 법적 문구, 고지 문구, 푸터 세부 정보, 규정 준수 문구처럼 고정되어야 하는 콘텐츠에 사용하세요.
Figma MCP로 바로 만들기
Figma 쓰기 도구를 사용할 수 있다면, 다운로드한 Skill이 Emailify 컴포넌트를 원래 메인 컴포넌트에 연결된 상태로 유지하면서 Figma에서 이메일을 바로 조립하거나 업데이트할 수 있어요. 플러그인이 결과를 받아들이려면 에이전트가 Emailify의 프레임, 인스턴스, 제목/프리헤더 메타데이터 규칙을 정확히 따라야 해요.
기준이 되는 에이전트 지침, 이름 지정 규칙, 편집 안전장치, 문제 해결 단계는 Figma MCP와 함께 Emailify 사용하기를 참고하세요. Figma에 바로 쓸 수 없을 때는 검증된 JSON 가져오기 워크플로를 계속 사용할 수 있어요.
2단계: 에이전트로 생성하기
1단계에서 다운로드한 Emailify Skill은 바로 설치할 수 있는 emailify-ai-designer 폴더 하나가 들어 있는, 버전이 지정된 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: 성공적으로 내보낸 각 컴포넌트의 1x 시각 참조 이미지.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 설치
현재 패키지를 다운로드한 뒤 Copy Instructions를 클릭하세요. 버튼이 Instructions Copied로 바뀌고 Emailify가 다음 할 일을 알려 줘요. 복사한 지침을 새 Codex 또는 Claude Code 작업에 붙여 넣으세요. 이 지침은 다운로드한 ZIP의 정확한 이름을 알려 주고, 프로젝트 Skill을 설치하거나 교체한 뒤, 파일 이름, 버전, 내보내기 시간, 카탈로그 지문, 구성 지문을 확인해요. 값이 하나라도 일치하지 않으면 에이전트는 작업을 멈추고 새로 다운로드해 달라고 요청해요. 에이전트가 emailify-ai-designer 준비가 끝났다고 확인하면 다음 메시지로 이메일 브리프를 보내세요.
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 파일의 브랜드 카탈로그와 프로필이 관련 작업 공간에 연결된 상태로 유지돼요.
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이 바로 나타나지 않으면 새 에이전트 작업을 시작하세요.
에이전트에게 브리프 전달하기
가능하다면 캠페인 목표, 대상, 고객 생애 주기 단계, 시점, 제목, 프리헤더, 승인된 문구, CTA 문구, 링크, 이미지 URL, 대체 텍스트, 브랜드 가이드, 법적 요구 사항, ESP 요구 사항, 병합 태그, 원하는 모듈 순서를 포함하세요.
Skill은 검증된 .emailify-ai.json 파일을 작업 디렉터리에 저장해요. 큰 캠페인에서는 채팅에 일부만 있거나 잘린 JSON을 출력하는 대신 이메일마다 완성된 파일을 하나씩 만드는 쪽을 택해요.
원한다면 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단계: 에이전트 결과 가져오기
원시 JSON을 붙여 넣거나, 생성된 .emailify-ai.json 파일 하나 이상을 응답 필드에 끌어다 놓거나, Choose File을 클릭하세요. Emailify가 전체 결과를 자동으로 검증해요.
결과 전체가 유효하면 Create Email을 사용할 수 있게 돼요. 이메일이 여러 개인 유효한 응답이라면 버튼에 만들어질 이메일 수가 표시돼요. 일부라도 유효하지 않으면 생성은 비활성화된 상태로 유지되고, Copy Fix Prompt가 같은 에이전트 작업에 다시 붙여 넣을 수 있는 간결한 수정 요청을 복사해 줘요. 이 수정 요청은 컴포넌트 카탈로그를 반복해 보내지 않고 에이전트에 이미 불러온 Skill을 사용해요.
설치한 Skill 폴더 안에서 번들 검증기를 직접 실행할 수도 있어요.
node scripts/validate-response.js /path/to/email.emailify-ai.json마지막으로 다운로드한 Skill이 현재 컴포넌트 카탈로그, 소스, 프로필, 문구 정책, 대체 설정, Skill 패키지 버전과 더 이상 일치하지 않으면 Emailify가 경고해 줘요. 이 중 하나라도 바뀌면 Skill을 다운로드해 설치된 Skill을 교체하세요. 같은 New Email 모달에서 다른 탭으로 전환해도 진행 중인 AI Designer 결과는 그대로 남아 있어요.
카탈로그 최신 상태 확인에는 컴포넌트 이름, 역할, 카테고리, 설명, AI 메모, 수용량, 편집 가능한 슬롯과 보호된 슬롯 메타데이터, 가벼운 시각적 서명이 포함돼요. Emailify가 Skill을 오래된 것으로 표시하면 다시 다운로드해 설치하세요. 패키지를 반복해서 더 빠르게 다운로드할 수 있도록, 바뀌지 않은 미리보기 이미지는 현재 플러그인 세션 동안 재사용돼요.
Emailify Skill 응답은 브리프가 아니라 카탈로그에 묶여 있어서 requestFingerprint가 필요하지 않아요. 대신 workflowMode: "external", 활성 contentPolicy, 이메일마다 unresolved 배열, 그리고 모든 텍스트 재정의에 source: "provided" 또는 source: "generated"를 선언해야 해요.
브리프 예시
# 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.응답 검증과 형식
JSON Response 필드에는 AI 도구에서 복사한 원시 JSON, 끌어다 놓은 파일, 가져온 .json 또는 .emailify-ai.json 파일 하나 이상을 넣을 수 있어요.
AI Designer가 받는 형식은 다음과 같아요.
- 단일 JSON 객체로 된 이메일 초안 하나.
emails배열에 담긴 여러 이메일 초안.templates배열에 담긴 여러 이메일 초안.
Emailify Skill 응답은 다운로드한 카탈로그 지문과 대조해 확인돼요. 그래서 Skill을 다운로드한 뒤 컴포넌트 라이브러리가 바뀌었다면 Emailify가 오래된 JSON을 막을 수 있어요.
Create Email을 활성화하기 전에 Emailify는 컴포넌트 참조, 편집 가능한 슬롯, URL, 승인된 링크, 이미지 대체 텍스트, 자리 표시용 콘텐츠, 필수 역할, 헤더/푸터 배치, 문구 정책, 대체 수단 사용 여부를 내부적으로 확인해요.
JSON이 유효하지 않으면 Copy Fix Prompt를 클릭하고, 그 결과를 생성한 같은 Codex 또는 Claude Code 작업에 다시 붙여 넣으세요. 그런 다음 응답 필드의 내용을 에이전트가 수정한 JSON으로 바꾸세요.
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 필드
최상위 응답에는 다음이 포함돼요.
schemaVersion: AI Designer 응답 규약 버전.workflowMode: Emailify Skill 응답이면external.contentPolicy: 활성 프로필의 정책.preserve,light-edit,draft-missing중 하나.catalogFingerprint: Skill로 내보낸, 감지된 컴포넌트 라이브러리를 식별하는 값.emails: 완성된 이메일 초안 하나 이상. 이메일 하나에 집중한 다중 이메일 프롬프트에는 이메일이 하나만 들어 있어요.
각 이메일 초안에는 다음이 포함돼요.
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또는httpsURL을 사용하는{slotRef, value}링크 교체 항목의 배열.overrides.images:{slotRef, url, alt, href}이미지 교체 항목의 배열.overrides.hidden: 컴포넌트에 쓰지 않는 선택 콘텐츠나 자리 표시용 콘텐츠가 있을 때 숨길 슬롯 참조.
정확한 componentId, componentName, presetKey와 이름이 있는 재정의 객체를 사용하는 이전 응답도 호환성을 위해 계속 지원돼요.
권장 사항
- 특정 브랜드 모듈을 원한다면 Emailify 컴포넌트 라이브러리의 정확한 컴포넌트 이름을 사용하세요.
- 브리프에 다른 지시가 없다면 헤더 컴포넌트는 맨 앞에, 푸터 컴포넌트는 맨 뒤에 두세요.
- 캠페인에 강렬한 첫 메시지가 필요하다면 위쪽에 히어로나 기능 소개 컴포넌트를 사용하세요.
- 브리프에서 여러 CTA를 특별히 요청하지 않는 한 이메일마다 명확한 CTA 하나를 사용하세요.
- Markdown 형식의 링크가 아닌 일반 절대 URL을 사용하세요.
- 모든 이미지 URL에 유용한 대체 텍스트를 넣으세요.
- 법적 문구, 규정 준수 문구, 할인, 시점, 병합 태그, 고지 문구는 필요한 곳에서 정확히 그대로 유지하세요.
- 여러 이메일로 된 캠페인이라면 이메일마다 명확한 제목을 붙이세요. Skill은 이메일마다 완성된 응답 파일을 하나씩 작성해요.
- ESP로 내보내기 전에 생성된 Figma 템플릿을 검토하세요.
문제 해결
- 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을 다운로드하세요. - preflight에서 preserve 정책인데 생성된 문구가 있다고 보고하면 텍스트 소스를 바꾸거나, 빠진 문구를 제공하거나, 초안 작성을 허용하는 프로필을 사용하세요.
- 여러 이메일로 된 큰 캠페인이라면 에이전트에게 이메일마다 완성된
.emailify-ai.json파일을 하나씩 작성해 달라고 하고, 브리프에는Email 1 - Welcome,Email 2 - Follow-up,Email 3 - Offer같은 제목을 사용하세요.