Поиск знаний в документах 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, нам нужно несколько подробностей о вашем репозитории. Давайте соберем их заранее.

Доменное имя

Узнайте доменное имя. Например, для Quip URL 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. Он энтузиаст технологий, которому нравится помогать клиентам находить инновационные решения сложных бизнес-задач. В сферу его интересов входят машинное обучение, Интернет вещей, робототехника и системы хранения данных. В свободное время Викас любит собирать роботов, ходить в походы и путешествовать.

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