Umiejętności agenta interfejsu Google Ads API

Umiejętności agenta interfejsu Google Ads API to przenośne, samodzielne moduły zawierające wiedzę, instrukcje i przepływy pracy dotyczące interfejsu Google Ads API. Umiejętności agenta interfejsu Google Ads API działają z asystentami AI , którzy obsługują otwarty standard umiejętności agenta, w tym 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 sekcji 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ą dostępne jako jeden z pakietów integracji Build with Google dla Antigravity. Ten pakiet możesz włączyć na 2 sposoby, aby uzyskać dostęp na poziomie globalnym:

  • Podczas wdrażania: zaznacz pole wyboru stosu interfejsu Google Ads API.
  • W ustawieniach:
    1. Wybierz Ustawienia > Dostosowania.
    2. W sekcji Wtyczki Build with Google kliknij Dostosuj, a potem kliknij Pobierz w przypadku integracji 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 Kursora na temat instalowania umiejętności z GitHuba.

Umiejętności możesz też zainstalować 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

Aby pobrać wszystkie dostępne aktualizacje i usunąć nieaktualne umiejętności, uruchom polecenie update:

Antigravity

Integracje włączone za pomocą Build with Google są zarządzane i automatycznie aktualizowane 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 agenta 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 bieżącego żądania. Umiejętności zainstalowane globalnie pozostają nieaktywne w niezwiązanych projektach, chyba że kontekst prompta pasuje do zadań interfejsu Google Ads API.

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

Podstawowe komponenty umiejętności

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

  • Specjalistyczne instrukcje: szczegółowe instrukcje prompta wstawiane do okna kontekstu, aby pomóc asystentowi w generowaniu zapytań GAQL, konfigurowaniu danych logowania OAuth i obsłudze typowych kodów błędów.
  • Sprawdzone metody: standardowe zalecenia dotyczące skuteczności, bezpieczeństwa i integracji określone przez zespół DevRel interfejsu Google Ads API.
  • Skrypty automatyzacji: skrypty wykonywalne (np. do sprawdzania środowiska lub konfigurowania 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

Tradycyjne integracje AI często wczytują z góry ogromne ilości dokumentacji, co zużywa znaczną liczbę tokenów i zwiększa koszty sesji. Umiejętności agenta minimalizują ten narzut dzięki progresywnemu ujawnianiu informacji:

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

Implementacja z pomocą AI

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

  • Wygeneruj zapytanie GAQL, aby pobrać wskaźniki skuteczności kampanii z mojego konta.
  • Napisz skrypt w Pythonie, który używa bibliotek klienta do utworzenia nowej kampanii.
  • Pobierz konwersje kampanii i dane diagnostyczne 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 razem 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 do przepływów pracy związanych z tworzeniem aplikacji z pomocą AI, umożliwiający asystentom AI programowe interakcje z zasobami interfejsu Google Ads API, kampaniami i danymi.
  • Umiejętności agenta interfejsu Google Ads API: zawierają instrukcje prompta i sprawdzone metody, które pomagają asystentowi wykonywać zadania za pomocą progresywnego ujawniania informacji, co pozwala oszczędzać tokeny. Instruują agenta, jak skutecznie korzystać z narzędzi takich jak serwer MCP i biblioteki klienta.

Dostępne umiejętności

Zespół interfejsu Google Ads API udostępnia pakiet umiejętności do tworzenia aplikacji 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, niska liczba kontaktów do potencjalnych klientów i utracony udział w wyświetleniach z powodu rankingu reklam, 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 Pomaga w konfigurowaniu środowiska programistycznego, danych logowania i wykonywaniu pierwszego wywołania interfejsu Google Ads API.

Dalsze kroki