Indexelje Dropbox tartalmát az Amazon Kendra Dropbox csatlakozójával

Amazon Kendra egy rendkívül pontos és egyszerűen használható intelligens keresőszolgáltatás, amelyet gépi tanulás (ML) hajt. Az Amazon Kendra adatforrás-összekötőket kínál, amelyek leegyszerűsítik a tartalom feldolgozásának és indexelésének folyamatát, bárhol is legyen.

A szervezetekben található értékes adatokat strukturált és strukturálatlan adattárak is tárolják. Egy vállalati keresési megoldásnak képesnek kell lennie arra, hogy több strukturált és strukturálatlan adattárból összegyűjtse az adatokat indexeléshez és kereséshez.

One such data repository is Dropbox. Enterprise users use Dropbox to upload, transfer, and store documents to the cloud. Along with the ability to store documents, Dropbox offers Dropbox Paper, a coediting tool that lets users collaborate and create content in one place. Dropbox Paper can optionally use templates to add structure to documents. In addition to files and paper, Dropbox also allows you to store shortcuts to webpages in your folders.

We’re excited to announce that you can now use the Amazon Kendra connector for Dropbox to search information stored in your Dropbox account. In this post, we show how to index information stored in Dropbox and use the Amazon Kendra intelligent search function. In addition, Amazon Kendra’s ML powered intelligent search can accurately find information from unstructured documents having natural language narrative content, for which keyword search is not very effective.

Megoldás áttekintése

With Amazon Kendra, you can configure multiple data sources to provide a central place to search across your document repository. For our solution, we demonstrate how to index a Dropbox repository or folder using the Amazon Kendra connector for Dropbox. The solution consists of the following steps:

1. Configure an app on Dropbox and get the connection details.
2. Tárolja a részleteket AWS Secrets Manager.
3. Create a Dropbox data source via the Amazon Kendra console.
4. Index the data in the Dropbox repository.
5. Futtasson le egy mintalekérdezést az információk beszerzéséhez.

Előfeltételek

To try out the Amazon Kendra connector for Dropbox, you need the following:

Configure a Dropbox app and gather connection details

Before we set up the Dropbox data source, we need a few details about your Dropbox repository. Let’s gather those in advance.

1. Ugrás www.dropbox.com/developers.
2. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a App console.
   
3. Sign in with your credentials (make sure you’re signing in to an Enterprise account).
   
4. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Create app.
   
5. választ Scoped access.
6. választ Full Dropbox (or the name of the specific folder you want to index).
7. Enter a name for your app.
8. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Create app.
   
   You can see the configuration screen with a set of tabs.
9. To set up permissions, choose the Engedélyek Tab.
   
10. Select a minimal set of permissions, as shown in the following screenshots.
    
11. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Küld.
    
    A message appears saying that the permission change was successful.
    
12. A beállítások tab, copy the app key.
13. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Előadás mellett App secret and copy the secret.
14. Alatt Generated access token, választ Generálása and copy the token.
    

Store these values in a safe place—we need to refer to these later.

The session token is valid for up to 4 hours. You have to generate a new session token each time you index the content.

Store Dropbox credentials in Secrets Manager

To store your Dropbox credentials in Secrets Manager, compete the following steps:

1. A Secrets Manager konzolon válassza a lehetőséget Tárolj el egy új titkot.
2. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Más típusú titok.
3. Create three key-value pairs for appKey, appSecretés refreshToken and enter the values saved from Dropbox.
4. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Megtakarítás.
   
5. A Titkos név, írjon be egy nevet (például AmazonKendra-dropbox-secret).
6. Adjon meg egy opcionális leírást.
7. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Következő.
   
8. A Forgatás konfigurálása szakaszban tartsa az összes beállítást az alapértelmezett értéken, és válassza ki Következő.
   
9. A Felülvizsgálat oldalon válassza a lehetőséget bolt.
   

Configure the Amazon Kendra connector for Dropbox

Az Amazon Kendra csatlakozó konfigurálásához hajtsa végre a következő lépéseket:

1. Az Amazon Kendra konzolon válassza a lehetőséget Hozzon létre egy indexet.
   
2. A Index neve, adjon nevet az indexnek (például my-dropbox-index).
3. Adjon meg egy opcionális leírást.
4. A Szerepnév, adja meg az IAM szerepkör nevét.
5. Opcionális titkosítási beállítások és címkék konfigurálása.
6. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Következő.
   
7. A Felhasználói hozzáférés-vezérlés konfigurálása szakaszban hagyja a beállításokat az alapértelmezett értékeken, és válassza ki Következő.
   
8. A Ellátási kiadásokválassza Fejlesztői kiadás.
9. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Teremt.
   
   Ez létrehozza és továbbítja az IAM szerepkört, majd létrehozza az Amazon Kendra indexet, ami akár 30 percig is eltarthat.
10. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Adatforrások a navigációs ablaktáblában.
    
11. Alatt dropbox, választ Csatlakozó hozzáadása.
    
12. A Adatforrás neve, írjon be egy nevet (például my-dropbox-connector).
13. Adjon meg egy opcionális leírást.
14. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Következő.
    
15. A A hitelesítési token típusaválassza Access Token (temporary use).
16. A AWS Secrets Manager titkos, válassza ki a korábban létrehozott titkot.
17. A IAM szerepkör, választ Hozzon létre egy új szerepet.
18. A Szerepnév, írjon be egy nevet (például AmazonKendra-dropbox-role).
19. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Következő.
    
20. A Válasszon entitásokat vagy tartalomtípusokat, válassza ki a tartalomtípusokat.
21. A Frekvencia, választ Fuss igény szerint.
22. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Következő.
    
23. Állítsa be az opcionális mezőleképezéseket, és válassza ki Következő.
24. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Áttekintés és létrehozás És válasszon Adatforrás hozzáadása.
25. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Most szinkronizálja.
    
26. Várja meg, amíg a szinkronizálás befejeződik.
    

Tesztelje az oldatot

Now that you have ingested the content from your Dropbox account into your Amazon Kendra index, you can test some queries.

Menjen az indexbe, és válassza ki Indexelt tartalom keresése. Adjon meg egy minta keresési lekérdezést, és tesztelje keresési eredményeit (a lekérdezése fiókja tartalmától függően változhat).

The Dropbox connector also crawls local identity information from Dropbox. For users, it sets user email id as principal. For groups, it sets group id as principal. To filter search results by users/groups, go to the Search Console.

Kattintson "Tesztlekérdezés felhasználónévvel vagy csoportokkal” to expand it and click on the button that says “felhasználónév vagy csoportok alkalmazása".

Enter the user and/or group names and click alkalmaz. Next, enter the search query and hit enter. This brings you a filtered set of results based on your criteria.

Congratulations! You have successfully used Amazon Kendra to surface answers and insights based on the content indexed from your Dropbox account.

Generate permanent tokens for offline access

The instructions in this post walk you through creating, configuring, and using a temporary access token. Apps can also get long-term access by requesting offline access, in which case the app receives a refresh token that can be used to retrieve new short-lived access tokens as needed, without further manual user intervention. You can find more information in the Dropbox OAuth Guide és a Dropbox authorization documentation. Use the following steps to create a permanent refresh token (for example to set the sync to trigger on a schedule):

1. Get the app key and app secret as before.
2. In a new browser, navigate to https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. Accept the defaults and choose Küld.
4. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a folytatódik.
   
5. A pop-art design, négy időzóna kijelzése egyszerre és méretének arányai azok az érvek, amelyek a NeXtime Time Zones-t kiváló választássá teszik. Válassza a Hagyjuk.
   
   An access code is generated for you.
6. Copy the access code.
   
   Now you get the refresh token from the access code.
7. In a terminal window, run the following curl command:

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

   

You can store this refresh token along with the app key and app secret to configure a permanent token in the data source configuration for Amazon Kendra. Amazon Kendra generates the access token and uses it as needed for access.

korlátozások

Ennek a megoldásnak a következő korlátai vannak:

• File comments are not imported into the index
• You don’t have the option to add custom metadata for Dropbox
• Google docs, sheets, and slides need a Google workspace or Google account and are not included

Következtetés

With the Dropbox connector for Amazon Kendra, organizations can tap into the repository of information stored in their account securely using intelligent search powered by Amazon Kendra.

Ebben a bejegyzésben bemutattuk az alapokat, de számos további funkció is van, amelyekre nem tértünk ki. Például:

• Engedélyezheti a felhasználóalapú hozzáférés-vezérlést az Amazon Kendra indexhez, és korlátozhatja a hozzáférést az Ön által konfigurált felhasználókra és csoportokra
• Megadhatja allowedUsersColumn és a allowedGroupsColumn so you can apply access controls based on users and groups, respectively
• További mezőket társíthat az Amazon Kendra index attribútumaihoz, és engedélyezheti őket a facetingre, a keresésre és a keresési eredményekben való megjelenítésre
• You can integrate the Dropbox data source with the Custom Document Enrichment (CDE) capability in Amazon Kendra to perform additional attribute mapping logic and even custom content transformation during ingestion

Ha többet szeretne megtudni ezekről a lehetőségekről, tekintse meg a Amazon Kendra fejlesztői útmutató.

---

A szerzőről

Ashish Lagwankar az AWS vezető vállalati megoldások építésze. Fő érdeklődési körei közé tartozik az AI/ML, a szerver nélküli és a konténeres technológiák. Ashish Bostonban (MA) él, és szívesen olvas, a szabadban, és a családjával tölt időt.