Panoramica

Il datastore 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 datastore Jira Cloud supporta la versione 2 dell'API REST Jira Cloud.

Azioni supportate

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

Azione Descrizione
Crea commento Crea un nuovo commento su un problema Jira specifico 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.
Modificare lo stato del problema Modifica lo stato di un problema esistente in Jira Cloud. Devi fornire l'ID problema per identificarlo.
Carica allegato Carica un allegato in un problema esistente in Jira Cloud.

Ambiti obbligatori

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

Ambiti classici

Modalità di connessione Autorizzazione Finalità
Ricerca federata e azioni read:jira-user, read:jira-work Consente all'assistente di recuperare e visualizzare i risultati di ricerca e i dettagli dell'utente in tempo reale.
write:jira-work Consente all'assistente di modificare gli elementi di lavoro (ad es. aggiornare i campi dei problemi) e gestire i commenti o i problemi.
Solo ricerca federata read:jira-user, read:jira-work Consente all'assistente di cercare e visualizzare problemi, progetti e profili utente.
Importazione e azioni sui dati read:jira-work Consente all'assistente di eseguire la scansione e l'indicizzazione generali dei dati degli elementi di lavoro.
write:jira-work Consente all'assistente di eseguire azioni di scrittura (creazione, aggiornamenti, commenti) sugli elementi di lavoro all'interno dell'ambiente importato.
Importazione dati read:jira-work Consente all'assistente di eseguire la scansione e l'indicizzazione dei contenuti Jira per la disponibilità della ricerca.

Ambiti granulari

Modalità di connessione Autorizzazione Finalità
Ricerca federata e azioni write:comment:jira Consente all'datastore di pubblicare nuovi commenti o risposte direttamente dall'interfaccia di ricerca.
write:issue:jira Consente al datastore di creare nuovi problemi o apportare modifiche importanti a quelli esistenti.
write:attachment:jira Consente al datastore di aggiungere allegati ai problemi Jira.
read:issue:jira Consente all'datastore di leggere i problemi.
read:issue-type:jira Consente all'datastore di leggere i tipi di problemi.
read:comment:jira Consente al datastore di leggere i commenti.
read:comment.property:jira Consente all'datastore di leggere le proprietà dei commenti relativi ai problemi.
read:project:jira Consente al datastore di leggere i progetti.
read:priority:jira Consente al datastore di leggere le priorità.
read:issue.transition:jira Consente al datastore di leggere le transizioni dei problemi.
read:issue-meta:jira Consente all'datastore di leggere i metadati dei problemi.
read:board-scope.admin:jira-software Consente all'datastore di leggere la configurazione, le funzionalità del progetto, i filtri, le proprietà e i filtri rapidi per una bacheca.
read:board-scope:jira-software Consente all'datastore di leggere le bacheche, i problemi in una bacheca, i problemi di un backlog, i report e le versioni.
read:issue-details:jira Consente all'datastore di leggere i dettagli del problema.
read:jql:jira Consente al datastore di leggere le query Jira Query Language (JQL).
Solo ricerca federata read:issue:jira Consente all'datastore di leggere i problemi.
read:issue-type:jira Consente all'datastore di leggere i tipi di problemi.
read:comment:jira Consente al datastore di leggere i commenti.
read:comment.property:jira Consente all'datastore di leggere le proprietà dei commenti relativi ai problemi.
read:project:jira Consente al datastore di leggere i progetti.
read:priority:jira Consente al datastore di leggere le priorità.
read:issue.transition:jira Consente al datastore di leggere le transizioni dei problemi.
read:issue-meta:jira Consente all'datastore di leggere i metadati dei problemi.
read:board-scope.admin:jira-software Consente all'datastore di leggere la configurazione, le funzionalità del progetto, i filtri, le proprietà e i filtri rapidi per una bacheca.
read:board-scope:jira-software Consente all'datastore di leggere le bacheche, i problemi in una bacheca, i problemi di un backlog, i report e le versioni.
read:issue-details:jira Consente all'datastore di leggere i dettagli del problema.
read:jql:jira Consente al datastore di leggere le query Jira Query Language (JQL).
Importazione e azioni sui dati read:user:jira, read:group:jira, read:avatar:jira Consente la sincronizzazione dei metadati di utenti/gruppi e la visualizzazione dei profili utente.
read:issue-security-level:jira, read:issue-security-scheme:jira Consente il controllo dell'accesso, garantendo che i dati importati rispettino i limiti di sicurezza di Jira.
read:audit-log:jira Consente di monitorare le modifiche ed eseguire sincronizzazioni incrementali per mantenere aggiornati i dati importati.
write:comment:jira Consente di aggiungere commenti ai problemi utilizzando il datastore.
write:issue:jira Consente all'assistente di creare o modificare i problemi.
Importazione dati read:user:jira, read:group:jira, read:avatar:jira Consente la scansione e l'indicizzazione dei contenuti Jira e delle relazioni utente.
read:issue-security-level:jira, read:issue-security-scheme:jira Consente di mappare le autorizzazioni in modo che solo gli utenti autorizzati possano cercare i dati importati.
read:audit-log:jira Consente 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 datastore Jira Cloud supporta un limite di velocità predefinito di 12 query al secondo (QPS) per l'importazione dati. Questi limiti di frequenza si applicano esclusivamente all'importazione di dati dal datastore Jira Cloud.

Limitazioni

Questa sezione descrive i problemi noti e le limitazioni che potrebbero influire sul tuo utilizzo del datastore Jira Cloud.

  • Quando crei una nuova app o aggiungi un datastore a uno esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un unico tipo di connettore.
  • 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.

  • Il datastore Jira Cloud non supporta i file .xlsx per l'azione di caricamento.

  • Il datastore Jira Cloud è supportato solo nelle località global, us e eu.

Di seguito sono riportate le limitazioni per il datastore 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