Produktywność i dokumenty

Połączenie Notion z autonomicznym agentem AI

Agent Atako połączony z Notion może odczytywać Twoje strony i bazy oraz tworzyć lub modyfikować nowe, ale tylko te, które wyraźnie z nim udostępniłeś.

Napisane przez agentów Atako · Sprawdzone i zatwierdzone przez Romain Laodicina · CTO w Atako

Możliwe scenariusze

Cotygodniowa aktualizacja bazy śledzenia

Agent odpytuje bazę Notion (projekty, kandydaci, konta klientów) przez query_database, zestawia dane otrzymane emailem lub z innego konektora, tworzy nowe wpisy przez create_page i aktualizuje istniejące wpisy przez update_page. Format i właściwości bazy pozostają takie, jakie zdefiniował Twój zespół, agent jedynie wypełnia bazę szybciej, niż zrobiłby to człowiek każdego poniedziałku rano.

Ustrukturyzowane notatki ze spotkań

Na podstawie podsumowania spotkania otrzymanego innym kanałem agent tworzy stronę we właściwym folderze (create_page), a następnie strukturyzuje ją akapitami kontekstu (append_paragraph), listą decyzji (append_bulleted_list) i listą zadań do zaznaczenia dla każdego uczestnika (append_to_do). Punkty wymagające uwagi są wyróżnione za pomocą callout, aby rzucały się w oczy przy ponownej lekturze.

Okresowe archiwizowanie bazy wiedzy

Agent odpytuje bazę filtrowaną po dacie ostatniej modyfikacji (query_database), wychwytuje strony, które nie zmieniły się od miesięcy, zostawia komentarz wyjaśniający, dlaczego proponuje ich archiwizację (create_comment), a następnie je archiwizuje (archive_page). Nic nie ginie: zarchiwizowana strona pozostaje dostępna i można ją ręcznie przywrócić w razie potrzeby, co zapobiega gromadzeniu się baz przeładowanych nieaktualną treścią, której nikt już nie czyta.

Akcje konektora

  • query_database (odczyt)

    Odpytuje bazę z filtrami i sortowaniem.

  • search (odczyt)

    Wyszukuje udostępnione strony lub bazy po tytule.

  • get_page (odczyt)

    Pobiera stronę i jej właściwości.

  • get_database (odczyt)

    Pobiera schemat bazy.

  • list_block_children (odczyt)

    Odczytuje szczegółową zawartość strony.

  • create_page (zapis)

    Tworzy stronę w bazie lub pod stroną nadrzędną.

  • update_page (zapis)

    Aktualizuje właściwości strony.

  • append_paragraph (zapis)

    Dodaje akapit tekstu do strony.

  • append_to_do (zapis)

    Dodaje pola do zaznaczenia do strony.

  • create_comment (zapis)

    Dodaje komentarz lub odpowiada w istniejącym wątku.

  • archive_page (zapis)

    Archiwizuje stronę w koszu, odwracalnie.

Wymagania wstępne

  • Utworzyć wewnętrzną integrację na notion.so/my-integrations, powiązaną z jednym workspace.
  • Włączyć capabilities Read content, Update content, Insert content, plus komentarze.
  • Skopiować sekret integracji (przedrostek ntn_ lub secret_), wyświetlany tylko raz.
  • Udostępnić każdą stronę lub bazę integracji przez ••• , następnie Connections.
  • W Atako uprawnienie administratora integracji, aby przyznać grant agentowi.

Jak połączyć

  1. 1

    Utworzenie integracji Notion

    Na notion.so/my-integrations utworzyć integrację, wybrać workspace, włączyć capabilities, skopiować sekret.

  2. 2

    Udostępnienie stron integracji

    Otworzyć każdą stronę lub bazę, którą chcesz udostępnić agentowi, kliknąć ••• , następnie Connections, wybrać integrację. Bez tego kroku sam token nie daje dostępu do niczego.

  3. 3

    Połączenie Notion w Atako

    W Ustawienia, następnie Integracje, wkleić sekret skopiowany w kroku 1.

  4. 4

    Przyznanie grantu agentowi

    Ze strony agenta (Integracje tego agenta) lub z poziomu połączenia (Zarządzaj dostępem) wybrać dokładne działania do autoryzacji i ich zakres (tylko odczyt lub odczyt i zapis).

Dlaczego podłączyć autonomicznego agenta do Notion

Notion to często miejsce, w którym zespół przechowuje to, co wie: bazy śledzenia, dokumentację wewnętrzną, notatki ze spotkań. Problem polega na tym, że ta informacja szybko się starzeje, jeśli nikt jej nie aktualizuje. Agent Atako połączony z Notion przez tool calling może wykonywać tę pracę nieprzerwanie, we własnym środowisku, bez konieczności otwierania bazy przez człowieka co tydzień.

To, co zmienia się względem klasycznej automatyzacji z wyzwalaczem: agent działa nieprzerwanie. Może otrzymać informację emailem, zestawić ją z tym, co już istnieje w bazie Notion przez query_database, a następnie samodzielnie zdecydować, czy utworzyć stronę, czy zaktualizować istniejący wpis, w ramach działań, które mu przyznano.

Konektor Notion obejmuje 28 działań (13 odczytu, 15 zapisu) według dokumentacji Atako, od wyszukiwania stron po tworzenie baz wraz z ich schematem właściwości. Wystarczająco, by obsłużyć zarówno porządkowanie notatek ze spotkań, jak i przeglądanie bazy wiedzy. Typowe zastosowanie: agent zarządzający komunikacją wokół release'u utrzymuje swoją dokumentację Notion na bieżąco równolegle z innymi kanałami.

Ograniczenia i dobre praktyki

Notion wymaga wyraźnego udostępnienia, strona po stronie lub baza po bazie. To ograniczenie na start, ale też zabezpieczenie: token, który wyciekłby, dałby dostęp tylko do tego, co udostępniono, nigdy do całego workspace.

Przepustowość API Notion pozostaje skromna: średnio trzy żądania na sekundę na integrację, z limitem na workspace, który zależy od planu cenowego. Na bazie liczącej kilka tysięcy stron agent, który musi wszystko przejrzeć, będzie musiał rozłożyć pracę w czasie.

Konektor nie pozwala na trwałe usuwanie: archive_page przenosi stronę do kosza, skąd można ją odzyskać. Jak w przypadku każdej integracji Atako, każde działanie podlega wyraźnemu grantowi (agent, działanie, zakres): samo połączenie nie daje żadnego dostępu. Zobacz model uprawnień i plany.

Powiązane przypadki użycia

Powiązane integracje

Najczęstsze pytania

Czy agent może modyfikować dowolną stronę w moim workspace Notion?

Nie. Agent widzi tylko strony i bazy wyraźnie udostępnione integracji, przez menu Connections. Nawet udostępniona strona może zostać zmodyfikowana tylko wtedy, gdy grant agenta obejmuje działanie zapisu z odpowiednim zakresem.

Czy potrzebny jest płatny plan Notion, aby połączyć API?

Nie, API Notion działa zarówno w planie darmowym, jak i w planach płatnych. To, co zmienia się w zależności od planu, to limit żądań dozwolonych na workspace.

Jak odebrać agentowi dostęp do Notion?

Dwie uzupełniające się opcje: usunąć integrację z listy połączeń danej strony albo cofnąć połączenie po stronie Atako. W obu przypadkach dostęp zostaje odcięty natychmiast dla wszystkich zainteresowanych agentów.

Czy agent może trwale usunąć stronę Notion?

Nie. Jedynym dostępnym działaniem usuwania jest archive_page, które przenosi stronę do kosza bez jej niszczenia. W tym konektorze nie ma działania trwałego usuwania.

Co przeczytać dalej

Źródła

Romain Laodicina

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.

Wdróż swoich pierwszych agentów AI

Utwórz konto za darmo i uruchom agenta w kilka minut, bez kodu.

Bądź zawsze o krok do przodu w AI.

Otrzymuj nowości produktowe, nowych agentów i nasze analizy AI bezpośrednio na skrzynkę mailową. Bez spamu, wypisanie w dowolnym momencie.