Panoramica

Il datastore Jira Cloud per Gemini Enterprise ti consente di eseguire ricerche e azioni su progetti, problemi e informazioni utente.

Versioni di Jira Cloud supportate

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

Azioni supportate

Quando il datastore 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 il commento Modifica il testo di un commento esistente.
Crea problema Crea un nuovo problema in un progetto cloud Jira. 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 del problema per identificarlo e puoi modificare vari campi, come il riepilogo, la descrizione e l'assegnatario.
Modifica lo stato del problema Modifica lo stato di un problema esistente in Jira Cloud. Per identificare il problema, devi fornire l'ID problema.
Carica allegato Carica un allegato in un problema Jira specificato.
Assegna problema Assegna un problema Jira esistente a un utente specificato.
Problemi relativi ai link Crea un link tra due problemi Jira (ad esempio, blocca, è bloccato da, è correlato a).
Crea progetto Crea un nuovo progetto Jira con un nome, una chiave, un tipo di progetto e un modello specificati.
Aggiorna progetto Aggiorna le impostazioni di un progetto Jira esistente, ad esempio nome, chiave, descrizione o lead.
Crea registro di lavoro Aggiunge una voce del registro di lavoro per il monitoraggio del tempo a un problema Jira.
Aggiorna log di lavoro Aggiorna una voce del registro di lavoro esistente su un problema Jira.
Ottieni la bacheca Recupera una bacheca in Jira.
Recupera i problemi per la bacheca Recupera i problemi di una bacheca in Jira.
Elenca bacheche Elenca le bacheche in Jira.

Ambiti obbligatori

Per consentire a Gemini Enterprise di eseguire ricerche e azioni utilizzando il datastore Jira Cloud, devi disporre dei 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 esempio, aggiornare i campi dei problemi), gestire i commenti o i problemi e caricare gli allegati.
manage:jira-project Consente all'assistente di gestire le impostazioni progetto Jira e di creare nuovi oggetti a livello di progetto, come versioni e componenti. Obbligatorio per le azioni di creazione e aggiornamento dei progetti.
Solo ricerca federata read:jira-user, read:jira-work Consente all'assistente di cercare e visualizzare problemi, progetti e profili utente.
Acquisizione dei dati e azioni read:jira-work Consente all'assistente di eseguire la scansione e l'indicizzazione dei dati generali degli elementi di lavoro.
write:jira-work Consente all'assistente di eseguire azioni di scrittura (creazione, aggiornamenti, commenti e allegati) sugli elementi di lavoro all'interno dell'ambiente importato.
Acquisizione dei dati read:jira-work Consente all'assistente di eseguire la scansione e l'indicizzazione dei contenuti di Jira per la disponibilità della ricerca.

Ambiti granulari

Modalità di connessione Autorizzazione Finalità
Ricerca federata e azioni write:comment:jira Consente al datastore di pubblicare nuovi commenti o risposte direttamente dall'interfaccia di Gemini Enterprise.
write:issue:jira Consente al datastore di creare nuovi problemi o apportare modifiche importanti a quelli esistenti.
write:attachment:jira Consente al datastore di caricare allegati nei problemi di Jira.
write:project:jira Consente al datastore di creare e aggiornare i progetti Jira.
write:issue-worklog:jira Consente al datastore di creare e aggiornare i log di lavoro dei problemi.
write:issue-link:jira Consente al datastore di creare e aggiornare i link tra i problemi.
read:issue:jira Consente al datastore di leggere i problemi.
read:issue-type:jira Consente al datastore di leggere i tipi di problemi.
read:comment:jira Consente al datastore di leggere i commenti.
read:comment.property:jira Consente al datastore di leggere le proprietà dei commenti dei 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 al datastore di leggere i metadati dei problemi.
read:board-scope.admin:jira-software Consente al datastore di leggere la configurazione, le funzionalità del progetto, i filtri, le proprietà e i filtri rapidi di una bacheca.
read:board-scope:jira-software Consente al datastore di leggere bacheche, problemi su una bacheca, problemi di un backlog, report e versioni.
read:issue-details:jira Consente al datastore di leggere i dettagli dei problemi.
read:jql:jira Consente al datastore di leggere le query JQL (Jira Query Language).
Solo ricerca federata read:issue:jira Consente al datastore di leggere i problemi.
read:issue-type:jira Consente al datastore di leggere i tipi di problemi.
read:comment:jira Consente al datastore di leggere i commenti.
read:comment.property:jira Consente al datastore di leggere le proprietà dei commenti dei 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 al datastore di leggere i metadati dei problemi.
read:board-scope.admin:jira-software Consente al datastore di leggere la configurazione, le funzionalità del progetto, i filtri, le proprietà e i filtri rapidi di una bacheca.
read:board-scope:jira-software Consente al datastore di leggere bacheche, problemi su una bacheca, problemi di un backlog, report e versioni.
read:sprint:jira-software Consente al datastore di leggere i dettagli dello sprint.
read:issue-details:jira Consente al datastore di leggere i dettagli dei problemi.
read:jql:jira Consente al datastore di leggere le query JQL (Jira Query Language).
Acquisizione dei dati e azioni read:user:jira, read:group:jira, read:avatar:jira Consente di sincronizzare i metadati di utenti/gruppi e di visualizzare i 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.
Acquisizione dei dati read:user:jira, read:group:jira, read:avatar:jira Consente la scansione e l'indicizzazione dei contenuti e delle relazioni degli utenti di Jira.
read:issue-security-level:jira, read:issue-security-scheme:jira Consente di mappare le autorizzazioni in modo che solo gli utenti autorizzati possano eseguire ricerche nei dati importati.
read:audit-log:jira Consente al motore di sincronizzazione di identificare gli elementi che sono stati aggiornati o eliminati.
read:sprint:jira-software Consente al datastore di leggere i dettagli dello sprint.

Per informazioni su come configurare questi ambiti, consulta Configura l'ambito minimo dell'applicazione.

Limiti di frequenza per l'importazione dati

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

Limitazioni

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

  • Quando crei una nuova app o aggiungi un datastore a un'app esistente, ti consigliamo di associare un solo datastore alle azioni appartenenti a un singolo tipo di connettore.
  • L'applicazione di un perimetro dei 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 Proteggi la tua app con i Controlli di servizio VPC.
  • 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 limitazioni diverse. Per saperne di più, consulta Prepara i dati per le origini dati personalizzate.

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

  • Ai ruoli applicazione con ruoli specifici e non vuoti non possono essere concesse autorizzazioni Browse project o 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 relativi a 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 archiviate e indicizzate come entità separate. La ricerca in base ai contenuti di un allegato per trovare il problema principale non è supportata.

Passaggi successivi