Індексуйте свій вміст Dropbox за допомогою конектора Dropbox для Amazon Kendra

Амазонка Кендра це дуже точний і простий у використанні інтелектуальний пошуковий сервіс на основі машинного навчання (ML). Amazon Kendra пропонує набір конекторів джерел даних, щоб спростити процес прийому та індексування вашого вмісту, де б він не знаходився.

Цінні дані в організаціях зберігаються як у структурованих, так і в неструктурованих сховищах. Рішення корпоративного пошуку повинно мати можливість об’єднувати дані з кількох структурованих і неструктурованих сховищ для індексування та пошуку.

Одним із таких сховищ даних є Dropbox. Корпоративні користувачі використовують Dropbox для завантаження, передачі та зберігання документів у хмарі. Окрім можливості зберігати документи, Dropbox пропонує Dropbox Paper, інструмент спільного редагування, який дозволяє користувачам співпрацювати та створювати вміст в одному місці. Dropbox Paper може додатково використовувати шаблони для додавання структури документам. Окрім файлів і паперу, Dropbox також дозволяє зберігати ярлики веб-сторінок у ваших папках.

Ми раді повідомити, що тепер ви можете використовувати конектор Amazon Kendra для Dropbox для пошуку інформації, що зберігається у вашому обліковому записі Dropbox. У цій публікації ми покажемо, як індексувати інформацію, що зберігається в Dropbox, і використовувати функцію інтелектуального пошуку Amazon Kendra. Крім того, інтелектуальний пошук Amazon Kendra на базі ML може точно знаходити інформацію в неструктурованих документах, які мають наративний вміст природною мовою, для яких пошук за ключовими словами не дуже ефективний.

Огляд рішення

За допомогою Amazon Kendra ви можете налаштувати кілька джерел даних, щоб забезпечити центральне місце для пошуку у вашому сховищі документів. Для нашого рішення ми демонструємо, як індексувати сховище або папку Dropbox за допомогою конектора Amazon Kendra для Dropbox. Рішення складається з наступних кроків:

1. Налаштуйте програму на Dropbox і отримайте деталі підключення.
2. Зберігайте деталі в Менеджер секретів AWS.
3. Створіть джерело даних Dropbox через консоль Amazon Kendra.
4. Індексуйте дані в сховищі Dropbox.
5. Виконайте зразок запиту, щоб отримати інформацію.

Передумови

Щоб випробувати з’єднувач Amazon Kendra для Dropbox, вам потрібно:

Налаштуйте програму Dropbox і зберіть деталі підключення

Перш ніж ми налаштуємо джерело даних Dropbox, нам потрібні деякі відомості про ваше сховище Dropbox. Давайте зберемо їх заздалегідь.

1. До www.dropbox.com/developers.
2. Вибирати Консоль програми.
   
3. Увійдіть, використовуючи свої облікові дані (переконайтеся, що ви входите в обліковий запис Enterprise).
   
4. Вибирати Створити додаток.
   
5. Select Область доступу.
6. Select Повний Dropbox (або назву конкретної папки, яку ви бажаєте проіндексувати).
7. Введіть назву програми.
8. Вибирати Створити додаток.
   
   Ви можете побачити екран конфігурації з набором вкладок.
9. Щоб налаштувати дозволи, виберіть Дозволи Вкладка.
   
10. Виберіть мінімальний набір дозволів, як показано на наступних знімках екрана.
    
11. Вибирати Надіслати.
    
    З’являється повідомлення про успішну зміну дозволу.
    
12. на Налаштування скопіюйте ключ програми.
13. Вибирати шоу поруч з Секрет програми і скопіюйте секрет.
14. під Згенерований маркер доступувиберіть Генерувати і скопіюйте маркер.
    

Зберігайте ці значення в безпечному місці — нам потрібно буде звернутися до них пізніше.

Токен сесії дійсний до 4 годин. Ви повинні генерувати новий маркер сеансу кожного разу, коли ви індексуєте вміст.

Зберігайте облікові дані Dropbox у диспетчері секретів

Щоб зберегти облікові дані Dropbox у диспетчері секретів, виконайте такі дії:

1. На консолі Secrets Manager виберіть Зберігайте новий секрет.
2. Вибирати Інший тип секрету.
3. Створіть три пари ключ-значення для appKey, appSecret та refreshToken і введіть значення, збережені з Dropbox.
4. Вибирати зберегти.
   
5. для Секретна назва, введіть назву (наприклад, AmazonKendra-dropbox-secret).
6. Введіть необов’язковий опис.
7. Вибирати МАЙБУТНІ.
   
8. У Налаштувати обертання розділі, залиште всі параметри за замовчуванням і виберіть МАЙБУТНІ.
   
9. на Розгляд сторінку, виберіть Магазин.
   

Налаштуйте конектор Amazon Kendra для Dropbox

Щоб налаштувати конектор Amazon Kendra, виконайте такі кроки:

1. На консолі Amazon Kendra виберіть Створіть покажчик.
   
2. для Назва покажчика, введіть назву індексу (наприклад, my-dropbox-index).
3. Введіть необов’язковий опис.
4. для Назва ролі, введіть назву ролі IAM.
5. Налаштуйте додаткові параметри шифрування та теги.
6. Вибирати МАЙБУТНІ.
   
7. У Налаштувати контроль доступу користувачів розділ, залиште параметри за замовчуванням і виберіть МАЙБУТНІ.
   
8. для Забезпечення виданнявиберіть Видання для розробників.
9. Вибирати Створювати.
   
   Це створює та поширює роль IAM, а потім створює індекс Amazon Kendra, що може зайняти до 30 хвилин.
10. Вибирати Джерела даних у навігаційній панелі.
    
11. під Dropboxвиберіть Додати роз'єм.
    
12. для Назва джерела даних, введіть назву (наприклад, my-dropbox-connector).
13. Введіть необов’язковий опис.
14. Вибирати МАЙБУТНІ.
    
15. для Тип маркера автентифікаціївиберіть Токен доступу (тимчасове використання).
16. для Секретний секрет AWS Secrets Manager, виберіть секрет, який ви створили раніше.
17. для Роль IAMвиберіть Створіть нову роль.
18. для Назва ролі, введіть назву (наприклад, AmazonKendra-dropbox-role).
19. Вибирати МАЙБУТНІ.
    
20. для Виберіть сутності або типи вмісту, виберіть типи вмісту.
21. для частотавиберіть Запуск на вимогу.
22. Вибирати МАЙБУТНІ.
    
23. Установіть будь-які додаткові зіставлення полів і виберіть МАЙБУТНІ.
24. Вибирати Перегляньте та створіть І вибирай Додати джерело даних.
25. Вибирати Синхронізуйте зараз.
    
26. Дочекайтеся завершення синхронізації.
    

Перевірте розчин

Тепер, коли ви перемістили вміст із свого облікового запису Dropbox у свій індекс Amazon Kendra, ви можете протестувати деякі запити.

Перейдіть до свого покажчика та виберіть Пошук індексованого вмісту. Введіть зразок пошукового запиту та перевірте результати пошуку (ваш запит буде відрізнятися залежно від вмісту вашого облікового запису).

Конектор Dropbox також сканує локальну ідентифікаційну інформацію з Dropbox. Для користувачів він встановлює ідентифікатор електронної пошти користувача як основну. Для груп він встановлює ідентифікатор групи як основну. Щоб відфільтрувати результати пошуку за користувачами/групами, перейдіть до Search Console.

Натисніть на "Тестовий запит із іменем користувача або групами", щоб розгорнути його, і натисніть кнопку з написом "застосувати ім'я користувача або групи".

Введіть імена користувачів і/або груп і натисніть Застосовувати. Далі введіть пошуковий запит і натисніть enter. Це принесе вам відфільтрований набір результатів на основі ваших критеріїв.

Щиро вітаю! Ви успішно використали Amazon Kendra для отримання відповідей і думок на основі вмісту, проіндексованого з вашого облікового запису Dropbox.

Створюйте постійні маркери для офлайн-доступу

Інструкції в цій публікації допоможуть вам створити, налаштувати та використовувати тимчасовий маркер доступу. Програми також можуть отримати довгостроковий доступ, запитуючи офлайн-доступ, і в цьому випадку програма отримує маркер оновлення, який можна використовувати для отримання нових короткочасних маркерів доступу за потреби без подальшого ручного втручання користувача. Ви можете знайти більше інформації в Посібник Dropbox OAuth та Документація авторизації Dropbox. Виконайте наведені нижче дії, щоб створити постійний маркер оновлення (наприклад, щоб налаштувати синхронізацію на запуск за розкладом):

1. Отримайте ключ і секрет програми, як і раніше.
2. У новому браузері перейдіть до https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. Прийміть значення за замовчуванням і виберіть Надіслати.
4. Вибирати продовжувати.
   
5. Вибирати дозволяти.
   
   Для вас буде згенеровано код доступу.
6. Скопіюйте код доступу.
   
   Тепер ви отримуєте маркер оновлення з коду доступу.
7. У вікні терміналу виконайте таку команду curl:

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

   

Ви можете зберегти цей маркер оновлення разом із ключем програми та секретом програми, щоб налаштувати постійний маркер у конфігурації джерела даних для Amazon Kendra. Amazon Kendra генерує маркер доступу та використовує його за потреби для доступу.

Недоліки

Це рішення має такі обмеження:

• Коментарі файлів не імпортуються в індекс
• У вас немає можливості додати власні метадані для Dropbox
• Документи, таблиці та слайди Google потребують робочої області Google або облікового запису Google і не включені

Висновок

За допомогою конектора Dropbox для Amazon Kendra організації можуть безпечно отримати доступ до сховища інформації, що зберігається в їхніх облікових записах, за допомогою інтелектуального пошуку на основі Amazon Kendra.

У цій публікації ми познайомили вас з основами, але є багато додаткових функцій, які ми не розглянули. Наприклад:

• Ви можете ввімкнути контроль доступу на основі користувачів для свого індексу Amazon Kendra та обмежити доступ користувачам і групам, які ви налаштовуєте
• Ви можете вказати allowedUsersColumn та allowedGroupsColumn тож ви можете застосувати керування доступом на основі користувачів і груп відповідно
• Ви можете зіставити додаткові поля з атрибутами індексу Amazon Kendra та активувати їх для фасетування, пошуку та відображення в результатах пошуку
• Ви можете інтегрувати джерело даних Dropbox із можливістю Custom Document Enrichment (CDE) в Amazon Kendra, щоб виконувати додаткову логіку відображення атрибутів і навіть користувальницьке перетворення вмісту під час прийому даних.

Щоб дізнатися про ці та інші можливості, зверніться до Посібник розробника Amazon Kendra.

---

Про автора

Ашиш Лагванкар є старшим архітектором корпоративних рішень в AWS. Його основні інтереси включають AI/ML, безсерверні та контейнерні технології. Ешіш живе в Бостоні, штат Массачусетс, і любить читати на свіжому повітрі та проводити час зі своєю родиною.