Umiejętności agenta interfejsu Google Ads API

Umiejętności agenta 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óre obsługują otwarty standard umiejętności agenta, w tym Google Antigravity i Claude Code.

Te umiejętności agenta mają pomagać asystentom AI w poznawaniu sprawdzonych metod korzystania z interfejsu Google Ads API, konfigurowaniu narzędzi i wykonywaniu procesów z większą dokładnością i mniejszym 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 ulubionym edytorze za pomocą jednego polecenia:

Antigravity

Umiejętności agenta interfejsu Google Ads API są dostępne w ramach jednego z pakietów integracyjnych Build with Google dla Antigravity. Ten pakiet możesz włączyć na poziomie globalnym w 2 miejscach:

  • Podczas wdrażania: zaznacz pole wyboru stosu interfejsu Google Ads API.
  • W Ustawieniach:
    1. Kliknij Ustawienia > Dostosowywanie.
    2. W sekcji Twórz za pomocą wtyczek Google kliknij Dostosuj, a potem 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 --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

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 reguł kursora.

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

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ą funkcji Twórz z 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 

claude plugin update google-ads@skills

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ą tego kodu: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 Twojego bieżącego żądania. Umiejętności zainstalowane globalnie pozostają nieaktywne w niepowiązanych projektach, chyba że kontekst promptu pasuje do zadań interfejsu Google Ads API.

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

Podstawowe komponenty umiejętności

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

  • Specjalistyczne instrukcje: szczegółowe instrukcje promptu wstrzykiwane do okna kontekstu, aby pomóc asystentowi w generowaniu zapytań GAQL, konfigurowaniu danych uwierzytelniających OAuth i obsłudze typowych kodów błędów.
  • Sprawdzone metody: standardowe rekomendacje dotyczące wydajności, bezpieczeństwa i integracji, które zostały opracowane przez zespół DevRel interfejsu Google Ads API.
  • Skrypty automatyzacji: wykonywalne skrypty (np. do weryfikacji środowiska lub konfigurowania obszaru roboczego) zawarte w pakietach umiejętności, które służą do wykonywania zadań lokalnie.

Zalety korzystania z umiejętności

Umiejętności agenta rozszerzają możliwości asystenta o specjalistyczną wiedzę na żądanie bez obciążania każdej rozmowy obszernymi instrukcjami.

Obniżone koszty tokenów

Tradycyjne integracje AI często z góry wczytują ogromne ilości dokumentacji, co zużywa znaczną liczbę tokenów i zwiększa koszty sesji. Umiejętności agenta korzystają z progresywnego ujawniania informacji, aby zminimalizować ten narzut:

  • Asystent AI początkowo sprawdza tylko nazwę i opis umiejętności, aby określić, czy jest ona odpowiednia do Twojej prośby.
  • Pełne instrukcje i odniesienia do 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.

Wdrożenie 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 dane o skuteczności kampanii.
  • Napisz skrypt w Pythonie, który za pomocą bibliotek klienta utworzy nową kampanię.
  • Pobieranie konwersji w 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 w połączeniu z serwerem MCP interfejsu Google Ads API

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

  • Serwer MCP interfejsu Google Ads API: zaprojektowany z myślą o przepływach pracy wspomaganych przez AI, umożliwia asystentom AI interakcję z zasobami, kampaniami i statystykami interfejsu Google Ads API w sposób programowy.
  • Umiejętności agenta interfejsu Google Ads API: podawanie szybkich instrukcji i rekomendowanych praktyk, które pomagają asystentowi wykonywać zadania za pomocą progresywnego ujawniania informacji przy efektywnym wykorzystaniu tokenów. Zawierają one instrukcje dla agenta dotyczące skutecznego korzystania z narzędzi takich jak serwer MCP i biblioteki klienta.

Dostępne umiejętności

Zespół interfejsu Google Ads API udostępnia zestaw umiejętności związanych z korzystaniem z tego interfejsu:

Umiejętność Opis
google-ads-api-mcp-setup Pomaga w konfigurowaniu serwera protokołu Model Context Protocol (MCP) interfejsu Google Ads API, upraszczając uwierzytelnianie i konfigurację w środowiskach lokalnych.
google-ads-api-quickstart Przeprowadzi Cię przez proces konfigurowania środowiska deweloperskiego, danych logowania i wykonywania pierwszego wywołania interfejsu Google Ads API.

Dalsze kroki