콘텐츠로 이동

캠페인 에이전트

캠페인은 Pulson이 행동하는 곳입니다. 제품 설명: “무엇이 미끄러지는지 확인하고, 무엇을 바꿀지 결정하고, 예산·입찰·타겟 액션을 한곳에 둔다.” 이 페이지와 함께 기능을 읽으세요 — 모든 실제 변경은 게이트되고, 라이브 예산 쓰기는 오늘 **단일 파일럿 브랜드(KISS)**에 도달합니다.

캠페인 에이전트 페이지 — 가이드 카드, 캠페인 에이전트, Execution History

  • 하는 일: Amazon Marketing Cloud 분석을 자연어 또는 SQL로 작성, AMC 인스턴스에 자동 실행, 상태(성공/실패/대기) 추적, 결과 테이블·차트 검토. 표준 리포트로는 못 얻는 오디언스/퍼포먼스 그림을 구축.
  • 액션: 없음. 쿼리를 돌려 결과를 반환할 뿐 아무것도 바꾸지 않음.
  • 구동: pulsead-agents의 AMC 에이전트 — 요청을 advisor(AMC 질문 답변) 또는 writer(AMC SQL 생성·저장; SELECT/WITH만)로 보내는 router. ai-api에서 AMC 빌드/실행은 챗 도구이고 REST 라우트는 읽기 전용.
  • 기본값: 활성.

Campaign Optimizer — 제안 후 챗 승인

섹션 제목: “Campaign Optimizer — 제안 후 챗 승인”
  • 하는 일: 캠페인 목록과 입찰/예산 변경·캠페인 생성 요청을 사이드바 챗으로 하는 통합 공간. 모든 조정 요청을 before/after 지표, 상태, 영향 범위와 함께 추적.
  • 액션: 제안-변경, 사람 게이트. 자연어로 변경을 요청하면 챗에서 각 디렉티브를 승인한 후에만 라이브 캠페인에 적용. 자율이 아님.
  • 구동: Action Chat의 Action 서브에이전트ads_* 뮤테이션 도구(ads_adjust_budget, ads_pause_campaign(s), ads_update_campaigns, ads_adjust_bids, ads_update_keywords, ads_update/create_targets, ads_create_campaign …), 각각 승인 플로우로 감쌈. 히스토리는 캠페인 실행 읽기 라우트.
  • 기본값: 활성.
  • 하는 일: 번들 사이클 — Monitor → Rebalance → Optimize → Execute → Verify — 을 돌려 페이싱/예산 초과를 탐지, 상품그룹 예산 이동과 입찰 조정을 제안, 자동 승인 정책하에 실행, 실패/보류 항목을 리뷰 큐로 라우팅, 결과를 다음 사이클 베이스라인으로 학습.
  • 액션: 정책 게이트 내 자율. 캠페인 에이전트 중 유일하게 변경별 챗 승인 없이 라이브 예산/입찰을 바꿀 수 있음 — 자동 승인 정책이 무엇을 자동 실행하고 무엇을 리뷰로 보낼지 결정.
  • 구동: pulsead-agentsOptimize Cycle 파이프라인 — 6개 에이전트(input_checker → monitor → rebalancer → optimizer → executor → verifier)와 (자동 승인 꺼짐 시) 두 사람 승인 게이트(리밸런스 후, 할당 후). 1분 스케줄러가 due 사이클을 실행.
  • 기본값: 비활성 — 브랜드에서 사이클이 한 번 실행되었거나 토글해야 켜짐.
  • 계정을 조용히 바꾸지 않습니다. Campaign Optimizer는 디렉티브별 챗 승인 필요; Budget Automation은 명시적 자동 승인 정책 내에서만 행동하고 나머지는 리뷰로 보냄.
  • 자율 예산 쓰기는 광범위 라이브가 아님. Optimize Cycle executor는 KISS에만 실제 예산 변경을 보냄; 나머지는 계산·기록만 하고 보내지 않음(no-op “success”). 기능 참고.
  • AMC Builder는 행동하지 않음 — 읽기 전용 인사이트.
  • 역할·가드레일을 우회하지 않음. viewer는 캠페인 변경 승인 불가; 예산 변경은 크기 가드레일 (≤50% / ≤$10k / ≥$1)과 브랜드별 amazon_ads_mode(disabled / dry-run / live) 통과.

변경 한 건, 처음부터 끝까지 (Campaign Optimizer)

섹션 제목: “변경 한 건, 처음부터 끝까지 (Campaign Optimizer)”
  1. 에이전트를 연다 — 미끄러지는 캠페인에 대해, 현재 범위에서.
  2. Pulson이 찾은 것 검토 — 변경 후보와 근거.
  3. 제안. Action 서브에이전트가 보류 action request를 작성하고 승인 카드 표시. 아직 Amazon에는 변경 없음.
  4. 승인. 권한 사용자가 ~5분 창 안에 승인; viewer 차단, 가드레일 적용.
  5. 적용. 별도 결정론적 단계가 승인된 변경을 pulsead-agents → Amazon으로 실행하고, 실행이 Execution History에 무엇이 바뀌었고/승인 대기/후속 필요와 함께 적재.

자율 사이클 동작 (Budget Automation)

섹션 제목: “자율 사이클 동작 (Budget Automation)”

input_checker가 브랜드 전제 검증 → monitor가 7일 + MTD 퍼포먼스 수집 → rebalancer가 상품그룹 예산을 계산해 제안(게이트 1) → optimizer가 캠페인에 할당해 제안(게이트 2) → executor가 Amazon에 예산 패치(KISS만; 나머지 no-op) → verifier가 재확인·드리프트 자동 보정. 자동 승인 꺼짐 시 각 게이트에서 사람을 기다리고, 켜짐 시(브랜드/스테이지별) 통과.

같은 Action 서브에이전트가 캠페인 표면에서 추가로 노출:

  • Performance Diagnose — 하락 SP/SB/SD 캠페인을 찾아 원인 분석하고 1–5 액션 추천(읽기 전용; 적용은 별도 게이트 단계).
  • 키워드 자동화(백오피스) — keyword_harvester가 수익 exact-match 키워드 제안; waste_keyword_pauser가 제로 클릭 지출 일시중지 제안. 둘 다 제안 → 승인 카드 → 게이트된 뮤테이션.