Шукайте знання в документах Quip за допомогою інтелектуального пошуку за допомогою конектора Quip для Amazon Kendra

Організації використовують рішення для спільного створення документів, такі як Salesforce Шлях щоб вбудовувати документи для спільної роботи в режимі реального часу в записи Salesforce. Quip — це продуктивна платформа Salesforce, яка змінює спосіб спільної роботи підприємств, забезпечуючи безпечну та просту сучасну співпрацю на будь-якому пристрої. Репозиторій Quip містить безцінні організаційні знання у формі спільних документів і робочих процесів. Однак легко та безпечно знайти ці організаційні знання разом з іншими сховищами документів, такими як Box або Служба простого зберігання Amazon (Amazon S3), може бути складним завданням. Крім того, розмовний характер спільних робочих процесів робить традиційний підхід до пошуку на основі ключових слів неефективним через наявність фрагментованої, розпорошеної інформації в багатьох місцях.

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

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

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

На наступному знімку екрана показано приклад репозиторію Quip.

Робоча область у цьому прикладі має приватну папку, до якої немає спільного доступу. У цій папці є підпапка, яка використовується для зберігання квитанцій про витрати. Інша папка під назвою example.com використовується для спільної роботи з іншими користувачами. Ця папка містить п’ять вкладених папок, у яких міститься документація для розробки.

Щоб налаштувати з’єднувач Quip, ми спочатку запишемо ім’я домену, ідентифікатори папок і маркер доступу репозиторію Quip. Потім ми просто створюємо індекс Amazon Kendra і додаємо Quip як джерело даних.

Передумови

Щоб почати використовувати з’єднувач Quip для Amazon Kendra, у вас має бути сховище Quip.

Збирайте інформацію з Quip

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

Доменне ім'я

Дізнайтеся доменне ім'я. Наприклад, для URL-адреси Quip https://example-com.quip.com/browse, доменне ім’я є quip. Залежно від того, як єдиний вхід (SSO) налаштовано у вашій організації, доменне ім’я може відрізнятися. Збережіть це доменне ім’я для використання пізніше.

Ідентифікатори папок

Папки в Quip мають унікальний ідентифікатор, пов’язаний з ними. Нам потрібно налаштувати з’єднувач Quip для доступу до потрібних папок, вказавши правильні ідентифікатори папок. Для цієї публікації ми індексуємо папку example.com.

Щоб знайти ідентифікатор папки, виберіть папку. URL-адреса змінюється, щоб показати ідентифікатор папки.

Ідентифікатор папки в цьому випадку такий xj1vOyaCGB3u. Складіть список ідентифікаторів папок для сканування; ми використовуємо ці ідентифікатори під час налаштування конектора.

Маркер доступу

Увійдіть у Quip і відкрийте https://{subdomain.domain}/dev/token у веб-браузері. У наступному прикладі ми переходимо до https://example-com.quip.com/dev/token. Тоді виберіть Отримайте особистий маркер доступу.

Скопіюйте маркер для подальшого використання.

Тепер ми маємо інформацію, необхідну для налаштування джерела даних.

Створіть індекс Amazon Kendra

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

1. Увійдіть у Консоль управління AWS і відкрийте консоль Amazon Kendra.

Якщо ви використовуєте Amazon Kendra вперше, ви повинні побачити наступний знімок екрана.

2. Вибирати Створіть індекс.
   
3. для Назва покажчика, введіть my-quip-example-index.
4. для Опис, введіть необов’язковий опис.
5. для Роль IAM, використати наявну роль або створити нову.
6. Вибирати МАЙБУТНІ.
   
7. під Налаштування контролю доступувиберіть Немає щоб зробити весь проіндексований вміст доступним для всіх користувачів.
8. для Розширення групи користувачіввиберіть ніхто.
9. Вибирати МАЙБУТНІ.
   

для Забезпечення видання, ви можете вибрати один із двох варіантів залежно від обсягу вмісту та частоти доступу.

10. Для цієї публікації виберіть Видання для розробників.
11. Вибирати Створювати.
    

Створення ролі займає приблизно 30 секунд; створення індексу може тривати до 30 хвилин. Після завершення ви зможете переглянути свій індекс на консолі Amazon Kendra.

Додайте Quip як джерело даних

Тепер давайте додамо Quip як джерело даних до індексу.

1. На консолі Amazon Kendra під Управління даними на панелі навігації виберіть Джерела даних.
2. Вибирати Додати роз'єм при Шлях.
   
3. для Назва джерела даних, введіть my-quip-data-source.
4. для Опис, введіть необов’язковий опис.
5. Вибирати МАЙБУТНІ.
   
6. Введіть доменне ім’я Quip, яке ви зберегли раніше.
7. під Секретивиберіть Створіть і додайте новий секрет Менеджера секретів.
8. для Секретна назва, введіть назву свого секрету.
9. для Жетон Quip, введіть маркер доступу, який ви зберегли раніше.
10. Вибирати Збережіть та додайте секрет.
    
11. під Роль IAM, виберіть роль або створіть нову.
12. Вибирати МАЙБУТНІ.
    
13. під Область синхронізації, Для Додайте ідентифікатори папок для сканування, введіть ідентифікатори папок, які ви зберегли раніше.
14. під Синхронізуйте розклад виконання¸ для частотавиберіть Запуск на вимогу.
15. Вибирати МАЙБУТНІ.
    

З’єднувач Quip дозволяє захоплювати додаткові поля, такі як автори, категорії та назви папок (і навіть перейменовувати за потреби).

16. Для цієї публікації ми не налаштовуємо зіставлення полів.
17. Вибирати МАЙБУТНІ.
    
18. Підтвердьте всі параметри та додайте джерело даних.

Ваше джерело даних буде готове за кілька хвилин.

19. Коли джерело даних буде готове, виберіть Синхронізуйте зараз.
    

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

Після завершення синхронізації статус синхронізації відображається як успішний. Тепер ваше сховище Quip підключено.

Виконайте пошук в Amazon Kendra

Давайте перевіримо конектор, виконавши кілька пошуків.

1. На консолі Amazon Kendra під Управління даними на панелі навігації виберіть Пошук індексованого вмісту.
   
2. Введіть пошуковий запит у поле пошуку. Для цієї посади ми шукаємо EC2 on Linux.

Наступний знімок екрана показує наші результати.

Недоліки

Існують деякі відомі обмеження для прийому джерела даних. Деякі обмеження пов’язані з необхідністю доступу адміністратора для доступу до певного вмісту, інші – через особливості впровадження. Вони такі:

• Підтримуються лише повні сканування. Якщо ви хочете, щоб конектор підтримував сканування журналу змін, потрібен доступ до API адміністратора, і ви повинні ввімкнути API адміністратора на веб-сайті Quip.
• Скануються лише спільні папки. Навіть якщо ми використовуємо особистий маркер доступу адміністратора, ми не можемо сканувати дані в особистих папках інших користувачів.
• Рішення не підтримує вказівку типів файлів для включення та виключення, оскільки Quip не зберігає розширення типу файлу, а лише ім’я файлу.
• Для подій у реальному часі потрібна підписка та доступ до API адміністратора.

Висновок

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

Щоб отримати додаткові відомості про те, як ви можете створювати, змінювати та видаляти дані та метадані за допомогою спеціального збагачення документів, коли вміст надходить зі сховища Quip, зверніться до Налаштування метаданих документа під час процесу передавання та Доповніть свій вміст і метадані, щоб покращити пошук за допомогою спеціального збагачення документів у Amazon Kendra.

---

Про авторів

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

Вікас Шах є архітектором корпоративних рішень у веб-сервісах Amazon. Він ентузіаст технологій, який любить допомагати клієнтам знаходити інноваційні рішення для складних бізнес-задач. Сфери його інтересів — ML, IoT, робототехніка та зберігання. У вільний час Вікас любить будувати роботів, ходить в походи та подорожувати.

• Coinsmart. Найкраща в Європі біржа біткойн та криптовалют.
• Платоблокчейн. Web3 Metaverse Intelligence. Розширені знання. БЕЗКОШТОВНИЙ ДОСТУП.
• CryptoHawk. Альткойн Радар. Безкоштовне випробування.
• Джерело: https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/