리포팅 에이전트

리포팅은 퍼포먼스를 반복·공유 가능한 리포트로 바꿉니다. 제품은 이 패밀리를 이렇게 설명합니다: “매번 같은 뷰를 다시 만들지 않고, 반복 리포트를 재오픈하고, 자주 보는 지표를 저장하고, 명확한 퍼포먼스 업데이트를 공유한다.”

리포팅 에이전트 페이지 — 가이드 카드, 4개 리포트 에이전트, Execution History

여기엔 두 종류가 있습니다: Pulson 오퍼레이터가 게시하는 관리형 리포트 1개와 온디맨드로 실행하는 셀프서브 생성기 3개. 페이지에는 Shared Reports와 Chat Reports 탭도 있습니다(팀 공유 리포트, 챗 턴에서 생성된 리포트).

공통점

넷 모두 Snowflake에서 프로필/country로 스코프해 읽습니다 — 주로 DAILY_OVERALL_PERFORMANCE와 DAILY_TOTAL_ADS_CREATIVE_REPORT(해당 시 vendor 매출 데이터 포함). 모두 읽기 전용 리포트 생성 — 출력의 액션 카드(예: “이 입찰 줄이기”)는 적용된 변경이 아니라 제안.

에이전트

Pulson Weekly Report (관리형)

하는 일: country와 주차를 선택해 관리형 서비스 주간 리포트를 봄. 온디맨드 생성 없음 — Pulson 오퍼레이터가 게시.
구동: pulsead-agents의 자율 Weekly Report 파이프라인(data_preparer ∥ context_builder → report_writer → 오퍼레이터 승인 → publisher → S3). 그 게시 출력을 보는 것.
기본값: 활성, 관리 티어.

Weekly Report Generator (셀프서브)

하는 일: 온디맨드 7일 리포트 생성 — KPI 밴드, 주간 대비, 카테고리별 지출/매출, 핵심 액션, 다음 주 전망(6개 섹션).
구동: ai-api의 Dashboard Report Agent(템플릿 종류 WEEKLY_REPORT_GENERATOR).
기본값: 활성; 첫 사용 시 템플릿 생성.

Monthly Report Generator (셀프서브)

하는 일: 전월 요약 — KPI 대 타겟·전월 대비, 사업부 분해, 상위 상품 무버, 카테고리 점유율 변화, 미해결 항목(7개 섹션).
구동: Dashboard Report Agent(MONTHLY_REPORT_GENERATOR).
기본값: 활성.

Daily Brief Generator (셀프서브)

하는 일: 일간 스냅샷 — 어제 vs 7일 이동평균, 일간 KPI 밴드, 채널/상품그룹 건강·무버, 원인 분석, 오늘의 액션.
구동: Dashboard Report Agent(BSS_DAILY_BRIEF_GENERATOR). 참고: “일간”이지만 크론이 아니라 온디맨드 실행.
기본값: 활성.

하지 않는 일

캠페인을 바꾸지 않습니다. 리포팅은 읽기 전용. 유일한 쓰기는 리포트 템플릿 저장·스케줄 — Amazon이 아니라 Pulson 자체 DB만 건드리며 viewer 역할도 할 수 있는 몇 안 되는 액션 (기능 참고).
자유 형식 문서가 아닙니다. 출력은 고정 블록 집합(KPI 밴드, 인사이트 카드, 차트, 테이블)으로 조립되어 형태가 예측 가능.
범위를 가로지르지 않습니다. 한 리포트는 하나의 팀 + country.

생성기 실행, 처음부터 끝까지

세 생성기는 Dashboard Report Agent, 결정론적 3단계 파이프라인으로 동작(ReAct는 LLM이 render 도구를 호출하지 않고 산문을 써서 폐기):

데이터 fetch — 읽기 전용 단계가 3개 Snowflake 뷰에서 기간 지표를 당김(하드 캡, 필수 테넌트/country 스코프).
Plan — 구조화 출력 단계가 어떤 디렉티브(KPI 밴드, 카드, 차트, 테이블, 결론)를 낼지 결정하고 내용을 작성. 자유 마크다운 불가.
Render — 결정론적 단계가 디렉티브를 리포트로 직렬화.

결과는 Execution History에 저장되어 재오픈, 새 기간 재실행, 공유 가능. Pulson Weekly Report는 대신 pulsead-agents 주간 파이프라인이 이미 만든 출력을 보여줌.