Configura un datastore Linear

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

Anteprima pubblica:le funzionalità di ricerca e azioni federate sono in Anteprima pubblica. Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Prima di iniziare

Prima di configurare il datastore Linear:

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

2. Per applicare il controllo dell'accesso all'origine dati e proteggere i dati in Gemini Enterprise, assicurati di aver configurato il tuo provider di identità.

3. Crea un'app nelle impostazioni dell'API Linear e ottieni le credenziali di autenticazione. Per saperne di più, consulta Configurazione lineare.

Crea il datastore Linear

Per creare un datastore Linear:

1. Nella console Google Google Cloud , 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 Linear nel campo di ricerca. Viene visualizzata la scheda Lineare.

6. Fai clic su Seleziona.

7. Nella sezione Dati, compila i seguenti campi:

   1. Nella sezione Authentication settings (Impostazioni di autenticazione), inserisci i valori che hai copiato quando hai creato un'app nelle impostazioni dell'API Linear:

      • Per ID client, inserisci l'ID client dell'app Linear.

      • Per Client secret, inserisci il client secret dell'app Linear.

      Per maggiori informazioni sulla creazione di un'app nelle impostazioni dell'API Linear, vedi Configurazione di Linear.

   2. 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. Puoi scegliere tra i seguenti tipi:

      • Problema

      • Progetto

      • Team

      • Commento

   5. Fai clic su Continua.

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

   Nota: se salti l'aggiunta di azioni in questo passaggio, potrai aggiungerle in un secondo momento. Per maggiori informazioni, vedi Aggiungi azioni.

   Per gestire l'elenco delle azioni, vedi Gestire le azioni.

9. Nella sezione Configurazione:

   1. Dall'elenco Multiregionale, seleziona la posizione per il connettore dati.
   2. Nel campo Nome del 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 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 Google-managed encryption key (Chiave di crittografia gestita daGoogle) o Cloud KMS key (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.

10. Fai clic su Continua.

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

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 Linear è pronto per essere utilizzato.

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

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

Nota:per migliorare l'accuratezza, un LLM potrebbe riscrivere la query prima dell'invio a Linear. Questa query riscritta può incorporare informazioni dalla cronologia delle query della sessione. Di conseguenza, parti della cronologia delle query potrebbero essere incluse anche nella query inviata all'API Linear.

Passaggi successivi

• Per fornire un'interfaccia utente per fare query sui dati, crea un'app, collegala al datastore Linear, e autorizza Gemini Enterprise a connettersi a Linear.

• Per gestire l'elenco delle azioni, vedi Gestire le azioni.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca.

• Per abilitare gli avvisi per il datastore, vedi Configurare gli avvisi per i datastore di terze parti.