Busque conocimientos en documentos de Quip con búsqueda inteligente mediante el conector de Quip para Amazon Kendra

Marca de tiempo: 19 de abril de 2022 9:50 p.m.
Nodo de origen: 1270825

Las organizaciones utilizan soluciones de creación de documentos colaborativos como Salesforce Sofismo para incrustar documentos colaborativos en tiempo real dentro de los registros de Salesforce. Quip es la plataforma de productividad de Salesforce que transforma la forma en que las empresas trabajan juntas, ofreciendo una colaboración moderna de forma segura y sencilla en cualquier dispositivo. Un repositorio de Quip captura conocimientos organizacionales invaluables en forma de documentos y flujos de trabajo colaborativos. Sin embargo, encontrar este conocimiento organizativo de forma fácil y segura junto con otros repositorios de documentos, como Box o Servicio de almacenamiento simple de Amazon (Amazon S3), puede ser un desafío. Además, la naturaleza conversacional de los flujos de trabajo colaborativos hace que el enfoque tradicional basado en palabras clave para buscar sea ineficaz debido a que tiene información fragmentada y dispersa en varios lugares.

Nos complace anunciar que ahora puede utilizar el amazona kendra conector para Quip para buscar mensajes y documentos en su repositorio de Quip. En esta publicación, le mostramos cómo encontrar la información que necesita en su repositorio de Quip mediante la función de búsqueda inteligente de Amazon Kendra, con tecnología de aprendizaje automático.

Resumen de la solución

Con Amazon Kendra, puede configurar múltiples fuentes de datos para proporcionar un lugar central para buscar en su repositorio de documentos. Para nuestra solución, demostramos cómo configurar un repositorio de Quip como fuente de datos de un índice de búsqueda mediante el conector de Amazon Kendra para Quip.

La siguiente captura de pantalla muestra un repositorio de Quip de ejemplo.

El espacio de trabajo de este ejemplo tiene una carpeta privada que no se comparte. Esa carpeta tiene una subcarpeta que se usa para guardar los recibos de gastos. Otra carpeta llamada ejemplo.com se comparte con otros y se usa para colaborar con el equipo. Esta carpeta tiene cinco subcarpetas que contienen documentación para el desarrollo.

Para configurar el conector de Quip, primero anotamos el nombre de dominio, los ID de carpeta y el token de acceso del repositorio de Quip. Luego, simplemente creamos el índice de Amazon Kendra y agregamos Quip como fuente de datos.

Requisitos previos

Para comenzar a usar el conector de Quip para Amazon Kendra, debe tener un repositorio de Quip.

Recopilar información de Quip

Antes de configurar la fuente de datos de Quip, necesitamos algunos detalles sobre su repositorio. Reunámoslos por adelantado.

Nombre de dominio y certificado SSL

Averigüe el nombre de dominio. Por ejemplo, para la URL de Quip https://example-com.quip.com/browse, el nombre de dominio es quip. Dependiendo de cómo esté configurado el inicio de sesión único (SSO) en su organización, el nombre de dominio puede variar. Guarde este nombre de dominio para usarlo más tarde.

ID de carpeta

Las carpetas en Quip tienen una identificación única asociada a ellas. Necesitamos configurar el conector de Quip para acceder a las carpetas correctas proporcionando los ID de carpeta correctos. Para esta publicación, indexamos la carpeta example.com.

Para encontrar el ID de la carpeta, seleccione la carpeta. La URL cambia para mostrar el ID de la carpeta.

El ID de la carpeta en este caso es xj1vOyaCGB3u. Haga una lista de las ID de carpetas para escanear; usamos estos ID cuando configuramos el conector.

Token de acceso

Inicie sesión en Quip y abra https://{subdomain.domain}/dev/token en un navegador web. En el siguiente ejemplo, navegamos a https://example-com.quip.com/dev/token. Entonces escoge Obtener token de acceso personal.

Copie el token para usarlo en un paso posterior.

Ahora tenemos la información que necesitamos para configurar la fuente de datos.

Crear un índice de Amazon Kendra

Para configurar su índice de Amazon Kendra, complete los siguientes pasos:

  1. Inicia sesión en el Consola de administración de AWS y abra la consola de Amazon Kendra.

Si está utilizando Amazon Kendra por primera vez, debería ver la siguiente captura de pantalla.

  1. Elige Crea un índice.
  2. Nombre del índice, introduzca my-quip-example-index.
  3. Descripción, ingrese una descripción opcional.
  4. Rol de IAM, use un rol existente o cree uno nuevo.
  5. Elige Siguiente.
  6. under Configuraciones de control de acceso, seleccione No para que todo el contenido indexado esté disponible para todos los usuarios.
  7. Expansión de grupos de usuarios, seleccione Ninguna.
  8. Elige Siguiente.

Ediciones de aprovisionamiento, puedes elegir entre dos opciones según el volumen del contenido y la frecuencia de acceso.

  1. Para esta publicación, seleccione Edición para desarrolladores.
  2. Elige Crear.

La creación de funciones tarda aproximadamente 30 segundos; la creación del índice puede tardar hasta 30 minutos. Cuando termine, puede ver su índice en la consola de Amazon Kendra.

Agregar Quip como fuente de datos

Ahora agreguemos Quip como fuente de datos al índice.

  1. En la consola de Amazon Kendra, en Gestión de datos en el panel de navegación, elija Fuentes de datos.
  2. Elige Agregar conector bajo Sofismo.
  3. Nombre de fuente de datos, introduzca my-quip-data-source.
  4. Descripción, ingrese una descripción opcional.
  5. Elige Siguiente.
  6. Ingrese el nombre de dominio de Quip que guardó anteriormente.
  7. under Misterios, escoger Crear y agregar un nuevo secreto de Secrets Manager.
  8. Nombre secreto, ingrese el nombre de su secreto.
  9. token de broma, ingrese el token de acceso que guardó anteriormente.
  10. Elige Guardar y agregar secreto.
  11. under Rol de IAM, elige un rol o crea uno nuevo.
  12. Elige Siguiente.
  13. under Ámbito de sincronización, Para Agregar ID de carpeta para rastrear, ingrese los ID de carpeta que guardó anteriormente.
  14. under Programación de ejecución sincronizadapara Frecuencia, seleccione Ejecutar bajo demanda.
  15. Elige Siguiente.

El conector de Quip le permite capturar campos adicionales como autores, categorías y nombres de carpetas (e incluso cambiar el nombre según sea necesario).

  1. Para esta publicación, no configuramos ninguna asignación de campo.
  2. Elige Siguiente.
  3. Confirme todas las opciones y agregue la fuente de datos.

Su fuente de datos estará lista en unos minutos.

  1. Cuando su fuente de datos esté lista, elija Sincronizar ahora.

Según el tamaño de los datos en el repositorio de Quip, este proceso puede demorar entre unos minutos y algunas horas. La sincronización es un proceso de dos pasos. En primer lugar, se rastrean los documentos para determinar los que se van a indexar. Luego se indexan los documentos seleccionados. Algunos factores que afectan la velocidad de sincronización incluyen el rendimiento y la limitación del repositorio, el ancho de banda de la red y el tamaño de los documentos.

El estado de sincronización se muestra como exitoso cuando se completa la sincronización. Su repositorio de Quip ahora está conectado.

Ejecutar una búsqueda en Amazon Kendra

Probemos el conector ejecutando algunas búsquedas.

  1. En la consola de Amazon Kendra, en Gestión de datos en el panel de navegación, elija Buscar contenido indexado.
  2. Introduzca su búsqueda en el campo de búsqueda. Para esta publicación, buscamos EC2 on Linux.

La siguiente captura de pantalla muestra nuestros resultados.

Limitaciones

Existen algunas limitaciones conocidas para la ingestión de fuentes de datos. Algunas limitaciones se deben a la necesidad de acceso de administrador para acceder a parte del contenido, otras se deben a detalles de implementación específicos. Son los siguientes:

  • Solo se admiten rastreos completos. Si desea que el conector admita rastreos de registro de cambios, se requiere acceso a la API de administración y debe habilitar la API de administración en el sitio web de Quip.
  • Solo se rastrean las carpetas compartidas. Incluso si usamos el token de acceso personal de un usuario administrador, no podemos rastrear datos en las carpetas privadas de otros usuarios.
  • La solución no admite la especificación de tipos de archivos para inclusión y exclusión, porque Quip no almacena la extensión del tipo de archivo, solo el nombre del archivo.
  • Los eventos en tiempo real requieren una suscripción y acceso a la API de administración.

Conclusión

El conector de Amazon Kendra para Quip permite a las organizaciones hacer que la valiosa información almacenada en los documentos de Quip esté disponible para sus usuarios de forma segura mediante la búsqueda inteligente con la tecnología de Amazon Kendra. El conector también proporciona facetas para los atributos del repositorio de Quip, como autores, tipo de archivo, URI de origen, fechas de creación, archivos principales y categoría para que los usuarios puedan refinar de forma interactiva los resultados de la búsqueda en función de lo que buscan.

Para obtener más información sobre cómo puede crear, modificar y eliminar datos y metadatos mediante el enriquecimiento de documentos personalizados a medida que el contenido se ingiere desde el repositorio de Quip, consulte Personalización de metadatos de documentos durante el proceso de ingesta y Enriquezca su contenido y metadatos para mejorar su experiencia de búsqueda con el enriquecimiento de documentos personalizados en Amazon Kendra.

Acerca de los autores

Ashish Lagwankar es arquitecto sénior de soluciones empresariales en AWS. Sus principales intereses incluyen tecnologías de contenedores, AI/ML y sin servidor. Ashish vive en el área de Boston, MA, y disfruta leer, estar al aire libre y pasar tiempo con su familia.

vikas shah es Arquitecto de Soluciones Empresariales en los servicios web de Amazon. Es un entusiasta de la tecnología que disfruta ayudando a los clientes a encontrar soluciones innovadoras para desafíos comerciales complejos. Sus áreas de interés son ML, IoT, robótica y almacenamiento. En su tiempo libre, a Vikas le gusta construir robots, hacer caminatas y viajar.

Sello de tiempo:

Mas de Aprendizaje automático de AWS