PulseAd란 무엇인가

이 페이지를 먼저 읽으세요. 나머지 문서가 전제하는 지도입니다 — PulseAd가 무엇인지, 듣게 될 이름들(현재 vs. 은퇴), 제품이 무엇으로 이루어졌는지, 그리고 나머지를 예측하게 해주는 하나의 행동 규칙(자유롭게 읽고, 승인을 받아야만 행동한다).

이것은 내부 문서입니다: 레거시 표면과 단일 파일럿 브랜드에서만 라이브인 기능을 포함해 실제 현재 상태를 기술합니다. 지저분한 부분은 매끄럽게 다듬지 않고 그대로 밝힙니다.

PulseAd란 무엇인가

PulseAd는 회사이자 플랫폼입니다. 그 제품이 Pulson — 에이전트형 Amazon 광고 제품 입니다. Amazon 광고 계정에 대해 Pulson과 자연어로 대화하면 — “지난주 Brand A의 ACoS가 왜 튀었지?”, “내 최악의 Sponsored Products 캠페인 예산 삭감안을 만들어줘,” “주간 퍼포먼스 리포트를 만들어줘” — 라이브 계정 데이터로 답하고, 제안된 변경을 사람이 승인하면 계정에 직접 행동할 수 있습니다(예산·입찰 조정, 캠페인 일시중지, 키워드·타겟 변경).

내부적으로는 누가-어느-Amazon-계정을-볼-수-있는지에 대한 멀티테넌트 모델 위에서, 자유롭게 읽고 신중하게 쓰는 챗 에이전트입니다. 나머지 거의 전부가 이 두 사실의 결과입니다.

제품은 챗만이 아닙니다. PulseAd는 애널리스트가 추론하는 데이터 & 시맨틱 레이어, 크리에이티브 제작(이미지·비디오), 비-Amazon 채널을 들여오는 데이터 적재, 그리고 직원이 계정을 직접 운영하는 내부 오퍼레이터 코크핏(AOP) 도 운영합니다.

이름 지도

여러 이름을 듣게 됩니다. 아래가 정규 지도입니다. 기억할 규칙: “PulseAd”는 회사/플랫폼, “Pulson”은 제품.

이름	무엇인가
PulseAd	회사이자 플랫폼. 또한 `PULSEAD`, 메인 Snowflake 스키마(218개 소스 테이블). UI가 아니라 플랫폼.
Pulson	제품 — 고객이 쓰는 에이전트형 Amazon 광고 앱. 현재의 정규 브랜드명.
Action agent (`action_chatbot.py`)	오늘 Pulson 뒤의 챗 엔진 — 멀티 에이전트 그래프, SSE 스트리밍. 이 문서가 “챗”이라 하면 이것.
PSM (`psm_chatbot.py`)	원래의 챗 엔진, 이제 frozen — 돌지만 신규 작업 금지. 이 위에 짓지 말 것.
Pulson agent (`pulson_agent.py`)	챗 엔진을 감싸는 세션/메모리 래퍼. (하부에서 레거시 PSM 엔진을 호출할 수 있음 — 브랜드가 아니라 코드 디테일.)
AOP / `aop-hermes`	PulseAd 내부 오퍼레이터 CLI — 직원이 터미널에서 Amazon 계정을 운영. 제품과는 별개 도구이며, 쓰기가 제품의 승인 게이트 뒤가 아님(기능 참고).

라이브: PulseAd, Pulson, Action agent, Pulson agent, AOP(별개 표면). Deprecated: PSM(frozen — 이 위에 짓지 말 것). 제품은 2026년에 리브랜딩되었고 그 이전에 대시보드 제품이 있었습니다 — 타임라인과 무엇이 deprecated인가 참고.

제품은 무엇으로 이루어졌는가

표면	하는 일	문서 위치
애널리스트 / 챗	질문·분석·리포트, 그리고 제안-후-승인 변경 — Pulson 제품.	가이드, 기능
데이터 & 시맨틱 레이어	Pulson이 아는 것: Snowflake 위 6개 도메인 애널리스트, 야간 리프레시.	데이터 모델
기능	읽기-vs-쓰기 경계와 승인 게이트.	기능
크리에이티브	광고 이미지 생성·변형, 비디오 생성.	크리에이티브
데이터 & 커버리지	Pulson이 보는 채널 — Amazon + off-Amazon(Meta, Google, TikTok …).	데이터 & 커버리지
오퍼레이터 도구(AOP)	내부 직원 CLI(`aop-hermes`) — 별개 도구.	CLI

어떻게 구성되어 있는가 (한눈에)

핵심 도표 — Pulson과 AOP가 Snowflake에 닿는 경로. 박스는 각 문서로 연결됩니다. Pulson의 pulsead-agents와 AOP는 Amazon Ads도 읽고/쓰지만(뮤테이션), 이 도표는 Snowflake 분석 경로에 집중합니다.

세 조각, 그 사이의 하나의 두뇌:

앱 — 로그인하는 Pulson 웹 앱(Next.js, Auth0).
API(ai-api) — 두뇌. 인증하고, 어떤 광고 데이터를 볼 수 있는지(팀 + country) 해석하고, 에이전트를 돌리고, 결과를 스트리밍. FastAPI + LangGraph; OpenAI 모델로 동작(Anthropic 아님), 상태는 Postgres, 분석은 Snowflake.
에이전트 레이어(pulsead-agents) — 실제로 Amazon을 만지는 레이어. ai-api는 모든 Amazon Ads / AMC 읽기 및 승인된 쓰기를 여기로 프록시; Amazon 통합을 소유하고 모든 액션을 기록.

그래서 Amazon 데이터 문제는 보통 원시 Amazon 에러가 아니라 pulsead-agents 프록시의 타임아웃으로 나타납니다.

무엇을 하는가 (꼭 체화할 하나의 규칙)

읽기는 자유롭게 흐르고, 쓰기는 제안 → 승인 → 적용입니다. 챗에서 요청한 변경은 대화 도중에 적용되지 않습니다. 에이전트는 보류 중 변경을 기록하고 승인 카드를 보여준 뒤 멈춥니다; 사람이 승인해야만 별도 단계가 pulsead-agents → Amazon으로 적용합니다.

먼저 알아둘 내부 caveat 하나: 자율(비-챗) 예산 최적화는 오늘 정확히 한 파일럿 브랜드에서만 라이브입니다(KISS) — 나머지 모든 브랜드에서는 옵티마이저가 결정을 계산하되 Amazon으로는 아무것도 보내지 않습니다. 전체 게이트 모델은 기능에 있습니다.

다음으로

기능 — 읽기-vs-쓰기 경계와 승인 게이트 전체.
데이터 모델 — Pulson이 아는 것과 그 최신성.
가이드 — 작업 중심 how-to.
레퍼런스 와 용어집 — 나머지 문서가 전제하는 Amazon 광고 및 PulseAd 용어.