Všetky projekty
AI a automatizácia V prevádzke

Ads Agent — AI asistent pre Google Ads dáta

Interný webový chat, v ktorom sa PPC tím môže pýtať na Google Ads dáta bežnou rečou. Namiesto ručného hľadania v rozhraní alebo čakania na špecialistu dostane odpoveď za pár sekúnd.

Klient
Interný nástroj pre veľký e-commerce brand
Rola
Samostatne od návrhu po nasadenie
Tím
Tím 5-6 používateľov

Použité technológie

  • Python 3.13
  • Google Agent Development Kit (ADK)
  • Gemini 3 Flash Preview
  • Model Context Protocol (MCP)
  • FastAPI / Starlette
  • OAuth 2.0
  • Google Cloud Run
  • Secret Manager

Dopad

Čo umožňuje
PPC tím sa môže pýtať na výkon kampaní bežnou rečou a dostáva odpovede zo živých dát. Menej ručných reportov, menej čakania, rýchlejšie rozhodnutia.
Cena prevádzky
Pod 1 € denne pri tímovej záťaži; Cloud Run škáluje na nulu pri nečinnosti
Doba vývoja
Dva sústredené dni, samostatne
Používatelia
PPC tím, prístup obmedzený OAuth 2.0 na firemnú doménu

Čo to umožňuje

Ktokoľvek v PPC tíme sa môže opýtať Google Ads účtu otázku bežnou rečou a dostane odpoveď zo živých dát. Bez znalosti Google Ads API, bez nového dashboardu a bez čakania na kolegu, ktorý vie pripraviť zložitejší report.

Pre tím to znamená, že bežné analytické otázky sa dajú riešiť hneď. Napríklad: ktoré kampane minuli najviac peňazí za posledných 14 dní, kde padol ROAS alebo ktoré produkty v PMax kampani treba skontrolovať.

Nástroj vznikol za dva sústredené dni, beží lacno a prístup je obmedzený na firemné účty.

Prečo to dáva zmysel

Technológie sú tu dôležité hlavne preto, že umožnili postaviť praktický interný nástroj bez veľkého vývojového tímu:

  • Gemini spracuje otázku a pripraví odpoveď.
  • Google Ads MCP server je bezpečné prepojenie na Google Ads účet.
  • Cloud Run a firemné prihlásenie zabezpečia, že nástroj beží ako interná webová aplikácia a nepúšťa dnu cudzích používateľov.

Výsledkom nie je ukážka AI, ale pracovný nástroj pre tím.

Ako to funguje

Používateľ sa prihlási firemným Google účtom, otvorí webový chat a položí otázku. AI pripraví dotaz na Google Ads, nástroj si prečíta dáta z účtu a vráti odpoveď v zrozumiteľnej forme. Prístup je obmedzený na firemnú doménu a nástroj má iba čítacie oprávnenia.

Browser (firemný používateľ)
   │ HTTPS + session cookie

Cloud Run (ads-agent-v2)
├── Starlette OAuth middleware (hd=firemna-domena)
└── ADK LlmAgent

       ├──► Vertex AI: gemini-3-flash-preview (global)

       └──► google-ads-mcp subprocess (stdio)
                │ OAuth refresh token (Secret Manager)

           Google Ads API (read-only)

Kľúčové výzvy

1. Oddelenie prístupov pre AI a Google Ads

Prvé verzie miešali prístupy pre Google Ads a Vertex AI. Výsledok bol, že jedna časť systému sa pokúšala použiť nesprávne oprávnenia a požiadavky padali.

Riešenie: oddeliť prístupy tak, aby AI používala vlastnú identitu a Google Ads nástroj vlastné prístupové údaje. Tým sa odstránil konflikt.

2. Aktuálny dátum pre AI

Pri otázke typu „posledných 7 dní“ AI najprv nevedela spoľahlivo určiť dnešný dátum. To je pri reklamných dátach zásadný problém.

Riešenie: pri štarte aplikácie sa do inštrukcií pre AI doplní aktuálny dátum a model má preferovať relatívne obdobia, napríklad „posledných 7 dní“.

3. Prihlásenie a verejná dostupnosť služby

Cloud Run služba musí byť technicky dostupná z internetu, aby sa používateľ vedel dostať na prihlasovaciu stránku. Skutočné obmedzenie prístupu sa rieši až v aplikácii cez firemné Google prihlásenie.

Kľúčové poučenia

  • Overiť dostupnosť modelu pred nasadením. Rýchly test ušetrí zbytočný build a hľadanie chyby až po nasadení.
  • AI potrebuje aktuálny dátum. Každý nástroj, ktorý pracuje s časovými obdobiami, musí mať jasne zadané, čo je „dnes“.
  • Jedna časť systému, jedna identita. Ak Google Ads a AI používajú rôzne prístupy, musia byť striktne oddelené.
  • Prihlásenie a infraštruktúrne práva sú dve vrstvy. Nestačí nastaviť iba Cloud Run alebo iba OAuth. Musia spolu dávať zmysel.
  • Bezpečnostné pravidlá pre AI treba testovať. Nestačí napísať do promptu „toto nikdy neukazuj“. Treba overiť, ako sa model správa pri hraničných otázkach.

Stav a ďalšie kroky

Služba beží na Cloud Run a prístup je chránený firemným Google prihlásením. Ďalší krok je lepšie auditovanie otázok a odpovedí, obmedzenie rýchlosti používania a trvalejšie ukladanie relácií, ak to objem používania začne vyžadovať.

Pracujete na podobnom?

Krátky úvodný hovor, žiadne záväzky.

Napísať mi