Indeksuj zawartość Dropbox za pomocą łącznika Dropbox dla Amazon Kendra

Amazonka Kendra to bardzo dokładna i prosta w użyciu inteligentna usługa wyszukiwania oparta na uczeniu maszynowym (ML). Amazon Kendra oferuje zestaw łączników źródeł danych, aby uprościć proces pozyskiwania i indeksowania treści, gdziekolwiek się ona znajduje.

Cenne dane w organizacjach są przechowywane zarówno w repozytoriach ustrukturyzowanych, jak i nieustrukturyzowanych. Rozwiązanie wyszukiwania korporacyjnego powinno być w stanie zebrać dane z kilku repozytoriów ustrukturyzowanych i nieustrukturyzowanych w celu indeksowania i wyszukiwania.

Jednym z takich repozytorium danych jest Dropbox. Użytkownicy korporacyjni używają Dropbox do przesyłania, przesyłania i przechowywania dokumentów w chmurze. Oprócz możliwości przechowywania dokumentów Dropbox oferuje Dropbox Paper, narzędzie do współedycji, które umożliwia użytkownikom współpracę i tworzenie treści w jednym miejscu. Dropbox Paper może opcjonalnie używać szablonów, aby nadać strukturę dokumentom. Oprócz plików i papieru Dropbox umożliwia także przechowywanie w folderach skrótów do stron internetowych.

Z przyjemnością informujemy, że możesz teraz używać łącznika Amazon Kendra dla Dropbox do wyszukiwania informacji przechowywanych na Twoim koncie Dropbox. W tym poście pokazujemy, jak indeksować informacje przechowywane w Dropbox i korzystać z funkcji inteligentnego wyszukiwania Amazon Kendra. Ponadto inteligentne wyszukiwanie Amazon Kendra oparte na ML może dokładnie znaleźć informacje z nieustrukturyzowanych dokumentów zawierających treść narracyjną w języku naturalnym, w przypadku których wyszukiwanie słów kluczowych nie jest zbyt skuteczne.

Omówienie rozwiązania

Dzięki Amazon Kendra możesz skonfigurować wiele źródeł danych, aby zapewnić centralne miejsce do przeszukiwania repozytorium dokumentów. W przypadku naszego rozwiązania pokazujemy, jak indeksować repozytorium lub folder Dropbox za pomocą łącznika Amazon Kendra dla Dropbox. Rozwiązanie składa się z następujących kroków:

1. Skonfiguruj aplikację w Dropbox i uzyskaj szczegóły połączenia.
2. Przechowuj szczegóły w Menedżer tajemnic AWS.
3. Utwórz źródło danych Dropbox za pomocą konsoli Amazon Kendra.
4. Indeksuj dane w repozytorium Dropbox.
5. Uruchom przykładowe zapytanie, aby uzyskać informacje.

Wymagania wstępne

Aby wypróbować złącze Amazon Kendra dla Dropbox, potrzebujesz:

Skonfiguruj aplikację Dropbox i zbierz szczegóły połączenia

Zanim skonfigurujemy źródło danych Dropbox, potrzebujemy kilku szczegółów dotyczących Twojego repozytorium Dropbox. Zbierzmy je wcześniej.

1. Iść do www.dropbox.com/developers.
2. Dodaj Konsola aplikacji.
   
3. Zaloguj się przy użyciu swoich poświadczeń (upewnij się, że logujesz się na konto Enterprise).
   
4. Dodaj Utwórz aplikację.
   
5. Wybierz Dostęp ograniczony.
6. Wybierz Pełny Dropbox (lub nazwę konkretnego folderu, który chcesz zindeksować).
7. Wpisz nazwę swojej aplikacji.
8. Dodaj Utwórz aplikację.
   
   Możesz zobaczyć ekran konfiguracji z zestawem zakładek.
9. Aby skonfigurować uprawnienia, wybierz Uprawnienia patka.
   
10. Wybierz minimalny zestaw uprawnień, jak pokazano na poniższych zrzutach ekranu.
    
11. Dodaj Prześlij.
    
    Pojawi się komunikat informujący, że zmiana uprawnień powiodła się.
    
12. Na Ustawienia skopiuj klucz aplikacji.
13. Dodaj Pokazać obok Sekret aplikacji i skopiuj sekret.
14. Pod Wygenerowany token dostępuwybierz Generuj swój i skopiuj token.
    

Przechowuj te wartości w bezpiecznym miejscu — musimy się do nich później odwołać.

Token sesji jest ważny do 4 godzin. Musisz wygenerować nowy token sesji za każdym razem, gdy indeksujesz zawartość.

Przechowuj poświadczenia Dropbox w Menedżerze sekretów

Aby przechowywać swoje dane uwierzytelniające Dropbox w Menedżerze tajemnic, wykonaj następujące kroki:

1. W konsoli Secrets Manager wybierz Przechowaj nowy sekret.
2. Dodaj Inny rodzaj tajemnicy.
3. Utwórz trzy pary klucz-wartość dla appKey, appSecret, refreshToken i wprowadź wartości zapisane z Dropbox.
4. Dodaj Zapisz.
   
5. W razie zamówieenia projektu Tajne imięwprowadź nazwę (na przykład AmazonKendra-dropbox-secret).
6. Wpisz opcjonalny opis.
7. Dodaj Następna.
   
8. W Skonfiguruj obrót sekcji, zachowaj wszystkie ustawienia domyślne i wybierz Następna.
   
9. Na Review wybierz stronę sklep.
   

Skonfiguruj łącznik Amazon Kendra dla Dropbox

Aby skonfigurować łącznik Amazon Kendra, wykonaj następujące czynności:

1. Na konsoli Amazon Kendra wybierz Utwórz indeks.
   
2. W razie zamówieenia projektu Nazwa indeksu, wprowadź nazwę indeksu (na przykład my-dropbox-index).
3. Wpisz opcjonalny opis.
4. W razie zamówieenia projektu Nazwa roli, wpisz nazwę roli uprawnień.
5. Skonfiguruj opcjonalne ustawienia szyfrowania i tagi.
6. Dodaj Następna.
   
7. W Skonfiguruj kontrolę dostępu użytkownika sekcji, pozostaw ustawienia domyślne i wybierz Następna.
   
8. W razie zamówieenia projektu Wersje obsługi administracyjnej, Wybierz Edycja dla programistów.
9. Dodaj Stwórz.
   
   Spowoduje to utworzenie i rozpropagowanie roli uprawnień, a następnie utworzenie indeksu Amazon Kendra, co może potrwać do 30 minut.
10. Dodaj Źródła danych w okienku nawigacji.
    
11. Pod Dropboxwybierz Dodaj złącze.
    
12. W razie zamówieenia projektu Nazwa źródła danychwprowadź nazwę (na przykład my-dropbox-connector).
13. Wpisz opcjonalny opis.
14. Dodaj Następna.
    
15. W razie zamówieenia projektu Rodzaj tokena uwierzytelniającego, Wybierz Token dostępu (zastosowanie tymczasowe).
16. W razie zamówieenia projektu Sekret menedżera sekretów AWS, wybierz wcześniej utworzony sekret.
17. W razie zamówieenia projektu Rola IAMwybierz Utwórz nową rolę.
18. W razie zamówieenia projektu Nazwa roliwprowadź nazwę (na przykład AmazonKendra-dropbox-role).
19. Dodaj Następna.
    
20. W razie zamówieenia projektu Wybierz podmioty lub typy treści, wybierz typy treści.
21. W razie zamówieenia projektu Częstotliwośćwybierz Uruchom na żądanie.
22. Dodaj Następna.
    
23. Ustaw dowolne opcjonalne mapowania pól i wybierz Następna.
24. Dodaj Przejrzyj i utwórz i wybierz Dodaj źródło danych.
25. Dodaj Synchronizuj teraz.
    
26. Poczekaj na zakończenie synchronizacji.
    

Przetestuj rozwiązanie

Teraz, gdy pozyskałeś zawartość z konta Dropbox do indeksu Amazon Kendra, możesz przetestować niektóre zapytania.

Przejdź do swojego indeksu i wybierz Wyszukaj zindeksowaną treść. Wprowadź przykładowe zapytanie wyszukiwania i przetestuj wyniki wyszukiwania (Twoje zapytanie będzie się różnić w zależności od zawartości Twojego konta).

Łącznik Dropbox indeksuje również informacje o tożsamości lokalnej z Dropbox. W przypadku użytkowników ustawia identyfikator e-mail użytkownika jako główny. W przypadku grup ustawia identyfikator grupy jako główny. Aby filtrować wyniki wyszukiwania według użytkowników/grup, przejdź do Search Console.

Kliknij "Przetestuj zapytanie z nazwą użytkownika lub grupami”, aby go rozwinąć i kliknij przycisk z napisem „zastosuj nazwę użytkownika lub grupy".

Wprowadź nazwę użytkownika i/lub grupy i kliknij Aplikuj. Następnie wprowadź zapytanie i naciśnij Enter. Daje to przefiltrowany zestaw wyników na podstawie Twoich kryteriów.

Gratulacje! Udało Ci się wykorzystać Amazon Kendra, aby uzyskać odpowiedzi i informacje na podstawie zawartości zindeksowanej z Twojego konta Dropbox.

Generuj trwałe tokeny dla dostępu offline

Instrukcje zawarte w tym poście przeprowadzą Cię przez proces tworzenia, konfigurowania i używania tymczasowego tokena dostępu. Aplikacje mogą również uzyskać dostęp długoterminowy, żądając dostępu w trybie offline, w którym to przypadku aplikacja otrzymuje token odświeżania, którego można użyć do pobrania nowych krótkotrwałych tokenów dostępu w razie potrzeby bez dalszej ręcznej interwencji użytkownika. Więcej informacji znajdziesz w Przewodnik Dropbox OAuth i Dokumentacja autoryzacyjna Dropbox. Wykonaj poniższe czynności, aby utworzyć trwały token odświeżania (na przykład, aby ustawić wyzwalanie synchronizacji zgodnie z harmonogramem):

1. Uzyskaj klucz aplikacji i klucz tajny aplikacji, jak poprzednio.
2. W nowej przeglądarce przejdź do https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. Zaakceptuj ustawienia domyślne i wybierz Prześlij.
4. Dodaj KONTUNUUJ.
   
5. Dodaj Dopuszczać.
   
   Kod dostępu jest dla Ciebie generowany.
6. Skopiuj kod dostępu.
   
   Teraz otrzymasz token odświeżania z kodu dostępu.
7. W oknie terminala uruchom następujące polecenie curl:

   curl https://api.dropbox.com/oauth2/token -d code= -d grant_type=authorization_code -u :

   

Możesz przechowywać ten token odświeżania wraz z kluczem aplikacji i kluczem tajnym aplikacji, aby skonfigurować token stały w konfiguracji źródła danych dla Amazon Kendra. Amazon Kendra generuje token dostępu i używa go w razie potrzeby w celu uzyskania dostępu.

Ograniczenia

To rozwiązanie ma następujące ograniczenia:

• Komentarze do plików nie są importowane do indeksu
• Nie masz możliwości dodania niestandardowych metadanych dla Dropbox
• Dokumenty, arkusze i slajdy Google wymagają przestrzeni roboczej Google lub konta Google i nie są dołączone

Wnioski

Dzięki łącznikowi Dropbox dla Amazon Kendra organizacje mogą bezpiecznie korzystać z repozytorium informacji przechowywanych na ich koncie, korzystając z inteligentnego wyszukiwania obsługiwanego przez Amazon Kendra.

W tym poście przedstawiliśmy Ci podstawy, ale jest wiele dodatkowych funkcji, których nie omówiliśmy. Na przykład:

• Możesz włączyć kontrolę dostępu opartą na użytkownikach dla swojego indeksu Amazon Kendra i ograniczyć dostęp do skonfigurowanych użytkowników i grup
• Możesz określić allowedUsersColumn i allowedGroupsColumn dzięki czemu możesz zastosować kontrolę dostępu odpowiednio na podstawie użytkowników i grup
• Możesz zmapować dodatkowe pola do atrybutów indeksu Amazon Kendra i włączyć je do facetingu, wyszukiwania i wyświetlania w wynikach wyszukiwania
• Możesz zintegrować źródło danych Dropbox z funkcją niestandardowego wzbogacania dokumentów (CDE) w Amazon Kendra, aby wykonać dodatkową logikę mapowania atrybutów, a nawet niestandardową transformację treści podczas przetwarzania

Aby dowiedzieć się więcej o tych możliwościach i nie tylko, zapoznaj się z Przewodnik dla programistów Amazon Kendra.

---

O autorze

Ashish Lagwankar jest starszym architektem rozwiązań dla przedsiębiorstw w AWS. Jego główne zainteresowania obejmują AI/ML, technologie bezserwerowe i kontenerowe. Ashish ma siedzibę w Bostonie w stanie Massachusetts i lubi czytać, na świeżym powietrzu i spędzać czas z rodziną.