어시스턴트는 일반적인 챗봇이 아닙니다. Google Antigravity 및 Claude Code 에이전트 프레임워크 (v4.0.0)를 기반으로 빌드된 AI 기반 광고 엔지니어링을 위한 전문화된 미션 제어 시스템입니다.
전체적인 그림: 높은 규정 준수 마찰 해결
이 어시스턴트가 해결하는 근본적인 문제는 인지 과부하와 기술적 반복 업무입니다.
Google Ads API는 가장 강력한 API 중 하나이지만 가장 복잡한 API 중 하나이기도 합니다. 엄격한 버전 관리, 고유한 쿼리 언어(GAQL), 깊이 중첩된 프로토콜 버퍼 구조, 엄격한 안전 요구사항이 특징입니다. 개발자는 실제 비즈니스 로직을 빌드하는 대신 gRPC 오류를 디버깅하고, 필드 호환성을 조회하고, 린터 문제를 해결하는 데 상당한 시간을 소비하는 경우가 많습니다.
어시스턴트는 전문화된 테스트 지원 스킬 과 기본 제공 슬래시 명령어를 기반으로 하는 모듈식 플러그인 아키텍처 를 도입하여 버전 4.0.0에서 이 문제를 해결합니다. 자동화된 전문가 미들웨어 역할을 하며 버전 유효성 검사, 스키마 검색, 코드 린팅의 수고를 처리하므로 개발자는 구문이 아닌 의도 수준에서 작업할 수 있습니다.
추측이 아닌 공식 스키마 기반
표준 대규모 언어 모델은 새로운 API 버전이 출시됨에 따라 빠르게 구식이 되는 일반 학습 데이터에만 의존하기 때문에 도메인별 API에 어려움을 겪는 경우가 많습니다.
Google Ads API 개발자 어시스턴트는 삽입된 Google Ads API 아키텍처 규칙과 동적 로컬 Protobuf 스키마 검사를 결합하여 이 문제를 해결합니다.
- 결정적 유효성 검사: 어시스턴트는 여러 왕복에서 반복적인 LLM 추측에 의존하는 대신 필드 호환성, 리소스 관계, 노출수 0 규칙, 날짜 세분화를 한 번에 확인하는 로컬 4단계 유효성 검사 파이프라인을 실행합니다.
- 버전별로 정확한 스키마 조회: 활성 API 버전의 공식 API 스키마에서 직접 Protobuf 리소스 정의, 데이터 유형, enum 값을 검사하여 반복적인 원격 메타데이터 쿼리를 방지합니다.
- 공식 클라이언트 라이브러리 기반: 코드 생성은 Python, Java, PHP, .NET, Ruby 전반의 공식 Google Ads 클라이언트 라이브러리를 기반으로 합니다.
유사점: 전문 연구 및 진단 실험실
어시스턴트를 외과 의사를 위한 첨단 연구 실험실이라고 생각해 보세요.
- 외과 의사 (개발자): 수행해야 할 수술을 정확히 알고 있습니다 (예: 'PMax 실적을 분석해야 합니다').
- 실험실 장비 (API): 수술을 수행하는 데 필요한 강력한 도구이지만 정교하며 정확한 보정이 필요합니다.
- 실험실 어시스턴트 (이 도구): 환자를 만지기 전에 실험실 어시스턴트는 전문화된 스킬 과 기본 제공 명령어를 사용하여 다음 작업을 실행합니다.
- 매뉴얼 확인: 최신 API 프로토콜을 자동으로 확인하고 리소스 구조를 즉석에서 검사합니다 (
inspect_object//inspect-object). - 도구 사전 테스트: 실시간 API 유효성 검사 (
validate_gaql//validate-gaql)를 사용하여 쿼리에 결정적 드라이 런을 실행하여 오류가 발생하기 전에 포착합니다. - 환경 살균: 엄격한 린터 파이프라인 (
ruff린팅)을 사용하여 코드를 포맷하고 정리하므로 시스템 오류가 발생하지 않습니다. - 활력 징후 모니터링: API 예외를 감시하고 오프라인 전환과 같은 복잡한 작업에 대한 고급 진단 워크플로를 실행합니다(
troubleshoot_conversions//troubleshoot-conversions). - 개념 설명: 실제 유사점을 사용하여 일상적인 언어로 복잡한 개념을 설명합니다 (
/explain,/step-by-step,/assistant-tutorial).
- 매뉴얼 확인: 최신 API 프로토콜을 자동으로 확인하고 리소스 구조를 즉석에서 검사합니다 (
상호 연결성: '안전 우선' 브리지
어시스턴트는 제어 계약 (AGENTS.md / CLAUDE.md)에 의거하여 관리되는 프로젝트 내의 4가지 고유한 '세계'를 연결하는 브리지 역할을 합니다.
- 사용자 컨텍스트: 상위 수준 목표를 수신하고 이를 기술 전략으로 변환합니다.
- 로컬 작업공간: 프로젝트 디렉터리에 '눈과 손'이 있습니다. 기존 코드를 읽고 나중에 사용할 새 코드를 작성하여 엄격한 격리를 유지할 수 있습니다.
- Google Ads API: 실시간 API에 연결하여 읽기 전용 보고서를 실행하고 계정에 대해 쿼리를 테스트합니다. 즉각적인 필드 유효성 검사를 위해 로컬 Protobuf 스키마를 직접 검사합니다.
- 안전 게이트키퍼: 엄격한 프로토콜을 따르도록 하드와이어링되어 있습니다. 린팅되지 않은 스크립트는 실행할 수 없으며 프로그래매틱 유효성 검사 체크를 통과하지 않은 쿼리는 전송할 수 없습니다.
어시스턴트가 실제로 하는 일
간단히 말해 어시스턴트는 보호 장치이자 가속기입니다.
- 실수를 방지합니다: 실행 전에 활성 API 스키마에 대해 코드와 쿼리의 유효성을 검사하여 구문 및 호환성 오류가 실시간 API에 도달하기 전에 중지합니다.
- 지도를 알고 있습니다: Google Ads API의 지리적 위치(데이터가 있는 위치와 효율적으로 쿼리하는 방법)를 이해합니다.
- 지루한 작업을 자동화합니다: 상용구 클라이언트 라이브러리 코드를 작성하고, 보고서를 깔끔한 터미널 표로 포맷하고, 클라이언트 라이브러리 배관을 처리합니다.
- 복잡한 워크플로 문제 해결: 오프라인 전환 업로드에 대한 심층 진단을 실행하고, MCC 계정 계층 구조를 해결하고, 실적 최대화 목록 필터 및 URL 제외와 같은 복잡한 캠페인 구조를 구성합니다.
- 실시간 임시 보고서 스트리밍: 일반 영어로 실적 데이터를 요청하면 어시스턴트가 계정에 대해 직접 GAQL 쿼리를 구성, 검증, 실행하여 포맷된 결과를 터미널로 스트리밍하거나 CSV로 내보냅니다.
- 최신 상태 유지: 활성 API 버전의 로컬 Protobuf 스키마와 문서를 검사하여 지원 중단된 필드와 오래된 규칙을 방지할 수 있습니다.
Google Ads API 개발자 어시스턴트는 '개발자 대 API'의 어려움을 안전하고 관용적이며 아키텍처적으로 건전한 코드를 생성하는 '개발자 + AI' 협업으로 전환합니다.
아키텍처 및 성능 (v4.0.0)
버전 4.0.0에서는 어시스턴트를 독립형 프로젝트 설정에서 최신 글로벌 플러그인 아키텍처로 전환합니다.
- 데몬 오버헤드 없음: 스킬 및 진단 명령어는 호출될 때만 경량 하위 프로세스로 일시적으로 실행되며 유휴 상태일 때 시스템 리소스 사용량을 0으로 줄입니다.
- 점진적 컨텍스트 공개: 규칙과 스키마는 활성 작업과 관련된 경우에만 주문형으로 로드되므로 토큰 소비와 프롬프트 지연 시간이 크게 줄어듭니다.
- 디스크 I/O 감소: 플러그인 트리에서 불필요한 SDK 파일을 삭제하면 IDE 색인 생성기, 린터, 파일 감시자가 수만 개의 사용되지 않는 파일을 검사하지 못하도록 방지합니다.
- 멀티 플랫폼 호스트 지원: Linux, macOS, Windows에서 통합 설치 스크립트를 사용하여 Google Antigravity 및 Claude Code 환경 전반에서 원활하게 작동합니다.