Configurare un datastore Jira Cloud

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.

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

Prima di iniziare

Prima di configurare la connessione federata Jira Cloud, assicurati di quanto segue:

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

• Per applicare il controllo dell'accesso all'origine dati e proteggere i dati in Google Gemini Enterprise, configura il tuo provider di identità.

• Per configurare il connettore Jira Cloud, devi utilizzare il nuovo modello di gestione centralizzata degli utenti Atlassian. Se utilizzi il modello originale, devi eseguire la migrazione della gestione utenti prima di procedere. Per saperne di più, vedi Ruolo di amministratore del sito.

• Crea un'app OAuth 2.0, ottieni l'ID client e il client secret e configura le autorizzazioni minime dell'applicazione con il consenso di un amministratore di Jira Cloud. Verifica di disporre dell'accesso di amministratore dell'organizzazione Jira all'istanza e al progetto Jira. Con l'accesso amministratore dell'organizzazione, puoi configurare le autorizzazioni minime e fornire privilegi di accesso ai gruppi di utenti.

• (Facoltativo) Per recuperare gli indirizzi email degli utenti da Jira Cloud, anche quando le impostazioni limitano la visibilità delle email, installa l'app User Identity Accessor per Jira Cloud con i privilegi di amministratore del sito Jira per installarla e configurarla in modo da recuperare in modo sicuro gli indirizzi email degli utenti. Potresti non dover installare questa app se gli indirizzi email sono già accessibili pubblicamente.

  Nota: Atlassian sta aggiornando gli elementi dell'interfaccia utente e alcuni elementi menzionati in questa documentazione vengono rinominati (ad esempio, Prodotti viene rinominato App). Per maggiori informazioni, vedi Modifica della terminologia di Atlassian Administration da "prodotti" ad "app".

Crea il datastore Jira Cloud

Per creare un datastore Jira Cloud:

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

   Gemini Enterprise

2. Seleziona o crea un Google Cloud progetto.

   Nota: per accedere al flusso unificato, il tuo progetto deve essere incluso nella lista consentita.

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

4. Fai clic su Crea datastore.

5. Nella sezione Origine, cerca Jira Cloud e fai clic su Seleziona.

6. Nella sezione Dati:

   1. Nella sezione Modalità connettore, seleziona Importazione dati o Ricerca federata come modalità di connessione.

   2. Fai clic su Continua.

   3. Nella sezione Impostazioni di autenticazione, configura l'autenticazione in base alla modalità di connessione scelta.

      1. Fornisci i seguenti dettagli di autenticazione:

         • ID client
         • Client secret
         • URI istanza
         • ID istanza

         Per saperne di più sulle credenziali, consulta Configurazione di Jira Cloud.

      2. Se hai selezionato Ricerca federata, fai clic su Accedi e completa l'accesso ad Atlassian.

      3. Fai clic su Continua.

   4. Nella sezione Destinazioni, inserisci l'URL dell'endpoint Jira Cloud.

   5. Fai clic su Continua.

   6. Nella sezione Entities to search (Entità da cercare) (se hai selezionato Federated search (Ricerca federata)) o Entities to sync (Entità da sincronizzare) (se hai selezionato Data ingestion (Importazione dei dati)):

      1. Seleziona tutte le entità richieste.
      2. Se hai selezionato Ricerca federata, vai al passaggio successivo.
      3. Se hai selezionato Importazione dei dati, continua con i seguenti passaggi:
         1. (Facoltativo) Per sincronizzare progetti specifici, segui questi passaggi:
            1. Fai clic su Filtro.
            2. Per filtrare le entità dall'indice, seleziona la casella di controllo Escludi dall'indice o, per assicurarti che siano incluse nell'indice, seleziona la casella di controllo Includi nell'indice.
            3. Inserisci le chiavi. Premi Invio dopo ogni tasto.
            4. Fai clic su Salva.
         2. Per configurare la pianificazione della sincronizzazione, segui questi passaggi:
            1. Nell'elenco Sync frequency (Frequenza di sincronizzazione), seleziona la frequenza di sincronizzazione.
               • Per pianificare sincronizzazioni complete separate dei dati di entità e identità, espandi il menu nella sezione Full sync (Sincronizzazione completa) e seleziona Custom options (Opzioni personalizzate).
            2. Nell'elenco Incremental sync frequency (Frequenza di sincronizzazione incrementale), seleziona la frequenza di sincronizzazione incrementale. Per saperne di più, vedi Pianificazioni di sincronizzazione.

7. Fai clic su Continua.

8. Nella sezione Azioni:

   1. Se hai selezionato Ricerca federata:
      1. In Seleziona le azioni di Jira Cloud da abilitare, seleziona le azioni della categoria per abilitarle per il connettore.

   2. Se hai selezionato Importazione dati:

      1. Nella sezione Impostazioni di autenticazione, configura l'autenticazione in base alla modalità di connessione scelta.

      2. Fornisci i seguenti dettagli di autenticazione:

         • ID client
         • Client secret
         • URI istanza
         • ID istanza

         Per saperne di più sulle credenziali, consulta Configurazione di Jira Cloud.

      3. Fai clic su Accedi e accedi a Jira Cloud per verificare il tuo account.

      4. Fai clic su Continua.

      5. In Seleziona le azioni di Jira Cloud da abilitare, seleziona le azioni della categoria per abilitarle per il connettore.

      Nota: se salti l'aggiunta di azioni in questo passaggio, devi creare un nuovo datastore per aggiungere azioni. Per visualizzare l'elenco delle azioni, vedi Visualizzare le azioni.

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

12. Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Datastore.

Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Dopo che lo stato del datastore passa da Creazione ad Attivo, il connettore Jira Cloud è pronto per essere utilizzato.

Per un connettore di importazione creato con Jira Cloud, lo stato del datastore passa da Creazione a In esecuzione all'avvio della sincronizzazione. Dopodiché, lo stato diventa Active (Attivo) al termine dell'importazione, a indicare che il datastore è completamente configurato. A seconda del volume di dati, l'importazione potrebbe richiedere diverse ore.

Dopo aver creato il datastore, crea un'app, collegala al datastore Jira Cloud e autorizza Gemini Enterprise ad accedere a Jira Cloud prima di eseguire qualsiasi query.

Abilita la sincronizzazione in tempo reale per l'importazione dati

Anteprima - Real-time sync

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

La sincronizzazione in tempo reale sincronizza solo le entità documento e non i dati correlati alle entità identità. La tabella seguente mostra gli eventi dei documenti supportati con la sincronizzazione in tempo reale.

Entità Jira	Crea	Aggiorna	Elimina	Modifiche alle autorizzazioni
Problemi
Worklogs
Progetti
Commenti
Allegati

Per abilitare la sincronizzazione in tempo reale per un connettore dell'origine dati Jira Cloud:

Genera un URL webhook

1. Vai alla pagina Gemini Enterprise e fai clic su Data Stores (Datastore) nel menu di navigazione.
2. Seleziona un datastore Jira Cloud.

3. Fai clic su View/Edit (Visualizza/Modifica) nella riga Realtime sync (Sincronizzazione in tempo reale).

4. Nella finestra di dialogo View and edit realtime sync parameters (Visualizza e modifica i parametri di sincronizzazione in tempo reale), procedi nel seguente modo:

   1. Per attivare la sincronizzazione in tempo reale, fai clic sul pulsante di attivazione/disattivazione Enable realtime sync (Abilita sincronizzazione in tempo reale).
   2. Inserisci un valore nel campo Client secret e copialo. Questo valore ti servirà di nuovo quando creerai un webhook nella console di amministrazione di Jira.
   3. Fai clic su Salva.

5. Dopo che lo stato di Realtime sync (Sincronizzazione in tempo reale) cambia in Running, fai clic su View/Edit (Visualizza/Modifica).

6. Nella finestra di dialogo View and edit realtime sync parameters (Visualizza e modifica i parametri di sincronizzazione in tempo reale), procedi nel seguente modo:

   1. Copia l'URL webhook.
   2. Fai clic su Chiudi.

Crea un webhook

1. Accedi alla console di amministrazione di Jira.
2. Fai clic su Settings (Impostazioni) e seleziona System (Sistema).
3. Nel riquadro System settings (Impostazioni di sistema), seleziona Webhooks.
4. Fai clic su Create a webhook (Crea un webhook). Per informazioni sui webhook, consulta la pagina Webhook.
5. Inserisci un nome per il webhook.
6. Seleziona Status (Stato) come Enabled.
7. Nel campo URL, incolla l'URL copiato da Gemini Enterprise e aggiungi /{issue.id}.

8. Nel campo Secret, inserisci lo stesso valore che hai inserito durante la generazione di un URL webhook in Gemini Enterprise.

   Nota: per verificare la coerenza dei dati ed evitare errori durante la configurazione dei webhook in Jira, seleziona solo le entità abilitate per la sincronizzazione nel datastore.

9. Nella sezione Eventi correlati al problema, seleziona le seguenti opzioni:

   Entità	Creata	Aggiornata	Eliminata
   Problema	Sì	Sì	Sì
   Log lavoro	Sì	Sì	Sì
   Commento	Sì	Sì	Sì
   Allegato	Sì	No	Sì

10. Nella sezione Project related events (Eventi correlati al progetto), seleziona le caselle di controllo created (creato), updated (aggiornato) e deleted (eliminato) per l'entità Project (Progetto).

11. Fai clic su Crea.

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

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

Passaggi successivi

• Per fornire un'interfaccia utente per interrogare i dati Jira Cloud, crea un'app e connettila al datastore Jira Cloud.
• Per visualizzare l'elenco delle azioni, vedi Visualizza 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 Configura gli avvisi per i datastore di terze parti.