View a markdown version of this page

Integración de Box Agent - Amazon Quick

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración de Box Agent

Con el conector Box Agent, puedes acceder a las funciones de IA de Box, gestionar archivos y carpetas y organizar el contenido de los centros directamente en Amazon Quick mediante un lenguaje natural.

Amazon Quick admite los siguientes métodos de autenticación para Box Agent.

  • Aplicación OAuth predeterminada: utiliza una aplicación OAuth AWS gestionada por usted. No se necesitan credenciales adicionales. Te autenticas directamente con tu cuenta de Box.

  • Aplicación OAuth personalizada: utiliza una aplicación OAuth 2.0 gestionada por el cliente y registrada en Box Developer Console. Esta opción le da a su organización un control total sobre la configuración de OAuth.

Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Asegúrese de disponer de lo siguiente antes de configurar la integración.

  • Una cuenta de Box con acceso a archivos y carpetas.

  • Para una aplicación OAuth personalizada: accede a la consola de desarrolladores de Box para crear una aplicación personalizada. Para obtener más información, consulta la configuración de OAuth 2.0 en la documentación de Box.

  • Para conocer los requisitos de suscripción a Amazon Quick, consulteConfigurar integraciones en la consola.

Configuración del conector en Amazon Quick

Conectarse desde la pestaña Disponible

Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte directamente desde la pestaña Disponible sin necesidad de realizar ninguna configuración adicional.

  1. En la consola Amazon Quick, selecciona Connectors.

  2. En la pestaña Disponible, busca Box Agent y selecciona Connect.

  3. Complete el flujo de inicio de sesión de Box y conceda los permisos solicitados.

Para configurar un conector con la aplicación OAuth personalizada, usa la pestaña Crear para tu equipo, tal y como se describe a continuación.

Crea desde la pestaña Crear para tu equipo

Si utilizas la autenticación de aplicaciones OAuth personalizada, crea una aplicación personalizada en Box Developer Console antes de configurar Amazon Quick. Para obtener instrucciones de configuración, consulte la configuración de OAuth 2.0 en la documentación de Box.

  1. En la consola Amazon Quick, selecciona Connectors.

  2. Selecciona la pestaña Crear para tu equipo.

  3. Busca y elige Box Agent.

    nota

    Si ya existe un conector Box Agent, aparecerá un cuadro de diálogo con los conectores existentes. Para usar un conector existente, elíjalo. Para crear uno nuevo, elija No, crear nuevo.

  4. Introduzca un nombre para el conector. Si lo desea, elija + Añadir descripción para añadir una descripción.

  5. En Tipo de conexión, elija Red pública.

  6. Para la configuración de OAuth, elija una de las siguientes opciones:

    1. Para la aplicación OAuth predeterminada:

      No se necesitan credenciales adicionales. Elija Siguiente para continuar.

    2. Para la aplicación OAuth personalizada, configura los siguientes campos:

      • URL base (opcional): la URL base de la API de Box. Ejemplo: https://mcp.box.com

      • ID de cliente: el ID de cliente de tu aplicación Box.

      • Secreto de cliente: el secreto de cliente de tu aplicación Box.

  7. Elija Siguiente.

  8. Se abre una ventana de autorización de Box. Revisa los permisos solicitados y selecciona Conceder acceso a Box.

  9. En la página de revisión, revise las acciones disponibles para el conector. Elija Siguiente.

  10. En la página de publicación, elija quién puede acceder al conector. Puedes habilitar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.

  11. Elija Publicar.

Acciones disponibles

Tras configurar el conector, estarán disponibles las siguientes acciones.

Acciones disponibles de Box Agent
Categoría Action Description (Descripción)
IA Preguntas y respuestas sobre IA (Hub) Haz una pregunta a un Box Hub con Box AI.
IA Preguntas y respuestas sobre IA (archivo único) Haga una pregunta a un solo archivo con Box AI.
IA Preguntas y respuestas sobre IA (varios archivos) Haz una pregunta a varios archivos con Box AI.
IA AI Extract (formato libre) Extraiga los metadatos de los archivos con Box AI en formato libre.
IA AI Extract (estructurado) Extraiga metadatos estructurados de los archivos con Box AI en función de campos personalizados o una plantilla de metadatos.
Archivos Obtenga el contenido de los archivos Extraiga y devuelva el contenido del archivo en formato de texto para archivos de menos de 50 MB.
Archivos Obtenga los detalles del archivo Obtenga información completa sobre los archivos, incluidos los metadatos, los permisos y los detalles de la versión.
Archivos Actualice las propiedades del archivo Actualice los metadatos del archivo, incluidos el nombre, la descripción, las etiquetas y las colecciones.
Archivos Cargar archivo Sube un archivo nuevo a Box.
Archivos Cargue la versión del archivo Cargue una nueva versión de un archivo existente.
Archivos Buscar archivos Busque archivos mediante palabras clave con soporte para filtros de metadatos y filtrado de extensiones de archivos.
Carpetas Crear carpeta Crea una nueva carpeta en Box.
Carpetas Obtenga los detalles de la carpeta Recupere información completa de las carpetas, incluidos los metadatos y la configuración de colaboración.
Carpetas Listar el contenido de la carpeta Listar los archivos, carpetas y enlaces web de una carpeta.
Carpetas Actualizar las propiedades de la carpeta Actualice los metadatos de la carpeta, incluidos el nombre, la descripción, las etiquetas y las colecciones.
Carpetas Carpetas de búsqueda Busque carpetas por nombre mediante la coincidencia de palabras clave.
Mazas Crear hub Crea un nuevo centro para organizar el contenido.
Mazas Obtenga los detalles del hub Recupera información sobre un hub específico.
Mazas Consigue objetos de Hub Recupera elementos de un hub, incluidos archivos, carpetas y enlaces web.
Mazas Núcleos de listas Enumere todos los centros a los que puede acceder el usuario actual.
Mazas Hub de actualizaciones Actualiza el título o la descripción de un hub.
Mazas Añadir artículos al hub Añade archivos, carpetas o enlaces web a un hub.
Comentarios y tareas Crear comentario de archivo Crea un comentario nuevo en un archivo.
Comentarios y tareas Lista de comentarios del archivo Listar todos los comentarios de un archivo.
Comentarios y tareas Enumere las tareas Enumere todas las tareas asociadas a un archivo.
Users ¿Quién soy Devuelve información sobre el usuario autenticado actualmente.

Administración y solución de problemas

Para obtener instrucciones sobre cómo editar, compartir o eliminar el conector, consulteAdministrar las integraciones existentes.

  • La ventana emergente de autenticación falla: compruebe que su navegador permite ventanas emergentes del dominio de Amazon Quick console.

  • Credenciales de cliente no válidas (aplicación OAuth personalizada): compruebe que el ID de cliente y el secreto del cliente coincidan con los valores de su aplicación Box Developer Console.

  • Permisos insuficientes: compruebe que su cuenta de Box tenga acceso a los archivos, carpetas o centros a los que intenta acceder.