235 lines
8.5 KiB
Markdown
235 lines
8.5 KiB
Markdown
# INFINITH Agent System & Prompts
|
|
|
|
각 에이전트의 역할, 시스템 프롬프트, 프로세스 정의.
|
|
|
|
---
|
|
|
|
## Pipeline Overview
|
|
|
|
```
|
|
URL 입력
|
|
↓
|
|
[Agent 1] Channel Discovery Agent — 채널 발견 + 검증
|
|
↓
|
|
[Agent 2] Data Collection Agent — 채널 데이터 전량 수집 + 시장 분석
|
|
↓
|
|
[Agent 3] Marketing Intelligence Agent — AI 리포트 생성
|
|
↓
|
|
[Agent 4] Content Director Agent — 콘텐츠 기획 + 캘린더
|
|
↓
|
|
[Agent 5] Brand Strategist Agent — 브랜드 가이드 + 채널 전략
|
|
```
|
|
|
|
---
|
|
|
|
## Agent 1: Channel Discovery Agent (채널 발견)
|
|
|
|
**역할**: 마케팅 리서처. 병원의 모든 온라인 채널을 찾아내는 전문가.
|
|
|
|
**File**: `supabase/functions/discover-channels/index.ts`
|
|
|
|
### Process (3단계)
|
|
1. **Stage A**: Firecrawl 웹사이트 스크래핑 (병원명 추출 + 소셜 링크 파싱)
|
|
2. **Stage B**: 6개 API 병렬 검색 (YouTube API, Naver API, Firecrawl Search, Perplexity, Apify Instagram)
|
|
3. **Stage C**: 5개 소스 병합 + 핸들 검증
|
|
|
|
### System Prompt (Perplexity — Online Presence 종합 분석)
|
|
```
|
|
Role: Digital marketing analyst specializing in Korean medical clinics.
|
|
Task: Search the web thoroughly and provide a comprehensive online presence report.
|
|
Output: ONLY valid JSON, no explanation.
|
|
|
|
User Prompt:
|
|
"{clinicName}" 병원의 Online Presence를 종합 분석해줘.
|
|
|
|
아래 채널들을 모두 검색해서 찾아줘:
|
|
- 인스타그램 계정 (병원 공식, 원장 개인, 영문 계정 등 여러개 있을 수 있음)
|
|
- 유튜브 채널 (메인 채널, Q&A 채널 등)
|
|
- 페이스북 페이지
|
|
- 틱톡 계정
|
|
- 네이버 블로그 (공식 블로그)
|
|
- 카카오톡 채널
|
|
- 강남언니 등록 여부 및 URL
|
|
- 바비톡 등록 여부
|
|
- 네이버 플레이스 등록 여부
|
|
```
|
|
|
|
### System Prompt (Perplexity — 병원명 추출 fallback)
|
|
```
|
|
Role: None (simple extraction)
|
|
System: Respond with ONLY the clinic name in Korean, nothing else.
|
|
User: {url} 이 URL의 병원/클리닉 한국어 이름이 뭐야?
|
|
```
|
|
|
|
### Data Sources
|
|
| Source | API | 검색 방법 |
|
|
|--------|-----|----------|
|
|
| 웹사이트 HTML | Firecrawl scrape + map | URL 파싱으로 소셜 링크 추출 |
|
|
| YouTube | YouTube Data API v3 | `search?type=channel&q={clinicName}` |
|
|
| Naver Blog | Naver Search API | `blog.json?query={clinicName} 공식 블로그` |
|
|
| Naver Web | Naver Search API | `webkr.json?query={clinicName} 인스타그램 유튜브` |
|
|
| Instagram | Apify instagram-profile-scraper | 병원명 변형으로 직접 프로필 검색 |
|
|
| 종합 검색 | Firecrawl Search | `{clinicName} instagram youtube 공식` |
|
|
| 종합 분석 | Perplexity sonar | Online Presence 종합 분석 |
|
|
|
|
---
|
|
|
|
## Agent 2: Data Collection Agent (데이터 수집)
|
|
|
|
**역할**: 데이터 엔지니어. 검증된 채널에서 raw 데이터를 전량 수집.
|
|
|
|
**File**: `supabase/functions/collect-channel-data/index.ts`
|
|
|
|
### Process
|
|
9개 API 병렬 호출 (Promise.allSettled):
|
|
1. Instagram — Apify `instagram-profile-scraper`
|
|
2. YouTube — YouTube Data API v3 (채널 통계 + 인기 영상 10개)
|
|
3. Facebook — Apify `facebook-pages-scraper`
|
|
4. 강남언니 — Firecrawl JSON 추출
|
|
5. Naver Blog — Naver Search API
|
|
6. Naver Place — Naver Local API
|
|
7. Google Maps — Apify `compass~crawler-google-places`
|
|
8-11. 시장 분석 — Perplexity (경쟁사, 키워드, 시장, 타겟 4개 병렬)
|
|
|
|
### System Prompt (시장 분석 — 4개 공통)
|
|
```
|
|
Role: Korean medical marketing analyst
|
|
System: Always respond in Korean. Provide data in valid JSON format.
|
|
|
|
Queries:
|
|
1. 경쟁사: {address} 근처 {services} 전문 경쟁 병원 5곳 분석
|
|
2. 키워드: {services} 관련 검색 키워드 트렌드 (네이버+구글 월간 검색량 20개)
|
|
3. 시장: {services[0]} 시장 트렌드 2025-2026 (규모, 성장률, 트렌드)
|
|
4. 타겟: {clinicName} 잠재 고객 분석 (연령, 성별, 채널, 의사결정)
|
|
```
|
|
|
|
### System Prompt (강남언니 추출)
|
|
```
|
|
Firecrawl JSON extraction:
|
|
Extract: hospital name, overall rating (out of 10), total review count,
|
|
doctors with names/ratings/review counts/specialties, procedures offered,
|
|
address, certifications/badges
|
|
```
|
|
|
|
---
|
|
|
|
## Agent 3: Marketing Intelligence Agent (리포트 생성)
|
|
|
|
**역할**: 마케팅 커뮤니케이션 전략가. 실제 수집 데이터를 기반으로 종합 리포트 작성.
|
|
|
|
**File**: `supabase/functions/generate-report/index.ts`
|
|
|
|
### System Prompt
|
|
```
|
|
Role: Korean medical marketing analyst
|
|
Constraints:
|
|
- Respond ONLY with valid JSON, no markdown code blocks
|
|
- Use Korean for text fields
|
|
- 강남언니 rating is 10-point scale
|
|
- Use ONLY the provided real data — NEVER invent metrics
|
|
- If data is missing, write "데이터 없음"
|
|
|
|
User Prompt Structure:
|
|
1. 병원 기본 정보 (scraped data)
|
|
2. 실제 채널 데이터 (collected from APIs — YouTube 구독자, Instagram 팔로워 등)
|
|
3. 시장 분석 데이터 (Perplexity 검색 결과)
|
|
4. 웹사이트 브랜딩 (Firecrawl 추출)
|
|
5. JSON 리포트 구조 (channelAnalysis, brandIdentity, kpiTargets, recommendations 등)
|
|
```
|
|
|
|
### Output Structure
|
|
```json
|
|
{
|
|
"clinicInfo": {},
|
|
"executiveSummary": "",
|
|
"overallScore": 0-100,
|
|
"channelAnalysis": { "naverBlog": {}, "instagram": {}, "youtube": {}, ... },
|
|
"brandIdentity": [{ "area": "", "asIs": "", "toBe": "" }],
|
|
"kpiTargets": [{ "metric": "", "current": "", "target3Month": "", "target12Month": "" }],
|
|
"recommendations": [{ "priority": "", "category": "", "title": "", "description": "" }],
|
|
"competitors": [],
|
|
"keywords": {},
|
|
"targetAudience": {},
|
|
"marketTrends": []
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Agent 4: Content Director Agent (콘텐츠 기획)
|
|
|
|
**역할**: 콘텐츠 디렉터. 채널 전략과 브랜드 가이드를 기반으로 4주 콘텐츠 캘린더 기획.
|
|
|
|
**File**: `src/lib/contentDirector.ts`
|
|
|
|
### Process (결정론적 — AI 호출 없음)
|
|
1. 채널-포맷 매트릭스 구성 (YouTube Shorts/Long, Instagram Reels/Carousel/Stories, 네이버 블로그, Facebook 광고)
|
|
2. 주차별 테마 할당 (Week 1: 브랜드 정비, Week 2: 콘텐츠 엔진, Week 3: 소셜 증거, Week 4: 전환 최적화)
|
|
3. Pillar-Service 매트릭스로 토픽 생성 (전문성×서비스, 비포애프터×서비스, 후기×서비스, 트렌드×서비스)
|
|
4. 기존 YouTube 인기 영상 리퍼포징 배치
|
|
5. 월간 콘텐츠 서머리 계산
|
|
|
|
### Input
|
|
```typescript
|
|
{
|
|
channels: ChannelStrategyCard[]; // 활성 채널 목록
|
|
pillars: ContentPillar[]; // 4개 콘텐츠 필라
|
|
services: string[]; // 시술 목록
|
|
youtubeVideos: TopVideo[]; // 리퍼포징 소스
|
|
clinicName: string;
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Agent 5: Brand Strategist Agent (브랜드 전략)
|
|
|
|
**역할**: 브랜드 전략가. 채널 분석 결과를 브랜드 가이드와 채널별 커뮤니케이션 전략으로 변환.
|
|
|
|
**File**: `src/lib/transformPlan.ts`
|
|
|
|
### Process (결정론적 — AI 호출 없음)
|
|
1. 채널 스코어 기반 전략 카드 생성 (P0/P1/P2 우선순위)
|
|
2. 브랜드 일관성 분석 (채널 간 이름/로고/연락처 비교)
|
|
3. 콘텐츠 필라 정의 (전문성·신뢰 / 비포·애프터 / 환자 후기 / 트렌드·교육)
|
|
4. 에셋 수집 및 리퍼포징 제안
|
|
|
|
---
|
|
|
|
## Agent 6: Image Creator Agent (이미지 생성)
|
|
|
|
**역할**: 비주얼 디자이너. 마케팅 이미지 생성.
|
|
|
|
**File**: `src/services/geminiImageGen.ts`
|
|
|
|
### System Prompt
|
|
```
|
|
Generate a premium medical marketing image for a plastic surgery clinic.
|
|
Theme: {pillarContext} // safety | expertise | results | care
|
|
Style: {channelHint} // youtube | instagram | naver_blog | tiktok | facebook
|
|
Color palette: soft purple (#7B2D8E), gold (#E8B931), warm white (#FAF8F5).
|
|
Premium, luxurious, trustworthy aesthetic.
|
|
No text or logos in the image.
|
|
Photorealistic, high quality, professional medical marketing.
|
|
```
|
|
|
|
---
|
|
|
|
## Known Issues & Improvement Plan
|
|
|
|
### 검색 성능
|
|
- [ ] Instagram 검색: Perplexity가 찾아도 verify에서 탈락 → unverified 핸들도 후보로 유지
|
|
- [ ] Apify Instagram 검색 타임아웃 30초 → 60초로 증가
|
|
- [ ] 강남언니 verify 성공률 개선 — Perplexity URL 힌트 활용도 높이기
|
|
|
|
### 프롬프트 품질
|
|
- [ ] Few-shot example 추가 (성공 응답 예시 포함)
|
|
- [ ] Chain-of-thought 유도 (리포트 생성 시 분석 과정 단계별 진행)
|
|
- [ ] JSON 파싱 실패 시 재시도 (temperature 올려서 1회)
|
|
- [ ] Perplexity `response_format: json_object` 옵션 활용
|
|
|
|
### 데이터 품질
|
|
- [ ] 주소 정보: Google Maps + Naver Place에서 수집한 주소를 최우선 사용
|
|
- [ ] 개원 연도 파싱: "데이터 없음 (NaN년)" 방지
|
|
- [ ] KPI 수치: enrichment 실제 데이터 우선, AI 추측 무시
|