Kalendarz
Podłączenie Google Kalendarza do autonomicznego agenta AI
Google Kalendarz koncentruje spotkania i dostępność całej firmy. Agent Atako może proponować terminy, tworzyć wydarzenia i wykrywać konflikty, nigdy nie widząc Twojego hasła do Google.
Wkrótce dostępne — załóż konto, a powiadomimy Cię, gdy tylko ta integracja będzie gotowa.
Możliwe scenariusze
Umawianie spotkania z klientem bez wielokrotnej wymiany wiadomości
Handlowiec lub zespół wsparcia otrzymuje prośbę o spotkanie. Agent sprawdza wolne terminy za pomocą check_availability w odpowiednim kalendarzu, proponuje dwa lub trzy pasujące terminy, a następnie tworzy wydarzenie za pomocą create_event po potwierdzeniu wybranego terminu. Zaproszenie trafia automatycznie do uczestników zaraz po utworzeniu wydarzenia, jeśli grant create_event ma zakres zapisu; bez niego agent ogranicza się do wypisania dostępnych terminów w przygotowanej wiadomości, nigdy samodzielnie nie umawiając spotkania.
Wykrywanie konfliktów i podwójnych rezerwacji
Agent listuje nadchodzące wydarzenia za pomocą list_events, wykrywa dwa nakładające się spotkania lub spotkanie pozostające niepotwierdzone od kilku dni, i przygotowuje propozycję rozwiązania. Sam niczego nie przesuwa ani nie anuluje: cancel_event i update_event pozostają odrębnymi działaniami, przyznawanymi osobno, jeśli firma chce, aby agent działał bezpośrednio, zamiast jedynie zgłaszać konflikt organizatorowi.
Szukanie wspólnego terminu na rozmowę kwalifikacyjną lub spotkanie zespołu
Aby zorganizować rozmowę kwalifikacyjną lub spotkanie angażujące kilka kalendarzy, agent listuje dostępne kalendarze za pomocą list_calendars, sprawdza ich dostępność za pomocą check_availability, a następnie identyfikuje pierwszy wspólny termin w żądanym okresie. Tworzy wydarzenie dopiero po zatwierdzeniu tego terminu przez człowieka, chyba że create_event zostało wyraźnie przyznane, aby w pełni zautomatyzować umawianie.
Akcje konektora
list_events
Odczyt. Wylistowanie wydarzeń kalendarza w danym okresie.
get_event
Odczyt. Pobranie pełnych szczegółów wydarzenia, wraz z uczestnikami.
search_events
Odczyt. Wyszukanie wydarzeń zapytaniem tekstowym.
check_availability
Odczyt. Sprawdzenie wolnych i zajętych terminów jednego lub kilku kalendarzy.
list_calendars
Odczyt. Wylistowanie kalendarzy dostępnych dla podłączonego konta.
create_event
Zapis. Utworzenie wydarzenia wraz z jego uczestnikami.
update_event
Zapis. Zmodyfikowanie istniejącego wydarzenia: godziny, uczestników lub opisu.
respond_to_event
Zapis. Odpowiedź na otrzymane zaproszenie: akceptacja, odmowa lub wstępna.
add_attendee
Zapis. Dodanie uczestnika do istniejącego wydarzenia.
cancel_event
Zapis. Anulowanie istniejącego wydarzenia w kalendarzu.
Wymagania wstępne
- Rola admina w firmie Atako, aby podłączyć integrację.
- Konto Google, osobiste lub Workspace, którego kalendarz ma zostać podłączony.
- Zgoda OAuth Google, scope https://www.googleapis.com/auth/calendar.events.
- Jawny grant dla każdego agenta, w szczególności dla create_event i cancel_event.
Jak połączyć
- 1
Otworzyć Ustawienia → Integracje
Admin wybiera Google Kalendarz z listy dostępnych konektorów.
- 2
Sprawdzić udostępniane działania
Okno pokazuje wszystkie działania kalendarza, odczytu i zapisu, przed autoryzacją.
- 3
Uwierzytelnić się przez ekran Google
Przekierowanie do zgody Google, żadne hasło nie trafia do Atako.
- 4
Przyznać dostęp agentowi
Wybiera się precyzyjne działania dla każdego agenta, na przykład same check_availability i list_events, aby pozostać tylko w odczycie.
Dlaczego podłączyć autonomicznego agenta do Google Kalendarza
Google Kalendarz koncentruje spotkania i dostępność dla dużej części firm, zwłaszcza tych korzystających z Google Workspace. Autonomiczny agent podłączony do niego nie ogranicza się do odpowiadania na jednorazowe polecenie: działa nieprzerwanie i decyduje, zależnie od otrzymanej instrukcji, o sprawdzeniu wolnego terminu, wykryciu konfliktu lub zaproponowaniu spotkania, dzięki tool calling.
Połączenie wykorzystuje OAuth 2.0 i scope Google Kalendarza calendar.events (scopes OAuth od Google). Ten scope pozwala czytać, tworzyć i modyfikować wydarzenia kalendarza, nigdy nie usuwać samego konta Google ani zmieniać jego ustawień bezpieczeństwa.
To właśnie sprawia, że użyteczny jest przepływ taki jak szukanie wspólnego terminu na rozmowę kwalifikacyjną, bliski temu, co robi agent operacji HR, lub umawianie spotkania handlowego, bliskie agentowi operacji przychodowych: odbiera prośbę i przygotowuje kolejny krok (termin, wydarzenie, przypomnienie potwierdzające), bez czekania, aż człowiek otworzy swój kalendarz, by ręcznie porównać dostępność kilku osób. Google Kalendarz należy do integracji objętych planem Standard, bez osobnej pozycji rozliczeniowej za konektor.
Ograniczenia i dobre praktyki
Najbardziej wrażliwym działaniem konektora jest create_event: raz przyznane w zakresie zapisu, agent umawia spotkanie, a Google automatycznie wysyła zaproszenie do wszystkich uczestników, bez ponownego kontaktu z Tobą. Najbezpieczniejszą praktyką jest przyznanie wyłącznie check_availability i list_events: agent proponuje terminy, a człowiek tworzy ostateczne wydarzenie i sam wysyła zaproszenia.
Scope calendar.events obejmuje cały kalendarz podłączonego konta, nie jeden konkretny kalendarz pomocniczy. Rzeczywiste ograniczenie wynika więc z grantu: wylistuj dokładne działania, których agent potrzebuje, na przykład sam odczyt do prostego wglądu, zamiast przyznawać tworzenie i anulowanie naraz przy podłączeniu.
update_event i cancel_event zmieniają lub usuwają istniejące wydarzenie, również dla pozostałych uczestników, jeśli zaakceptowali już pierwotne zaproszenie. Zarezerwuj te dwa działania dla agenta, którego rola rzeczywiście tego wymaga, i trzymaj cancel_event osobno od create_event w grancie, jeśli chcesz, aby mógł proponować, nigdy nie mogąc anulować.
Dokumentacja nie wspomina o limicie przepustowości właściwym dla konektora Google Kalendarza, obowiązują standardowe limity API Google Calendar. Każde wywołanie, wysłane lub odrzucone, pozostaje dostępne w dzienniku audytu na stronie agenta. I jak w przypadku każdego konta OAuth, jeśli token wygaśnie lub zostanie odwołany po stronie Google, połączenie przechodzi w status błędu do ponownego podłączenia.
Powiązane przypadki użycia
Powiązane integracje
Najczęstsze pytania
Czy agent może utworzyć spotkanie i wysłać zaproszenie bez zatwierdzenia?
Tak, jeśli grant obejmuje create_event w zakresie zapisu, agent tworzy wtedy wydarzenie, a Google automatycznie wysyła zaproszenie do uczestników. Większość firm woli ograniczyć agenta do check_availability i list_events: proponuje terminy, a ostateczne spotkanie tworzy człowiek.
Czy trzeba mieć płatny plan, aby podłączyć Google Kalendarz?
Tak, potrzebny jest aktywny plan Atako, ale Google Kalendarz należy do integracji już objętych planem Standard, bez dodatkowej opłaty za konektor.
Jak odwołać dostęp Atako do mojego kalendarza Google?
Z poziomu Ustawienia → Integracje kliknij Revoke przy połączeniu Google Kalendarz. Zaszyfrowany token zostaje natychmiast usunięty, a wszystkie agenty, które z niego korzystały, od razu tracą dostęp.
Czy scope calendar.events pozwala widzieć kalendarze innych współpracowników?
Nie, ten scope obejmuje wyłącznie podłączone konto Google. Agent widzi kalendarz współpracownika tylko wtedy, gdy został on wcześniej wyraźnie udostępniony temu kontu, i tylko w granicach tego udostępnienia.
Co przeczytać dalej
Źródła
- Google Calendar API, dokumentacja referencyjna · dostęp dnia 7 września 2026
- OAuth 2.0 Scopes for Google APIs · dostęp dnia 7 września 2026
CTO w Atako
Ta treść została napisana przez agentów AI firmy Atako, a następnie sprawdzona, poprawiona i zatwierdzona przez Romaina Laodicinę, CTO Atako.