View a markdown version of this page

Integrazione con Box Agent - Amazon Quick

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integrazione con Box Agent

Con il connettore Box Agent, puoi accedere alle funzionalità AI di Box, gestire file e cartelle e organizzare i contenuti negli hub direttamente in Amazon Quick tramite linguaggio naturale.

Amazon Quick supporta i seguenti metodi di autenticazione per Box Agent.

  • App OAuth predefinita: utilizza un'applicazione OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Ti autentichi direttamente con il tuo account Box.

  • App OAuth personalizzata: utilizza un'applicazione OAuth 2.0 gestita dal cliente registrata nella Box Developer Console. Questa opzione offre all'organizzazione il pieno controllo sulla configurazione OAuth.

Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.

Prima di iniziare

Assicurati di disporre di quanto segue prima di configurare l'integrazione.

  • Un account Box con accesso a file e cartelle.

  • Per l'app OAuth personalizzata: accedi alla Box Developer Console per creare un'app personalizzata. Per ulteriori informazioni, consulta la configurazione di OAuth 2.0 nella documentazione di Box.

  • Per i requisiti di abbonamento ad Amazon Quick, consultaConfigura le integrazioni nella console.

Configurazione del connettore in Amazon Quick

Connect dalla scheda Available

Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda Disponibile senza configurazioni aggiuntive.

  1. Nella console Amazon Quick, scegli Connettori.

  2. Nella scheda Disponibile, trova Box Agent e scegli Connect.

  3. Completa il flusso di accesso a Box e concedi le autorizzazioni richieste.

Per configurare invece un connettore con l'app OAuth personalizzata, usa la scheda Crea per il tuo team come descritto di seguito.

Crea dalla scheda Crea per il tuo team

Se utilizzi l'autenticazione personalizzata dell'app OAuth, crea un'app personalizzata nella Box Developer Console prima di configurare Amazon Quick. Per le istruzioni di configurazione, consulta la configurazione di OAuth 2.0 nella documentazione di Box.

  1. Nella console Amazon Quick, scegli Connettori.

  2. Scegli la scheda Crea per il tuo team.

  3. Trova e scegli Box Agent.

    Nota

    Se esiste già un connettore Box Agent, viene visualizzata una finestra di dialogo con i connettori esistenti. Per utilizzare un connettore esistente, selezionalo. Per crearne uno nuovo, scegli No, crea nuovo.

  4. Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.

  5. Per Tipo di connessione, scegli Rete pubblica.

  6. Per la configurazione OAuth, scegli una delle seguenti opzioni:

    1. Per l'app OAuth predefinita:

      Non sono necessarie credenziali aggiuntive. Seleziona Successivo per continuare.

    2. Per l'app OAuth personalizzata, configura i seguenti campi:

      • URL di base (opzionale): l'URL di base dell'API Box. Ad esempio: https://mcp.box.com

      • ID cliente: l'ID cliente dell'app Box.

      • Segreto del cliente: il segreto del cliente dell'app Box.

  7. Scegli Next (Successivo).

  8. Si apre una finestra di autorizzazione Box. Controlla le autorizzazioni richieste e scegli Concedi l'accesso a Box.

  9. Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).

  10. Nella pagina Pubblica, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.

  11. Seleziona Pubblica.

Operazioni disponibili

Dopo aver configurato il connettore, sono disponibili le seguenti azioni.

Azioni disponibili in Box Agent
Categoria Azione Description
Intelligenza artificiale Domande e risposte sull'IA (Hub) Fai una domanda a un Box Hub utilizzando Box AI.
Intelligenza artificiale Domande e risposte sull'IA (file singolo) Fai una domanda a un singolo file utilizzando Box AI.
Intelligenza artificiale Domande e risposte sull'IA (più file) Fai una domanda a più file utilizzando Box AI.
Intelligenza artificiale Estratto AI (formato libero) Estrai i metadati dai file utilizzando Box AI in formato libero.
Intelligenza artificiale Estratto AI (strutturato) Estrai i metadati strutturati dai file utilizzando Box AI in base a campi personalizzati o a un modello di metadati.
File Ottieni il contenuto dei file Estrai e restituisci il contenuto dei file in formato testo per i file di dimensioni inferiori a 50 MB.
File Ottieni i dettagli del file Ottieni informazioni complete sui file, inclusi metadati, autorizzazioni e dettagli sulla versione.
File Aggiorna le proprietà dei file Aggiorna i metadati dei file tra cui nome, descrizione, tag e raccolte.
File Carica file Carica un nuovo file su Box.
File Carica la versione del file Carica una nuova versione di un file esistente.
File Cerca nei file Cerca file utilizzando parole chiave con supporto per i filtri dei metadati e il filtraggio delle estensioni di file.
Cartelle Create Folder Crea una nuova cartella in Box.
Cartelle Ottieni i dettagli della cartella Recupera informazioni complete sulle cartelle, inclusi i metadati e le impostazioni di collaborazione.
Cartelle Elenca il contenuto della cartella Elenca file, cartelle e collegamenti Web in una cartella.
Cartelle Aggiorna le proprietà delle cartelle Aggiorna i metadati delle cartelle tra cui nome, descrizione, tag e raccolte.
Cartelle Cartelle di ricerca Cerca le cartelle per nome utilizzando la corrispondenza delle parole chiave.
Hub Crea Hub Crea un nuovo hub per l'organizzazione dei contenuti.
Hub Ottieni i dettagli dell'hub Recupera informazioni su un hub specifico.
Hub Ottieni articoli Hub Recupera elementi all'interno di un hub, inclusi file, cartelle e collegamenti Web.
Hub Elenca hub Elenca tutti gli hub accessibili all'utente corrente.
Hub Aggiorna Hub Aggiorna il titolo o la descrizione di un hub.
Hub Aggiungi elementi all'Hub Aggiungi file, cartelle o collegamenti Web a un hub.
Commenti e attività Crea commento al file Crea un nuovo commento su un file.
Commenti e attività Commenti ai file di elenco Elenca tutti i commenti su un file.
Commenti e attività Elenca attività Elenca tutte le attività associate a un file.
Utenti Chi sono Restituisce informazioni sull'utente attualmente autenticato.

Gestione e risoluzione dei problemi

Per istruzioni su come modificare, condividere o eliminare il connettore, consultaGestione delle integrazioni esistenti.

  • Il popup di autenticazione non riesce: verifica che il tuo browser consenta i popup dal dominio della console Amazon Quick.

  • Credenziali client non valide (app OAuth personalizzata): verifica che l'ID cliente e il segreto del cliente corrispondano ai valori dell'app Box Developer Console.

  • Autorizzazioni insufficienti: verifica che il tuo account Box abbia accesso ai file, alle cartelle o agli hub a cui stai tentando di accedere.