Umiejętności agenta interfejsu Google Ads API

Umiejętności agenta interfejsu Google Ads API to przenośne, samodzielne moduły wiedzy, instrukcji i przepływów pracy związanych z interfejsem Google Ads API. Umiejętności agenta interfejsu Google Ads API współpracują z asystentami AI, którzy obsługują otwarty standard umiejętności agenta, m.in. z Google Antigravity i Claude Code.

Te umiejętności agenta mają pomóc asystentom AI zrozumieć sprawdzone metody dotyczące interfejsu Google Ads API, skonfigurować narzędzia i wykonywać przepływy pracy z większą dokładnością i niższym kosztem tokenów. Listę dostępnych umiejętności znajdziesz w artykule Dostępne umiejętności.

Rozpocznij

Zainstaluj umiejętności agenta odpowiednie dla Twojego środowiska programistycznego.

Instalowanie umiejętności agenta interfejsu Google Ads API

W większości przypadków umiejętności agenta interfejsu Google Ads API można zainstalować w preferowanym edytorze za pomocą jednego polecenia:

Antigravity

Umiejętności agenta interfejsu Google Ads API są zawarte w jednym z pakietów integracyjnych Build with Google dla Antigravity. Możesz włączyć ten pakiet, aby uzyskać dostęp na poziomie globalnym, w 2 miejscach:

  • Podczas wprowadzania: zaznacz pole wyboru obok stosu interfejsu Google Ads API.
  • W Ustawieniach:
    1. Kliknij Ustawienia > Dostosowania.
    2. W sekcji Wtyczki Build with Google kliknij Dostosuj, a następnie kliknij Pobierz, aby pobrać integrację z interfejsem Google Ads API.

Jeśli wolisz dostęp na poziomie projektu, uruchom to polecenie w katalogu projektu:

npx skills add google/skills/skills/ads --agent=antigravity

Claude Code 

npx skills add google/skills/skills/ads --agent=claude-code

Codex 

npx skills add google/skills/skills/ads --agent=codex

Kursor

Umiejętności agenta interfejsu Google Ads API możesz zainstalować bezpośrednio, dodając punkt końcowy repozytorium GitHub umiejętności (np. https://github.com/google/skills) w ustawieniach edytora w sekcji reguł niestandardowych. Więcej informacji znajdziesz w dokumentacji Cursor dotyczącej instalowania umiejętności z GitHuba.

Możesz też zainstalować umiejętności za pomocą npx (wymaga Node.js):

npx skills add google/skills/skills/ads --agent=cursor

Inni agenci

W przypadku innych asystentów AI obsługujących otwarty standard umiejętności agenta możesz zainstalować umiejętności za pomocą npx (wymaga Node.js):

npx skills add google/skills/skills/ads

Aktualizowanie umiejętności agenta interfejsu Google Ads API

Możesz pobrać wszystkie dostępne aktualizacje i usunąć nieaktualne umiejętności, uruchamiając polecenie update:

Antigravity

Integracje włączone za pomocą Build with Google są zarządzane i aktualizowane automatycznie przez edytor.

Jeśli umiejętności agenta zostały zainstalowane za pomocą polecenia npx, możesz pobrać wszystkie dostępne aktualizacje, uruchamiając polecenie update:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Kursor 

npx skills update --all

Inni agenci

W przypadku innych asystentów AI obsługujących otwarty standard umiejętności agentów możesz zaktualizować wszystkie aktywne umiejętności za pomocą npx:

npx skills update --all

Korzystanie z umiejętności agenta interfejsu Google Ads API

Asystenci AI są zaprojektowani tak, aby automatycznie korzystać z umiejętności, gdy wykryją, że opis umiejętności pasuje do Twojej bieżącej prośby. Zainstalowane globalnie umiejętności pozostają nieaktywne w niepowiązanych projektach, chyba że kontekst prompta pasuje do zadań interfejsu Google Ads API.

Umiejętności można też wywołać ręcznie, wpisując / na czacie z agentem i wyszukując nazwę umiejętności.

Podstawowe elementy umiejętności

Każda umiejętność agenta to wyspecjalizowany pakiet, który zapewnia asystentowi AI te komponenty:

  • Specjalistyczne instrukcje: szczegółowe instrukcje promptu wstrzykiwane do okna kontekstu, które pomagają asystentowi generować zapytania GAQL, konfigurować dane uwierzytelniające OAuth i obsługiwać typowe kody błędów.
  • Sprawdzone metody: standardowe zalecenia dotyczące wydajności, bezpieczeństwa i integracji opracowane przez zespół DevRel interfejsu Google Ads API.
  • Skrypty automatyzacji: skrypty wykonywalne (np. do weryfikacji środowiska lub konfiguracji obszaru roboczego) zawarte w pakietach umiejętności, które umożliwiają wykonywanie zadań lokalnie.

Zalety korzystania z umiejętności

Umiejętności agenta rozszerzają możliwości asystenta o specjalistyczną wiedzę na żądanie bez konieczności wczytywania obszernych instrukcji do każdej rozmowy.

Niższe koszty tokenów

Konwencjonalne integracje AI często wczytują na początku ogromne ilości dokumentacji, co powoduje zużycie znacznej liczby tokenów i zwiększa koszty sesji. Umiejętności agenta wykorzystują stopniowe ujawnianie informacji, aby zminimalizować to obciążenie:

  • Asystent AI najpierw sprawdza tylko nazwę i opis umiejętności, aby określić, czy jest ona odpowiednia do Twojego zadania.
  • Pełne instrukcje i odniesienia dotyczące umiejętności są dodawane do aktywnego okna kontekstu tylko wtedy, gdy asystent uzna, że są one niezbędne do wykonania konkretnego zadania, co pozwala zaoszczędzić miejsce w kontekście.

Wdrażanie z pomocą AI

Zamiast ręcznie przeszukiwać dokumentację, możesz opisać swoje intencje w języku naturalnym. Umiejętności pomagają asystentowi AI wykonywać zadania takie jak:

  • Wygeneruj zapytanie GAQL, aby pobrać z mojego konta wskaźniki skuteczności kampanii.
  • Napisz skrypt w Pythonie, który używa bibliotek klienta do utworzenia nowej kampanii.
  • Pobieranie konwersji z kampanii i danych diagnostycznych za pomocą interfejsu Google Ads API

Pełną listę dostępnych umiejętności znajdziesz w sekcji Dostępne umiejętności.

Korzystanie z umiejętności wraz z serwerem MCP interfejsu Google Ads API

Umiejętności agenta zostały zaprojektowane tak, aby uzupełniać serwer Model Context Protocol (MCP) interfejsu Google Ads API:

  • Serwer MCP interfejsu Google Ads API: zaprojektowany na potrzeby procesów programistycznych wspomaganych przez AI, umożliwia asystentom AI automatyczną interakcję z zasobami, kampaniami i danymi interfejsu Google Ads API.
  • Umiejętności agenta interfejsu Google Ads API: podawaj instrukcje i zalecane praktyki, które pomogą asystentowi wykonywać zadania dzięki stopniowemu ujawnianiu informacji z wykorzystaniem tokenów. Instruują agenta, jak skutecznie korzystać z narzędzi takich jak serwer MCP i biblioteki klienta.

Dostępne umiejętności

Zespół ds. interfejsu Google Ads API udostępnia zestaw umiejętności, które pomogą Ci tworzyć aplikacje za pomocą interfejsu Google Ads API:

Umiejętność Opis
google-ads-api-account-diagnostics Diagnozuje problemy z wydajnością konta Google Ads, takie jak utrata konwersji, mała liczba potencjalnych klientów i utracony udział w wyświetleniach z powodu rankingu reklamy, stawek lub budżetów, za pomocą serwera MCP interfejsu Google Ads API.
google-ads-api-mcp-setup Pomaga w konfigurowaniu serwera Model Context Protocol (MCP) interfejsu Google Ads API, upraszczając uwierzytelnianie i konfigurację w środowiskach lokalnych.
google-ads-api-quickstart Przewodnik po konfigurowaniu środowiska programistycznego i danych logowania oraz wykonywaniu pierwszego wywołania interfejsu Google Ads API.

Dalsze kroki