Panoramica

Il connettore Jira Cloud per Gemini Enterprise fornisce l'accesso ai tuoi dati Jira Cloud, consentendoti di interagire con i tuoi progetti, problemi e informazioni utente.

Versioni di Jira Cloud supportate

Il connettore Jira Cloud supporta la versione 2 dell'API REST di Jira Cloud.

Azioni supportate

Quando il connettore Jira Cloud è abilitato, gli utenti finali possono utilizzare comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni.

Azione Descrizione
Crea commento Crea un nuovo commento su un problema Jira specificato per aggiungere feedback, aggiornamenti o note.
Aggiorna commento Modifica il testo di un commento esistente.
Crea problema Crea un nuovo problema in un progetto Jira Cloud. Per crearne uno, devi fornire un riepilogo, l'ID progetto e l'ID tipo di problema.
Aggiorna problema Aggiorna un problema esistente in Jira Cloud. Devi fornire l'ID problema per identificarlo e puoi modificare vari campi, come il riepilogo, la descrizione e l'assegnatario.

Oltre a queste, sono disponibili altre azioni di sola lettura.

Ambiti obbligatori

Per consentire a Gemini Enterprise di eseguire ricerche e azioni utilizzando il datastore Jira Cloud, sono necessari i seguenti ambiti:

Modalità di connessione Ambito Finalità
Ricerca federata e azioni read:jira-user, read:jira-work Necessario per recuperare e visualizzare i risultati di ricerca e i dettagli utente in tempo reale.
write:jira-work Consente all'assistente di modificare gli elementi di lavoro (ad es. aggiornare i campi dei problemi).
write:comment:jira Consente all'assistente di pubblicare nuovi commenti o risposte direttamente dall'interfaccia di ricerca.
write:issue:jira Necessario per creare nuovi problemi o apportare modifiche importanti a quelli esistenti.
Solo ricerca federata read:jira-user, read:jira-work Obbligatorio per cercare e visualizzare problemi, progetti e profili utente.
Importazione e azioni sui dati read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Obbligatorio per l'importazione dati su larga scala e la sincronizzazione dei metadati di utenti/gruppi.
read:issue-security-level:jira, read:issue-security-scheme:jira Fondamentale per controllo dell'accesso dell'accesso; garantisce che i dati importati rispettino i limiti di sicurezza di Jira.
read:audit-log:jira Utilizzato per monitorare le modifiche ed eseguire sincronizzazioni incrementali per mantenere aggiornati i dati importati.
write:jira-work Necessario per eseguire azioni di scrittura sugli elementi di lavoro all'interno dell'ambiente importato.
write:comment:jira Obbligatorio per aggiungere commenti ai problemi utilizzando l'assistente.
write:issue:jira Consente di creare o modificare i problemi.
Importazione dati read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Necessario per eseguire la scansione e l'indicizzazione dei contenuti Jira e delle relazioni tra utenti.
read:issue-security-level:jira, read:issue-security-scheme:jira Necessario per mappare le autorizzazioni in modo che solo gli utenti autorizzati possano cercare i dati importati.
read:audit-log:jira Necessario per consentire al motore di sincronizzazione di identificare gli elementi aggiornati o eliminati.

Per informazioni su come configurare questi ambiti, vedi Configurare l'ambito minimo dell'applicazione.

Limiti di frequenza per l'importazione dati

Il connettore Jira Cloud supporta un limite di frequenza predefinito di 12 query al secondo (QPS) per l'importazione dati. Questi limiti di frequenza si applicano esclusivamente all'importazione di dati dal connettore Jira Cloud.

Limitazioni

Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sull'utilizzo del connettore Jira Cloud.

  • L'applicazione di un perimetro di Controlli di servizio VPC ai datastore Jira Cloud esistenti non è supportata. Per applicare i Controlli di servizio VPC, devi eliminare e ricreare i datastore. Per saperne di più sui Controlli di servizio VPC e su come utilizzare le azioni dopo averli attivati, consulta Proteggere l'app con i Controlli di servizio VPC.

  • L'datastore Jira Cloud è supportato solo nelle località globali, statunitensi ed europee.

  • Quando crei una nuova applicazione o aggiungi un datastore a un'applicazione esistente, ti consigliamo di aggiungere un datastore con azioni appartenenti a un singolo tipo di connettore. Ad esempio, non associare due datastore Jira Cloud con azioni abilitate alla stessa applicazione.

Di seguito sono riportate le limitazioni per il connettore di importazione Jira Cloud:

  • Per i dati non strutturati, ogni tipo di media ha restrizioni diverse. Per saperne di più, consulta Preparare i dati per le origini dati personalizzate.

  • Per i dati strutturati, ogni documento non deve superare i 500 KB.

  • I ruoli applicazione con ruoli specifici e non vuoti non possono essere concessi Browse project o autorizzazioni a livello di sicurezza.

  • Le autorizzazioni dei documenti determinate dai campi personalizzati utente o dai campi personalizzati gruppo non sono supportate.

  • Jira Cloud non consente restrizioni a livello di Log lavoro.

  • Jira Cloud non indicizza gli allegati PDF che superano le 2000 pagine.

  • Gli allegati aggiunti ai commenti privati non ereditano le limitazioni di accesso (ACL) dei commenti.

  • Vengono recuperati solo i 20 commenti precedenti per un problema in Jira Cloud.

  • Le tabelle sprint non possono essere importate.

  • Il modello di gestione utenti legacy non è supportato per l'integrazione con Jira Cloud. È supportato solo il modello di gestione centralizzata degli utenti. Per ulteriori informazioni, vedi la guida al consolidamento dell'organizzazione Atlassian.

  • Quando esegui una query su un'entità Jira (ad esempio, un problema), i dati correlati come commenti e allegati non vengono inclusi automaticamente. Questo perché vengono archiviati e indicizzati come entità separate. La ricerca basata sui contenuti di un allegato per trovare il problema principale non è supportata.

Passaggi successivi