에이전트
PulseAd는 세 계층의 에이전트로 운영됩니다. 새 제품 리더는 세부에 앞서 이 구조를 잡아야 합니다:
- 인앱 에이전트 — Pulson 앱의
/agent/...에서 사용자가 여는 10개 에이전트. 플래닝, 리포팅, 캠페인으로 묶임. - 챗 엔진 — 사용자가 Pulson과 대화할 때,
ai-api의 에이전트 그래프(라우터 → 전문가 → 컴포저)가 답함. - 자율 백오피스 에이전트 —
pulsead-agents의 21개 스케줄/오케스트레이션 에이전트가 계정 모니터링, 예산 리밸런싱, 리포트 작성, 키워드 자동화를 대부분 크론으로 수행 — 인앱 에이전트가 보여주는 것을 이들이 만든다.
모든 것을 가로지르는 두 사실:
- 모델이 서비스별로 다름.
ai-api(챗, 리포트)는 OpenAI GPT‑5 패밀리.pulsead-agents(자율)는 AWS Bedrock — 기본 Claude Haiku 4.5, 작성/결정 에이전트는 Claude Sonnet 4.6. Snowflake 시맨틱 레이어의 Cortex Agent도 Sonnet 4.6. - 읽기는 자유, Amazon 쓰기는 강하게 게이트됨. 실제 Amazon Ads 예산/입찰 쓰기는 오늘 단일
파일럿 브랜드(
KISS)로 게이트되고, 모든 쓰기 경로는 승인 또는 명시적 자동 승인 토글 뒤. 기능 참고.
1. 인앱 에이전트 (사용자가 보는 것)
섹션 제목: “1. 인앱 에이전트 (사용자가 보는 것)”세 패밀리의 10개 에이전트. “기본값”은 설정 없이 브랜드에서 켜져 있는지.
| 에이전트 | 패밀리 | 읽기 | Amazon 변경? | 기본값 |
|---|---|---|---|---|
| News & Market Intelligence | 플래닝 | Exa.ai 뉴스/검색(8개 마켓플레이스) | 아니오 | 꺼짐(구독별) |
| Biweekly Marketing Proposal | 플래닝 | 최근 퍼포먼스 + 시장 컨텍스트 | 아니오 | 활성(관리 티어) |
| Product Discovery | 플래닝 | 카테고리 / 브랜드 / ASIN / 키워드 신호 | 아니오 | 활성 |
| Pulson Weekly Report | 리포팅 | Snowflake 퍼포먼스(관리형/게시) | 아니오 | 활성(관리 티어) |
| Weekly Report Generator | 리포팅 | Snowflake 퍼포먼스 | 아니오(제안만) | 활성 |
| Monthly Report Generator | 리포팅 | Snowflake 퍼포먼스 | 아니오(제안만) | 활성 |
| Daily Brief Generator | 리포팅 | Snowflake 퍼포먼스 | 아니오(제안만) | 활성 |
| AMC Builder | 캠페인 | Amazon Marketing Cloud | 아니오(읽기 전용) | 활성 |
| Campaign Optimizer | 캠페인 | Ads 캠페인 구조/지표 | 예 — 제안 → 챗 승인 | 활성 |
| Budget Automation | 캠페인 | Snowflake 페이싱/타겟 | 예 — 정책하 자율 | 꺼짐(사이클 실행 전) |
10개 모두 하나의 레지스트리(pulsy-frontend/src/core/agent/agent-registry.ts)에 정의.
2. 챗 엔진 (ai-api, 라이브)
섹션 제목: “2. 챗 엔진 (ai-api, 라이브)”사용자가 Pulson에 입력하면 Action Chat이 답합니다 — 매 턴 재구성되는 LangGraph 상태 머신:
라우터 → 전문가 서브에이전트 1개 → 컴포저.
| 에이전트 | 역할 | 읽기/쓰기 | 모델 |
|---|---|---|---|
| Router | 메시지 분류(query/insight/action/task), 컨텍스트 해석 | 읽기 전용 | gpt-4.1-mini |
| Query 서브에이전트 | Snowflake에서 본인 퍼포먼스/매출/예산 답변, 차트 | 읽기 전용 | gpt-5.5 |
| Insight 서브에이전트 | 외부/시장 조회 — 경쟁사, 키워드, ASIN 상세(웹 검색) | 읽기 전용 | gpt-5.5 |
| Action 서브에이전트 | Amazon 계정을 바꿀 수 있는 유일한 에이전트 — 입찰/예산/키워드/타겟, 커스텀 리포트, AMC, optimize-cycle, 진단 | 쓰기(게이트) | gpt-5.5 / gpt-5 |
| Task 서브에이전트 | 내부 인박스 & 태스크 관리 | 내부 쓰기만 | gpt-5-mini |
| Composer | 최종 답변 작성(“제 이름은 Pulson”) | 읽기 전용 | gpt-5.5 |
| Memory Agent | 백그라운드 — 매 턴 관찰, 영속 브랜드 메모리 구축(16-카드 분류기) | 내부 쓰기만 | gpt-5-nano |
인접한 두 챗 표면: Pulson / “Growth Twin”(라이브 브랜드 대면 챗, /pulsy/chats)과 PSM
(원래 엔진, 레거시/frozen — 타임라인 참고).
3. 리포트 & 진단 엔진 (ai-api)
섹션 제목: “3. 리포트 & 진단 엔진 (ai-api)”| 에이전트 | 하는 일 | 읽기/쓰기 |
|---|---|---|
| Dashboard Report Agent | 실제 리포트 엔진 — 3단계 파이프라인(데이터 fetch → 디렉티브 plan → KPI 밴드/카드/차트/테이블 render). 리포팅 생성기를 구동. | 읽기 전용(리포트 행 기록) |
| Reporter Agent | 요청 시 단일 리포트 섹션 재생성 | 리포트 행 기록 |
| Performance Diagnose | 하락 SP/SB/SD 캠페인 탐지, 원인 분석, 1–5 액션 추천 | 읽기 전용 — 추천만, 적용 안 함 |
| News Intelligence | Exa.ai 기반 브랜드/시장/경쟁사 뉴스 브리핑(LLM 챗 에이전트 아님) | 읽기 전용 |
| Search-term segmentation | Amazon 검색어를 세그먼트로 배치 분류 + 브랜드 인식 | 읽기 전용 · Gemini 2.5 Flash-Lite(ai-api의 유일한 비-OpenAI 모델) |
4. 자율 백오피스 에이전트 (pulsead-agents, 21)
섹션 제목: “4. 자율 백오피스 에이전트 (pulsead-agents, 21)”AWS Bedrock/AgentCore 계층에서 스케줄/오케스트레이션으로 실행. 무거운 작업을 하고, 인앱
에이전트는 대개 그 출력을 표시. 모든 proposer는 승인 큐에 쓰고, executor만 행동하며 승인 후
(그리고 KISS-only 라이브 게이트) 동작.
Campaign Health — 일일 모니터 → 진단 → 수정 루프:
- monitoring — 일일 이상 탐지(ROAS 하락, 비용 급증, Buy Box 상실). 읽기 전용. ~07:00 KST 월–금.
- diagnoser — 이상 원인 분석, 구조적 액션(일시중지, 감사) 제안. Proposer.
- rtb_analyst — RTB 룰그룹 분석, 입찰/예산 튜닝 제안. Proposer.
- executor — 승인된 액션(입찰/예산/일시중지) 적용. 쓰기, 수동 전용.
Optimize Cycle — 자동 예산 리밸런싱(Budget Automation의 엔진), 1분 스케줄 폴러, 두 사람 게이트:
- input_checker(P0) → monitor(P2) → rebalancer(P3, proposer) → 승인 → optimizer(P4, proposer) → 승인 → executor(P6, 쓰기) → verifier(P7, 쓰기).
Weekly Report 파이프라인 — Pulson Weekly Report의 엔진:
- data_preparer ∥ context_builder → report_writer(Sonnet 4.6) → 승인 / 거부→자동 재작성 → publisher(HTML을 S3 + Slack).
Ads Scheduling — 자연어 예약 변경:
- ads_scheduler(NL → 예약 작업) → ads_executor(매분 due 작업 실행; 쓰기, 게이트).
AMC — AMC Builder의 엔진:
- router → advisor(AMC 질문 답변) / writer(AMC SQL 생성·저장; 실행은 안 함).
Proactive Keyword — 알림 주도 proposer:
- keyword_harvester(수익 exact-match 키워드 제안), waste_keyword_pauser(제로 클릭 지출 일시중지 제안). 둘 다 제안 → 승인 카드 → 게이트된 뮤테이션.
5. 오퍼레이터 도구 (별개)
섹션 제목: “5. 오퍼레이터 도구 (별개)”AOP / aop-hermes 는 PulseAd 직원용 별도 오퍼레이터 에이전트 CLI — Pulson 제품의 일부가
아니며 제안→승인 게이트 뒤가 아님(~45개 Amazon Ads 쓰기 액션이 도구별 dry-run만으로
보호). 이름 지도와 기능 참고. 완전성을 위해
나열하며, 인앱 에이전트가 아닙니다.
계층이 연결되는 방식
섹션 제목: “계층이 연결되는 방식”클릭하는 인앱 에이전트는 대개 백엔드 엔진을 보는 창입니다:
| 인앱 에이전트 | 구동 |
|---|---|
| Budget Automation | Optimize Cycle(6-에이전트 파이프라인) |
| Campaign Optimizer | Action Chat의 Action 서브에이전트 → ads_* 뮤테이션 도구 |
| AMC Builder | AMC 에이전트(router/advisor/writer) |
| Weekly / Monthly / Daily Report | Dashboard Report Agent |
| Pulson Weekly Report | Weekly Report 파이프라인(ops가 게시) |
| News & Market Intelligence | News Intelligence 서비스(Exa.ai) |
각 인앱 에이전트의 전체 기능은 패밀리별 페이지를 보세요.