

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 Action
<a name="box-action-integration"></a>

Con el conector de acción de Box, 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, consulte[Métodos de autenticación](quick-action-auth.md).

## Antes de empezar
<a name="box-action-prerequisites"></a>

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](https://developer.box.com/guides/authentication/oauth2/oauth2-setup) en la documentación de Box.
+ Para conocer los requisitos de suscripción a Amazon Quick, consulte[Configurar integraciones en la consola](integration-console-setup-process.md).

## Configuración del conector en Amazon Quick
<a name="box-action-quicksuite-setup"></a>

### Conectarse desde la pestaña Disponible
<a name="box-action-quick-connect"></a>

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**.

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

1. 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
<a name="box-action-full-setup"></a>

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](https://developer.box.com/guides/authentication/oauth2/oauth2-setup) Box.

1. En la consola Amazon Quick, selecciona **Connectors**.

1. Selecciona la pestaña **Crear para tu equipo**.

1. 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**.

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

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

1. 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.

   1. 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.

1. Elija **Siguiente**.

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

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

1. 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.

1. Elija **Publicar**.

## Acciones disponibles
<a name="box-action-available-actions"></a>

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 | Busque carpetas | 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. | 

## Administra y soluciona problemas
<a name="box-action-troubleshooting"></a>

Para obtener instrucciones sobre cómo editar, compartir o eliminar el conector, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).
+ **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.