Configurare un datastore Dropbox

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

Prima di iniziare

Prima di configurare il datastore Dropbox:

  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 sull'icona Modifica Modifica.
    3. Concedi all'utente il ruolo Discovery Engine Editor. Per saperne di più, consulta Ruoli e autorizzazioni IAM.

  2. Crea un'app nella console per le app Dropbox. Per saperne di più, consulta la sezione Configurazione di Dropbox.

Crea il datastore Dropbox

Per creare un datastore Dropbox:

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

    Gemini Enterprise

  2. Seleziona o crea un Google Cloud progetto.

  3. Nel menu di navigazione, fai clic su Datastore.

  4. Fai clic su Crea datastore.

  5. Nella pagina Seleziona un'origine dati, inserisci Dropbox nel campo di ricerca. Viene visualizzata la scheda Dropbox.

  6. Fai clic su Seleziona.

    Seleziona l'origine dati Dropbox

  7. Nella sezione Dati, compila i seguenti campi:

    1. Per il campo Modalità connettore, seleziona Ricerca federata e fai clic su Continua.

    2. In Impostazioni di autenticazione, inserisci i valori che hai copiato quando hai creato un'app nella console per sviluppatori Dropbox:

      • Per ID client, inserisci la chiave app dell'app Dropbox.

      • Per Client secret, inserisci il secret dell'app dell'app Dropbox.

      Per saperne di più sulla creazione di un'app in Dropbox App Console, vedi Configurazione di Dropbox.

      Fornisci l'ID client e il client secret

      Fai clic su Login (Accedi).

    3. Fai clic su Continua.

    4. Nella sezione Entità da cercare, seleziona i tipi di entità che vuoi che Gemini Enterprise cerchi.

      Seleziona le entità da includere nella ricerca

      Fai clic su Continua.

  8. Nella sezione Azioni, seleziona le azioni che vuoi che gli utenti possano eseguire nei propri account Dropbox utilizzando l'assistente Gemini Enterprise.

    Seleziona le azioni da abilitare per il connettore

  9. Nella sezione Configurazione:

    1. Dall'elenco Multiregionale, seleziona la posizione per il connettore dati.
    2. Nel campo Nome connettore dati, inserisci un nome per il connettore.
    3. 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 Vai alla pagina delle impostazioni per farlo. Per saperne di più, consulta Registrare 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.
      Per saperne di più, vedi Chiavi di crittografia gestite dal cliente.

    Seleziona una località e inserisci un nome per il datastore

    Fai clic su Continua.

  10. Nella sezione Fatturazione, seleziona Prezzi generali o Prezzi configurabili. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti e Licenze.

    Seleziona un modello di prezzi

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

Dopo aver creato il datastore, esegui le seguenti operazioni prima di eseguire qualsiasi query:

  1. Crea un'app.

  2. Collega l'app al datastore Dropbox.

  3. Autorizza Gemini Enterprise a connettersi a Dropbox.

Per informazioni sulle autorizzazioni richieste per eseguire una ricerca, consulta Autorizzazioni minime.

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 Dropbox e inviato una query di ricerca a Gemini Enterprise:

  • Gemini Enterprise invia la query di ricerca direttamente all'API Dropbox.
  • 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 Dropbox).
  • 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.
  • Una volta 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