AOP CLI FAQ

aop 커맨드라인에 대한 짧은 답. 전체 안내는 커맨드라인 (aop), 제품은 Pulson FAQ 참고.

AOP CLI가 뭔가요?

aop(또는 aop-hermes)는 PulseAd의 Agentic Operations 커맨드라인 — 직원이 터미널에서 Amazon 광고 계정을 운영하는 도구로, 브랜드별 워크스페이스가 Pulse Library·Memory API·Snowflake/Aurora·번들 Amazon Ads / AMC / 분석 도구에 연결됩니다.

Pulson과 같은 건가요?

아니요. aop는 PulseAd 직원용 오퍼레이터 도구이고, Pulson은 고객 제품입니다. 데이터 백엔드를 공유하지만 aop는 별개 표면이며, 결정적으로 쓰기가 Pulson의 제안→승인 게이트 뒤가 아닙니다(도구별 dry-run만).

어떻게 설치하나요?

uv로 GitHub에서:

uv tool install --python 3.11 "git+https://github.com/PulseAd/aop-hermes.git@main"

전제: uv, Python 3.11, 로컬 Pulse Library. 전체 단계는 커맨드라인 (aop).

어떻게 연결하나요?

aop setup 실행 — Pulse Library 위치, Memory API, 모델/제공자/인증을 거쳐 GENERAL 워크스페이스를 등록하고 doctor를 실행. 연결 참고.

시크릿은 어디에 두나요?

AOP 도메인 시크릿(Memory API 키, Snowflake/Aurora 자격증명, Snowflake RSA 키)은 $AOP_HOME/shared.env(gitignore — 절대 커밋 금지). LLM 제공자 키는 Hermes가 관리하며 shared.env에 두지 않습니다.

워크스페이스 / 브랜드 코드가 뭔가요?

워크스페이스는 general(공유 GENERAL) 또는 brand. 브랜드 스코프 코드는 대문자(예: ACME)로, Pulse Library의 docs/<BRAND_CODE>에 매핑되고 자체 격리 HERMES_HOME을 받습니다. aop launch <BRAND_CODE>로 진입.

aop는 제품의 승인 게이트를 거치나요?

아니요. ~45개 Amazon Ads 쓰기 액션이 도구별 dry_run 플래그로만 보호됩니다 — 제품 같은 제안→승인 밸브가 없습니다. 직원이 쓰는 강력한 오퍼레이터 도구로 취급하세요.

업데이트·리셋은 어떻게 하나요?

aop update가 GitHub main에서 자체 업데이트하고 스킬을 동기화. aop clean --dry-run은 $AOP_HOME 리셋이 무엇을 지울지 보여주고, aop clean --yes는 실행합니다(바이너리는 유지 — 제거는 uv tool uninstall aop-hermes).

실제로 무엇에 연결되나요?

Pulse Library(브랜드 docs), AOP Memory API, Snowflake와 Aurora, 그리고 번들 aop-tools(Amazon Ads, AMC, 분석, 페이싱, RTB, 리포트). 무엇에 연결되는가 참고.