Integracja z Notion wiedza, z której agent AI może odpowiadać
Notion jest u Was miejscem, w którym mieszka wiedza firmy: procedury, cenniki, ustalenia z klientami, notatki ze spotkań. Wpinamy go tak, żeby agent AI odpowiadał z tych stron i pokazywał, z której konkretnie wziął odpowiedź. Po drodze wychodzi, które dokumenty są nieaktualne, bo agent powtórzy każdy błąd, jaki ktoś tam zapisał, i które tabele przestały się mieścić w Notionie.
- 5 do 10 sekundtyle BOND potrzebuje na odpowiedź z Waszej wiedzy, razem z linkiem do strony w Notionie, z której ją wziął
- 100 rekordówtyle jedno zapytanie do bazy Notion zwraca naraz, przy średnio 3 zapytaniach na sekundę na integrację. Limity z dokumentacji Notion API
- 180 dnitypowy próg przeglądu: strona bez edycji dłużej niż pół roku trafia na listę do potwierdzenia albo do wycofania
- 2 do 6 tygodniod warsztatu do działającej integracji, w zależności od tego, ile stron wchodzi do indeksu i w jakim są stanie
Problem
Dlaczego agent AI powtarza nieaktualny zapis z Notiona?
Nowa osoba pyta o rabat dla dużego klienta. Odpowiedź jest w Notionie, w trzech miejscach: na stronie z cennikiem z marca, w notatce ze spotkania z czerwca i w komentarzu pod stroną projektu. Każde miejsce podaje inną liczbę. Wygrywa to, które ktoś znalazł pierwsze.
Wpuszczenie w to agenta AI samo z siebie niczego nie naprawia. Agent nie wie, że strona z cennikiem stoi nietknięta od marca. Przeczyta to, co tam jest, złoży z tego pełne zdanie i poda dalej z pewnością, na jaką ta treść nie zasługuje. Nieaktualny dokument w Notionie staje się nieaktualną odpowiedzią, tylko szybszą i wygłoszoną ładniejszym językiem.
Druga połowa problemu to tabele. Notion ma bazy z relacjami i rollupami, więc łatwo trzymać w nim projekty, klientów i zamówienia, a do pewnej skali to naprawdę działa. Potem zaczyna zgrzytać i zderza się z limitami opisanymi w dokumentacji Notion API: jedno zapytanie do bazy zwraca najwyżej 100 rekordów, a jedna integracja ma średnio 3 zapytania na sekundę, powyżej progu API odpowiada błędem 429. Raport z trzech powiązanych tabel to wtedy kilkaset wywołań i kilka minut czekania.
Trzecia rzecz zaskakuje najczęściej przy pierwszym pilotażu. Integracja w Notionie nie widzi całego workspace'u, widzi wyłącznie te strony i bazy, które ktoś jej wprost udostępnił. To dobra wiadomość dla bezpieczeństwa i zła dla pierwszego tygodnia testów: agent odpowiada „nie wiem” o rzeczach, które w Notionie leżą od dawna, bo strona z odpowiedzią nigdy nie została podłączona.
- Ta sama procedura żyje w trzech miejscach i w każdym trochę inaczej
- Cennik z marca odpowiada na pytanie zadane w grudniu
- Za stronę nie odpowiada nikt konkretny, więc nikt jej nie aktualizuje
- Raport z tabel Notiona składa ręcznie człowiek, bo eksport nie wyrabia
- Agent mówi „nie wiem”, choć odpowiedź leży w Notionie, tylko nieudostępniona
Dlaczego teraz
Co się zmieniło, że Notion da się podać agentowi AI jako źródło?
Notion udostępnia REST API v1 i to wystarcza do pracy w dwie strony: zapytanie do bazy zwraca rekordy z właściwościami, POST /pages zakłada stronę, PATCH /pages/{id} zmienia właściwość, PATCH /blocks/{id}/children dopisuje treść. Autentykacja idzie przez token integracji, a dostęp nadaje się per strona i per baza. Nie ma tu wyboru „wszystko albo nic”.
Drugą rzecz robi indeks. Strony wyciągamy zapytaniem, dzielimy na fragmenty, liczymy dla nich wektory i trzymamy je obok tekstu razem z adresem strony źródłowej. Dzięki temu odpowiedź ma podpis: nie „tak wynika z dokumentacji”, ale link do konkretnej strony i data jej ostatniej edycji. Człowiek ma czym sprawdzić, a osoba odpowiedzialna za treść wie, co poprawić.
Trzecia rzecz to bieżące zmiany. Nowe i poprawione strony wyłapujemy zapytaniem z filtrem po last_edited_time, sprawdzanym co kilka minut, i tylko one wracają do indeksu. Nie trzeba przeliczać całej bazy wiedzy raz na dobę, żeby odpowiedź nadążała za tym, co ktoś dopisał po obiedzie.
Czwarta to wyjście dla danych, które z Notiona wyrosły. Tabele wypychamy raz na dobę do BigQuery albo do arkusza, a Notion zostaje miejscem pracy i widokiem na te dane. Zespół pracuje w narzędziu, które zna, a raport liczy się poza nim, w sekundy.
Co się zmienia
Co dostaje zespół, który już siedzi w Notionie?
Odpowiedź z firmowej wiedzy w 5 do 10 sekund
Zamiast szukać po stronach, ktoś pisze pytanie zwykłym zdaniem: jaki mamy rabat dla klienta powyżej stu tysięcy, jak wygląda procedura zwrotu, co ustaliliśmy na kick-offie. Agent AI odpowiada z Waszych stron, nie z internetu.
Pod każdą odpowiedzią link do strony w Notionie i data jej ostatniej edycji
Widać, które dokumenty zestarzały się w ciszy
Przy indeksowaniu wychodzi lista stron bez edycji od pół roku, stron bez właściciela i takich, które mówią o tym samym co inne, tylko inaczej. To pierwszy raz, kiedy ktoś widzi tę listę w całości.
Właściciel i data przeglądu jako właściwości strony, lista do potwierdzenia po 180 dniach
Jedna wersja procedury zamiast trzech kopii
Na warsztacie ustalamy, która strona jest źródłem prawdy dla każdego tematu, a reszta zostaje przekierowaniem albo idzie do archiwum. Agent indeksuje tylko to, co jest źródłem, więc nie ma z czego sklejać dwóch sprzecznych odpowiedzi.
Do indeksu wchodzą wyłącznie strony wskazane jako źródło, nie cały workspace
Notion zapełnia się bez kopiowania ręcznego
Transkrypcja ze spotkania, ustalenia z maila i dokument z Google Drive trafiają przez API na właściwą stronę klienta albo projektu. Nikt nie przekleja tego wieczorem, więc wiedza nie zostaje w skrzynce jednej osoby.
Zapis przez PATCH /blocks/{id}/children na stronie, która już ma właściciela
Tabele Notiona zgodne z CRM i z zadaniami
Wygrany deal w CRM zakłada w Notionie stronę projektu z wypełnionymi właściwościami: klient, wartość, opiekun, termin. Zmiana statusu zadania w narzędziu operacyjnym aktualizuje właściwość w Notionie, więc widok menedżera nie kłamie.
Aktualizacja właściwości przez PATCH /pages/{id}, bez logowania do drugiego systemu
Raport poza Notionem, gdy tabela przestaje wyrabiać
Historia statusów, sumy miesiąc do miesiąca i raporty łączące kilka tabel idą do hurtowni albo do bazy SQL. Notion zostaje wejściem dla ludzi i widokiem na wynik, a nie silnikiem, który to liczy.
Eksport do BigQuery albo Google Sheets raz na dobę, ten sam widok w Notionie
A u Ciebie
Co, jeśli nasz Notion jest w połowie nieaktualny?
Cztery zdania, które słyszymy przy Notionie najczęściej, i to, co na nie odpowiadamy.
Nasza wiedza w Notionie jest w połowie przeterminowana.
To jest reguła, nie wyjątek, i dlatego przegląd treści jest częścią wdrożenia, a nie warunkiem wstępnym. Agent nie poprawi dokumentu za Was, więc najpierw ustalamy, które strony są źródłem prawdy, kto za nie odpowiada i co idzie do archiwum. Jeśli po tej rozmowie zostanie zbyt mało treści, żeby agent miał z czego odpowiadać, mówimy to wprost.
Nie chcemy, żeby AI widziało wszystko, co mamy w Notionie.
I nie zobaczy. Integracja w Notionie dostaje dostęp do wskazanych stron i baz, a nie do workspace'u, więc zakres jest decyzją, a nie skutkiem ubocznym. Wynagrodzenia, oceny pracowników i notatki prywatne zostają poza indeksem, a lista udostępnionych stron jest jednym z dokumentów kończących warsztat.
Trzymamy w Notionie bazę projektów z relacjami i to nam wystarcza.
Dopóki wystarcza, nie ruszamy jej i tak Wam powiemy. Próg zaczyna być widoczny wtedy, gdy raport łączy trzy tabele naraz, gdy jedna z nich rośnie o setki rekordów w miesiącu albo gdy zaczynacie liczyć czasy przejścia między statusami, których Notion nie zapisuje. Wtedy historia idzie do bazy albo do hurtowni, a Notion zostaje widokiem.
Notion ma własne wyszukiwanie, po co nam agent AI?
Wyszukiwarka zwraca listę stron i zostawia Cię z czytaniem, agent zwraca zdanie z konkretem plus link do strony, z której to wziął. Różnica jest największa przy pytaniach, których odpowiedź składa się z dwóch dokumentów, na przykład procedury i aktualnego cennika. Jeśli problemem jest u Was sama struktura Notiona, mówimy to i zaczynamy od niej.
- Baza wiedzy i dokumenty
- Notion, Google Workspace, Microsoft 365
- Praca zespołu i zadania
- Slack, ClickUp, Jira, Asana
- CRM
- HubSpot, Pipedrive, Salesforce, LiveSpace
- Dane i raporty
- BigQuery, Google Sheets, GA4, bazy SQL
- Źródła treści
- Transkrypcje spotkań, poczta, Google Drive
- Warstwa automatyzacji
- n8n, Make, Zapier, własne integracje przez API
Co zostaje w Notionie, a co idzie dalej
Podział, od którego zaczynamy na warsztacie. Notion jest dobrym miejscem na treść, którą czyta człowiek, i słabym na historię, którą trzeba liczyć.
| Rodzaj danych | Notion wystarcza | Kiedy przenieść dalej |
|---|---|---|
| Procedury i instrukcje | tak, to jest natywne zastosowanie | praktycznie nigdy, to zostaje źródłem dla agenta |
| Ustalenia z klientem | tak, jedna strona na klienta, z właścicielem i datą przeglądu | gdy ustalenie wpływa na fakturę, wtedy źródłem jest CRM albo umowa |
| Baza projektów z relacjami | do kilkuset rekordów i kilku widoków | gdy raport łączy trzy tabele albo tabela rośnie o setki rekordów w miesiącu |
| Historia statusów i czasy przejścia | nie, Notion trzyma stan, nie przebieg | od razu do bazy albo hurtowni, jeśli chcesz to liczyć |
| Liczby do raportów miesięcznych | do prostych sum w widoku | gdy porównujesz miesiąc do miesiąca, wtedy BigQuery albo baza SQL |
| Dane osobowe i kadrowe | tylko to, co niezbędne, i poza indeksem agenta | gdy potrzebna jest kontrola dostępu na poziomie rekordu |
| Załączniki i pliki | tak, jako miejsce pracy zespołu | gdy plik ma być źródłem odpowiedzi, wtedy jego tekst wchodzi do indeksu |
Wiersze to punkt wyjścia. U większości firm pierwsze wdrożenie zostawia w Notionie wszystko i dokłada tylko indeks plus jeden eksport do hurtowni.
Jak to robimy
Pięć kroków od stron w Notionie do odpowiedzi z podpisem
Każdy krok kończy się czymś, co możesz ocenić, zanim zdecydujesz o następnym.
Warsztat
Przechodzimy przez Wasz Notion i pytania, które zespół zadaje najczęściej. Ustalamy, która strona jest źródłem prawdy dla każdego tematu, co jest kopią, czego w Notionie w ogóle nie ma i które tabele pełnią rolę cichej bazy danych firmy.
Porządek i właściciele
Duplikaty schodzą do jednej strony, każda strona źródłowa dostaje właściciela i datę przeglądu jako właściwość. Powstaje lista stron do potwierdzenia i do wycofania. To jest praca na treści, nie na kodzie, i można ją wykonać bez nas.
Udostępnienie i indeks
Zakładamy integrację i udostępniamy jej wyłącznie strony z listy. Treść dzielimy na fragmenty, liczymy wektory, zapisujemy razem z adresem strony i datą edycji. Zmiany dociągamy zapytaniem z filtrem po last_edited_time, co kilka minut.
Pilot na prawdziwych pytaniach
Zbieramy od zespołu 20 do 30 pytań, które naprawdę padają, i sprawdzamy odpowiedzi jedna po drugiej. Zła odpowiedź prawie zawsze wskazuje na dokument, nie na model: brakującą stronę, dwie wersje procedury albo cennik bez daty.
Produkcja i pomiar
Agent wchodzi do narzędzia, w którym zespół już siedzi: Slack, Teams albo przeglądarka. Po 30 i po 90 dniach patrzymy na pytania bez odpowiedzi i na strony, których nikt nie tknął od kwartału. Z tego wychodzi kolejka poprawek w treści.
Przed i po
Jak zmienia się dzień osoby, która zna odpowiedzi
Przedtem
- Odpowiada na te same pytania po raz kolejny, na czacie i przy biurku
- Szuka po Notionie, żeby ustalić, która wersja procedury jest aktualna
- Dowiaduje się o nieaktualnym cenniku od klienta, nie z systemu
- Raport z tabeli projektów składa ręcznie, bo eksport gubi relacje
Po zmianie
- Zespół pyta agenta i dostaje odpowiedź z linkiem do strony źródłowej
- Każdy temat ma jedną stronę źródłową, z właścicielem i datą przeglądu
- Strony bez edycji od 180 dni same trafiają na listę do potwierdzenia
- Raport liczy się w hurtowni, a w Notionie zostaje ten sam widok
Pierwsze odpowiedzi widać w tygodniu, w którym powstaje indeks. Jakość oceniamy po 30 dniach na pytaniach, które zespół naprawdę zadał, i po 90 dniach na tym, czy treść jest utrzymywana.
Dla osoby, która to zamawia
Co z tego ma osoba odpowiedzialna za wiedzę w firmie
Przestajesz być wąskim gardłem. Pytania o procedury, cenniki i ustalenia przestają trafiać do Ciebie, bo odpowiada na nie agent z tych samych stron, które i tak podpisałeś. Wdrożenie nowej osoby przestaje zależeć od tego, czy masz dla niej czas w pierwszym tygodniu.
Druga rzecz jest ważniejsza przy rozmowie z zarządem. Po indeksowaniu masz na papierze, ile stron nikt nie tknął od pół roku i ile tematów ma dwie sprzeczne wersje. To argument za czasem na porządek w dokumentacji, którego dziś nie masz czym poprzeć.
- Lista stron źródłowych z właścicielem i datą przeglądu, nie w Twojej głowie
- Zakres dostępu agenta jest decyzją zapisaną na warsztacie, nie skutkiem ubocznym
- Pilot na 20 do 30 prawdziwych pytaniach, zanim cokolwiek wejdzie na produkcję
- Pytania bez odpowiedzi wracają jako kolejka poprawek w treści, po 30 i 90 dniach
Ile to kosztuje
Warsztat ma cenę jawną, integracja wycenę po nim
Warsztat procesowy kosztuje 2500 zł netto za tydzień. Przy bazie wiedzy zwykle wychodzi jeden tydzień, dwa wtedy, gdy Notion obsługuje kilka działów naraz i trzeba przejść przez każdy osobno. Integrację wyceniamy po warsztacie, gdy wiadomo, ile stron wchodzi do indeksu, w jakim są stanie i z jakimi systemami Notion ma rozmawiać.
Koszt narzędzi płacisz bezpośrednio dostawcom: licencje Notion, model językowy, hosting automatyzacji. Bez naszej prowizji. Przy indeksie liczy się liczba stron, a nie liczba pytań, więc rachunek za używanie nie rośnie razem z zespołem tak szybko, jak się tego spodziewasz.
Warsztat procesowy
2500 zł netto
za tydzień, przy bazie wiedzy zwykle jeden do dwóch
Zamknięta całość. Kończy się listą stron źródłowych, właścicielami i planem, który możesz zrealizować bez nas.
- Przegląd Waszego Notiona i pytań, które zespół zadaje najczęściej
- Lista stron źródłowych, duplikatów i braków, z właścicielami
- Podział danych: co zostaje w Notionie, a co idzie do bazy albo hurtowni
- Zakres dostępu dla integracji, spisany przed nadaniem uprawnień
- Najczęściej wybierany
Warsztat i integracja Notion
Wycena po warsztacie
zakres wynika z liczby stron i systemów, które wchodzą w grę
Najczęściej wybierany wariant. Działająca integracja w 2 do 6 tygodni od warsztatu, na Waszych stronach i Waszych danych.
- Wszystko z warsztatu
- Integracja z uprawnieniami tylko do wskazanych stron i baz
- Zasilanie Notiona z CRM, zadań, poczty i Google Drive przez API
- Wyłapywanie zmian po last_edited_time i eksport tabel do hurtowni
- Szkolenie osoby, która utrzymuje treść i listę stron źródłowych
Notion jako baza wiedzy dla BOND-a
Wycena po warsztacie
wdrożenie firmowego agenta AI to zwykle około 2 miesięcy
Wszystko z integracji plus BOND, firmowy agent AI, który odpowiada z Waszej wiedzy i podaje stronę źródłową.
- Wszystko z integracji Notion
- Indeks stron z linkiem i datą edycji pod każdą odpowiedzią
- Agent w Slacku, Teams albo przeglądarce, po polsku i po angielsku
- Raport pytań bez odpowiedzi jako kolejka poprawek w treści
- Pomiar po 30 i 90 dniach, razem z listą stron nietkniętych od kwartału
Warsztat kończy się listą stron źródłowych i planem porządków, który obroni się bez nas, także wtedy, gdy nie zamówisz integracji. Jeśli okaże się, że Wasza wiedza w Notionie jest zbyt nieaktualna, żeby agent miał z czego odpowiadać, mówimy to i pierwszym krokiem jest przegląd treści, a nie wdrożenie.
Najczęstsze pytania
Czy agent AI może odpowiadać z naszego Notiona?
Tak, i to jest najczęstszy powód, dla którego wpinamy Notion. Strony wyciągamy przez API, dzielimy na fragmenty i indeksujemy, a agent odpowiada wyłącznie z tego, co w indeksie. Do indeksu wchodzą tylko strony wskazane na warsztacie jako źródło prawdy, nie cały workspace.
Skąd wiadomo, z której strony Notiona pochodzi odpowiedź?
Przy każdym fragmencie zapisujemy adres strony i datę jej ostatniej edycji, więc pod odpowiedzią jest link i data. To jest warunek, nie dodatek: odpowiedź bez podpisu nie da się sprawdzić, a przy wiedzy firmowej sprawdzalność jest ważniejsza niż wygoda.
Co się stanie, jeśli dokument w Notionie jest nieaktualny?
Agent powtórzy to, co jest napisane, bo nie ma innego źródła prawdy niż Wasza treść. Dlatego przegląd stron jest częścią wdrożenia: każda strona źródłowa dostaje właściciela i datę przeglądu, a te bez edycji od 180 dni trafiają na listę do potwierdzenia albo do wycofania. Pytania, na które agent odpowiedział źle, wracają do Was jako kolejka poprawek w treści.
Czy integracja widzi cały nasz workspace w Notionie?
Nie. Integracja w Notionie ma dostęp tylko do tych stron i baz, które ktoś jej wprost udostępnił, i to jest zapisane w dokumentacji Notion API. Zakres ustalamy przed nadaniem uprawnień, a wynagrodzenia, oceny pracowników i notatki prywatne zostają poza nim.
Kiedy Notion przestaje wystarczać jako baza danych?
Zwykle przy trzech objawach: raport łączy kilka powiązanych tabel, jedna z nich rośnie o setki rekordów w miesiącu, a Wy zaczynacie liczyć czasy przejścia między statusami, których Notion nie zapisuje. Do tego dochodzą limity API: 100 rekordów na zapytanie i średnio 3 zapytania na sekundę na integrację. Wtedy historia idzie do bazy SQL albo do hurtowni, a Notion zostaje wejściem i widokiem.
Jak wyłapujecie zmiany w Notionie?
Zapytaniem z filtrem po polu last_edited_time, sprawdzanym co kilka minut, więc do indeksu wracają wyłącznie strony ruszone od ostatniego przebiegu. Przy większych bazach dochodzi do tego pełne przeliczenie raz na dobę, w nocy, żeby wyłapać usunięcia i zmiany uprawnień.
Ile trwa integracja z Notion?
Tydzień warsztatu i 2 do 6 tygodni wdrożenia. Krótszy koniec tego zakresu to indeks wiedzy dla agenta na kilkudziesięciu stronach, dłuższy to Notion spięty z CRM, zadaniami i hurtownią naraz. Wdrożenie BOND-a jako firmowego agenta AI to zwykle około 2 miesięcy, bo dochodzą kolejne źródła poza Notionem.
Czy treść z Notiona wychodzi poza naszą firmę?
Do modelu językowego trafiają fragmenty stron potrzebne do odpowiedzi na zadane pytanie, i to ustalamy na warsztacie razem z tym, jakiego dostawcy używamy i gdzie stoi indeks. Strony spoza listy nie wychodzą nigdzie, bo integracja ich nie widzi. Dane osobowe i kadrowe domyślnie zostawiamy poza indeksem.
Sprawdźmy, czy Wasz Notion jest gotowy na pytania
Bezpłatna konsultacja trwa 30 minut. Opowiadasz, co trzymacie w Notionie i o co zespół pyta najczęściej, nawet jeśli połowa stron nie była ruszana od pół roku. Pokazujemy, które tematy da się zaindeksować od razu, a które wymagają najpierw wskazania jednej wersji. Nie musisz na tym etapie niczego udostępniać.
Prowadzimy najwyżej dwa wdrożenia równocześnie, żeby przy każdym ktoś realnie siedział.
Umów bezpłatną konsultacjęPS. Jeśli w tym tygodniu ktoś u Was zapytał, która wersja procedury jest aktualna, to jest dokładnie ten problem. Agent AI odpowie na to w 5 do 10 sekund i wskaże stronę, z której wziął odpowiedź, ale tylko wtedy, gdy ta strona jest jedna. Od tego zaczyna się warsztat.