Configura un datastore Box

Questa pagina descrive come creare un datastore e connettere Box a Gemini Enterprise.

Prima di iniziare

Prima di configurare la connessione a Box, segui questi passaggi:

  1. Concedi il ruolo Discovery Engine Editor (roles/discoveryengine.editor). Questo ruolo è necessario per consentire all'utente di creare il datastore. Per concedere questo ruolo:

    1. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM

    2. Individua l'account utente e fai clic su edit Modifica.
    3. Concedi all'utente il ruolo Discovery Engine Editor. Per saperne di più, consulta Ruoli e autorizzazioni IAM.

  2. Configura l'integrazione di Box per Gemini Enterprise. Per maggiori dettagli, consulta il Passaggio 1: configura l'integrazione di Box nella documentazione di Box.

Crea il datastore Box

Per creare il datastore Box, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Vai a Gemini Enterprise

  2. Fai clic su Datastore nel menu di navigazione.

  3. Fai clic su Crea datastore.

  4. Nella sezione Connettori di terze parti, seleziona Box.

  1. Nella sezione Dati:

    1. Se il flusso di creazione del datastore mostra una sezione Opzioni avanzate, puoi selezionare la casella di controllo Abilita indirizzi IP statici al suo interno. In questo modo, il datastore utilizza un insieme fisso di indirizzi IP per il traffico in uscita, adatto per l'inserimento nella lista consentita nel sistema di origine. Per saperne di più, consulta Configura il traffico in uscita con IP statico.

    2. Fai clic su Continua.

    3. Nella sezione Entità da cercare, seleziona le entità in cui vuoi che Gemini Enterprise esegua la ricerca. Per Box, seleziona Box MCP.

  2. Fai clic su Continua.

  3. Nella sezione Configurazione:

    1. Dall'elenco Multiregionale, seleziona la località per il datastore.

    2. Nel campo Nome connettore dati, inserisci un nome per il datastore.

    3. (Facoltativo) Nel campo Tag, inserisci un identificatore stabile per questo datastore tra le versioni. Questo valore è immutabile dopo l'impostazione.

    4. Se hai selezionato us o eu come posizione, configura le impostazioni di crittografia:

      • (Facoltativo) Se non hai configurato le chiavi a singola regione, fai clic su Go to settings page (Vai alla pagina delle impostazioni) per farlo. Per saperne di più, consulta Registra una chiave a singola regione per i connettori di terze parti.
      • Seleziona Chiave di crittografia gestita daGoogle o Chiave Cloud KMS.
      • Se hai selezionato Chiave Cloud KMS:
        • Nell'elenco Tipo di gestione delle chiavi, seleziona il tipo appropriato.
        • Nell'elenco Chiave Cloud KMS, seleziona la chiave.

    5. (Facoltativo) Nella sezione Policy di Sensitive Data Protection, allega una policy di Sensitive Data Protection esistente per ispezionare e anonimizzare i dati recuperati da Gemini Enterprise tramite questo datastore. Se la tua organizzazione non richiede una policy di Sensitive Data Protection, puoi saltare questo passaggio.

  4. Fai clic su Crea.

Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Dopo che lo stato del datastore passa da Creating (Creazione in corso…) ad Active (Attivo), il datastore Box è pronto per essere utilizzato.

Dopo aver creato il datastore, collegalo a un'app esistente o crea una nuova app e collegala alla nuova app, quindi autorizza Gemini Enterprise ad accedere a Box prima di eseguire qualsiasi query.

Abilita azioni

Per impostazione predefinita, tutte le azioni sono disattivate. Quando colleghi Box, tutti i suoi strumenti vengono importati e visualizzati come azioni nel datastore di Gemini Enterprise. Per attivare queste azioni per i tuoi utenti, segui questi passaggi:

  1. Vai al tuo datastore Box.

  2. Fai clic su Azioni > Ricarica le azioni personalizzate per eseguire nuovamente l'autenticazione.

  3. Seleziona le azioni da abilitare.

  4. Fai clic su Attiva azioni.

Gestione dei dati ed esecuzione delle query

Questa sezione descrive come Gemini Enterprise gestisce la tua query e le implicazioni per la privacy dell'utilizzo del datastore federato.

Esecuzione delle query

Dopo aver autorizzato Box e inviato una query di ricerca a Gemini Enterprise:

  • Gemini Enterprise invia la query di ricerca direttamente all'API Box.
  • Gemini Enterprise combina i risultati con quelli di altre origini dati connesse e mostra un risultato di ricerca completo.

Gestione dei dati

Quando utilizzi la ricerca federata di terze parti, si applicano le seguenti regole di gestione dei dati:

  • La stringa di query viene inviata al backend di ricerca di terze parti (API Box).
  • Queste terze parti potrebbero associare le query alla tua identità.
  • Se sono abilitate più origini dati di ricerca federata, la query potrebbe essere inviata a tutte.
  • Dopo che i dati raggiungono il sistema di terze parti, sono regolati dai termini di servizio e dalle norme sulla privacy di quel sistema.

Passaggi successivi