Airtable

Synchronizuj swoje tabele Airtable z bazą wiedzy AI SmartTalk. Przekształć swoje uporządkowane dane w wiedzę dostępną dla 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 danych na bieżąco dzięki ręcznym lub zaplanowanym synchronizacjom

---

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

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

---

Instrukcja krok po kroku

Krok 1: Wygeneruj swój klucz API Airtable

1. Zaloguj się na swoje konto Airtable
2. Przejdź do Ustawienia konta → Hub dewelopera
3. Kliknij Utwórz nowy token
4. Skonfiguruj swój token:
   • Nazwa: AI SmartTalk Integration
   • Zakresy: Wybierz data.records:read oraz 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 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 Wiedza w AI SmartTalk
2. Twoje rekordy Airtable pojawią się jako indywidualne wpisy wiedzy
3. Przetestuj swoje AI, zadając pytania dotyczące swoich danych

---

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	Odniesione 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 posiadacie?"
• "Opowiedz mi o Widget Pro"
• "Jakie jest wasze 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
Podczas importu	Synchronizuje, gdy uruchomisz import
Zaplanuj	Ustaw za pomocą SmartFlow (patrz poniżej)

Planowanie z SmartFlow

Aby automatycznie synchronizować dane z Airtable:

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

---

Przykłady użycia

Katalog produktów/usług

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

• "Jakie produkty masz poniżej 100 dolarów?"
• "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 zresetować moje hasło?"
• "Jaka jest polityka zwrotów?"
• "Gdzie mogę znaleźć moją fakturę?"

Katalog zespołu

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

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

Dane o wydarzeniach/harmonogramie

Synchronizuj tabele wydarzeń dla zapytań o harmonogram:

• "Jakie wydarzenia nadchodzą?"
• "Kiedy jest następne webinarium?"
• "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 centrum dewelopera Airtable
"Nie znaleziono bazy"	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
Zaktualizuj 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ń zduplikowane rekordy przed synchronizacją
3. Mądre użycie 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 — Automatyzacja synchronizacji