Airtable

Synchronizuj swoje tabele Airtable z bazą wiedzy AI SmartTalk. Przekształć swoje uporządkowane dane w wiedzę, którą można zapytać AI — idealne do katalogów produktów, FAQ, katalogów zespołów i nie tylko.

---

Przegląd

Integracja Airtable umożliwia:

• Połączenie swojej bazy Airtable za pomocą klucza API
• Synchronizację danych tabel jako wpisów w bazie wiedzy
• Zapytanie swoich danych w sposób konwersacyjny przez AI
• Utrzymanie świeżości danych dzięki ręcznym lub zaplanowanym synchronizacjom

---

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

• Aktywne konto AI SmartTalk
• Konto Airtable z co najmniej jedną bazą
• Klucz API Airtable (Personal Access Token)

---

Instrukcje krok po kroku

Krok 1: Wygeneruj swój klucz API Airtable

1. Zaloguj się na swoje konto Airtable
2. Przejdź do Ustawienia konta → Developer hub
3. Kliknij Utwórz nowy token
4. Skonfiguruj swój token:
   • Nazwa: AI SmartTalk Integration
   • Zakresy: Wybierz data.records:read i schema.bases:read
   • Dostęp: Wybierz konkretne bazy, które chcesz połączyć
5. Kliknij Utwórz token i natychmiast go skopiuj

Ważne: Zapisz swój token w bezpiecznym miejscu — Airtable pokazuje go tylko raz!

Krok 2: Połącz z AI SmartTalk

1. Zaloguj się na swoje konto AI SmartTalk
2. Przejdź do Ustawienia → Integracje
3. Znajdź Airtable i kliknij Połącz
4. Wklej swój klucz API w polu Personal Access Token
5. Kliknij Waliduj

Krok 3: Wybierz tabele do synchronizacji

Po walidacji zobaczysz swoje dostępne bazy i tabele:

1. Przeglądaj bazy: Kliknij, aby rozwinąć każdą bazę
2. Wybierz tabele: Zaznacz tabele, które chcesz synchronizować
3. Skonfiguruj pola: Wybierz, które kolumny chcesz uwzględnić
4. Kliknij Rozpocznij synchronizację

Krok 4: Zweryfikuj import

1. Przejdź do Wiedzy w AI SmartTalk
2. Twoje rekordy Airtable pojawią się jako indywidualne wpisy wiedzy
3. Przetestuj swoje AI, zadając pytania o swoje dane

---

Co jest synchronizowane

Typ danych	Jak jest przetwarzany
Pola tekstowe	Synchronizowane jako treść przeszukiwalna
Pola numeryczne	Uwzględnione w kontekście rekordu
Wybór/Wielokrotny wybór	Traktowane jako kategorie/etykiety
Powiązane rekordy	Uwzględnione odniesienia
Załączniki	Odniesienia do URL (pliki nie są pobierane)
Formuły	Synchronizowane wartości obliczone

Przykład: Katalog produktów

Jeśli masz tabelę "Produkty":

Nazwa	Opis	Cena	Kategoria
Widget Pro	Widget profesjonalnej jakości...	$99	Narzędzia
Widget Lite	Widget podstawowy...	$49	Narzędzia

Twoje AI może odpowiedzieć:

• "Jakie produkty masz?"
• "Opowiedz mi o Widget Pro"
• "Jakie jest twoje najtańsze narzędzie?"

---

Konfiguracja synchronizacji

Wybór pól

Dla każdej tabeli możesz skonfigurować:

• Pole główne: Główny identyfikator dla każdego rekordu
• Pola treści: Pola do uwzględnienia w bazie wiedzy
• Pola do wykluczenia: Pola wewnętrzne do pominięcia (ID, znaczniki czasowe itp.)

Częstotliwość synchronizacji

Opcja	Opis
Ręczna	Kliknij "Synchronizuj teraz", gdy zajdzie potrzeba
Przy imporcie	Synchronizuje, gdy uruchomisz import
Zaplanowana	Ustaw za pomocą SmartFlow (patrz poniżej)

Planowanie z SmartFlow

Aby automatycznie synchronizować dane Airtable:

1. Utwórz nowy SmartFlow
2. Dodaj wyzwalacz Zaplanowany (codziennie, co tydzień itp.)
3. Dodaj akcję Synchronizuj → Wybierz Airtable
4. Zapisz i aktywuj workflow

---

Przykłady użycia

Katalog produktów/usług

Synchronizuj swoją bazę produktów, aby klienci mogli pytać:

• "Jakie produkty masz poniżej $100?"
• "Porównaj Widget Pro i Widget Lite"
• "Czy masz coś w kategorii Narzędzia?"

FAQ / Baza wiedzy

Przechowuj FAQ w Airtable z kolumnami Pytanie/Odpowiedź:

• "Jak mogę zresetować moje hasło?"
• "Jaka jest twoja polityka zwrotów?"
• "Gdzie mogę znaleźć moją fakturę?"

Katalog zespołu

Synchronizuj dane członków zespołu do zapytań wewnętrznych:

• "Kto zajmuje się obsługą klienta?"
• "Jaką rolę pełni Sarah?"
• "Wymień wszystkich w zespole inżynieryjnym"

Dane o wydarzeniach/harmonogramie

Synchronizuj tabele wydarzeń do zapytań o harmonogram:

• "Jakie wydarzenia nadchodzą?"
• "Kiedy jest następny webinar?"
• "Co się wydarzyło na spotkaniu w zeszłym miesiącu?"

---

Rozwiązywanie problemów

Problemy z połączeniem

Problem	Rozwiązanie
"Nieprawidłowy klucz API"	Wygeneruj ponownie token w Airtable Developer hub
"Baza nie znaleziona"	Upewnij się, że token ma dostęp do tej bazy
"Odmowa dostępu"	Dodaj zakres data.records:read do swojego tokena

Problemy z synchronizacją

Problem	Rozwiązanie
Brakujące rekordy	Sprawdź, czy rekordy nie są filtrowane/ukryte w widoku
Nieaktualne dane	Kliknij Synchronizuj teraz, aby odświeżyć
Niewłaściwe pola synchronizowane	Sprawdź wybór pól w ustawieniach integracji

AI nie może znaleźć danych

Problem	Rozwiązanie
Brak wyników dla zapytań	Poczekaj na zakończenie synchronizacji i przetworzenie przez AI
Częściowe odpowiedzi	Upewnij się, że wszystkie istotne pola są uwzględnione w synchronizacji

---

Zarządzanie połączeniem

Akcja	Jak
Aktualizuj klucz API	Ustawienia → Integracje → Airtable → Zaktualizuj token
Dodaj tabele	Edytuj połączenie → Wybierz dodatkowe tabele
Usuń tabele	Odznacz tabele, które nie mają być już synchronizowane
Rozłącz	Ustawienia → Integracje → Airtable → Rozłącz

---

Najlepsze praktyki

1. Struktura dla AI: Używaj jasnych, opisowych nazw pól
2. Usuwanie duplikatów danych: Usuń duplikaty rekordów przed synchronizacją
3. Mądrze używaj pól głównych: Wybierz unikalne, opisowe identyfikatory
4. Regularne synchronizacje: Utrzymuj dane świeże, szczególnie dla zmieniającej się treści
5. Ogranicz zakres: Synchronizuj tylko tabele, które AI potrzebuje do odpowiadania na pytania

---

Powiązana dokumentacja

• Przegląd integracji
• Zarządzanie bazą wiedzy
• Import URL CSV — Alternatywa dla danych statycznych
• Zaplanowane wyzwalacze SmartFlow — Automatyzuj synchronizacje