Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiungere azioni Jira Cloud

Quando le azioni Jira sono attive, gli utenti finali possono chiedere all'assistente di eseguire le seguenti azioni Jira Cloud:

Crea problemi Jira
Modificare i problemi Jira

Ad esempio, un utente potrebbe inserire nell'app "crea una storia Jira chiamata "Lancia il progetto Y" nel progetto ABC" o "aggiorna il titolo del ticket Jira JCD-1 in "Lancia il progetto Y". L'assistente chiede ulteriori dettagli, se necessario, e poi chiede all'utente di confermare la richiesta di creazione o modifica.

L'assistente può leggere e modificare i seguenti campi Jira tramite le azioni:

Campo	Descrizione
ID problema	Obbligatorio. ID del problema da modificare, ad esempio KAN-123.
Titolo	Titolo del problema.
Tipo di problema	Tipo di problema.
Priorità	Priorità del problema.
Stato	Stato del problema.
Descrizione	Descrizione del problema in formato Markdown.
Componente	Componente del problema.
Assegnatario	Assegnatario del problema, ad esempio user@google.com.

Configura l'autenticazione e le autorizzazioni in Jira

Prima di attivare le azioni Jira, un amministratore Jira deve configurare credenziali OAuth 2.0 dedicate per le azioni in Jira. È necessario per connettere l'integrazione Jira e consentire l'autorizzazione di lettura e scrittura per le azioni.

I client di autorizzazione per le azioni Jira sono diversi da quelli per l'importazione dei dati Jira. Utilizzano autorizzazioni diverse e una configurazione dell'URL di callback diversa. Per informazioni su come configurare i client di autorizzazione per i connettori Jira Cloud per l'importazione dei dati, consulta Connettere Jira Cloud.

Queste istruzioni spiegano come creare un ID client e un client secret tramite la console per sviluppatori Atlassian, configurare gli ambiti OAuth 2.0 richiesti e impostare le autorizzazioni per gli utenti. Infine, recupera l'URL e l'ID dell'istanza, configura i ruoli ed esegui l'autenticazione per leggere e scrivere i dati tra Jira Cloud e Google.

Crea l'ID client e il client secret

Accedi a developer.atlassian.com.
Fai clic sull'icona del profilo nell'angolo in alto a destra e seleziona Developer Console.
Fai clic su Create (Crea) e seleziona OAuth 2.0 Integration (Integrazione OAuth 2.0).
Inserisci un nome per l'app.
- Seleziona la casella di controllo dei Termini e condizioni.
- Fai clic su Create (Crea).
Fai clic su Authorization (Autorizzazione).
Nella tabella Authorization type (Tipo di autorizzazione), seleziona Add (Aggiungi) per OAuth 2.0 (3LO).
Nel campo Callback URL (URL di callback), inserisci https://vertexaisearch.cloud.google.com/oauth-redirect, quindi fai clic su Salva modifiche.
Fai clic su Autorizzazioni:
1. Vai all'API Jira, fai clic su Aggiungi e poi su Configura.
2. Vai alla scheda Ambiti classici e fai clic su Modifica ambiti. Seleziona gli ambiti seguenti, poi salva le modifiche:
  - Ambiti classici:
    - read:jira-work
    - read:jira-user
    - write:jira-work
  - Ambiti granulari:
    - read:user:jira
Fai clic su Distribuzione, seleziona Modifica e segui questi passaggi:
1. Seleziona prima il pulsante di opzione Condivisione per attivare la modifica di altri campi.
2. Compila i campi rimanenti.
  1. In Vendor (Fornitore), seleziona Google.
  2. In Privacy policy (Norme sulla privacy), inserisci https://policies.google.com.
  3. Per Does your app store personal data? (La tua app memorizza dati personali?), seleziona Yes.
  4. Seleziona la casella di controllo I confirm that I've implemented the personal data reporting API (Confermo di aver implementato l'API per la generazione di report sui dati personali).
3. Fai clic su Salva modifiche.
Seleziona Settings (Impostazioni) per copiare l'ID client e il client secret.

Recuperare l'URL e l'ID istanza

Per ottenere l'URL dell'istanza:

Vai su atlassian.net e accedi con il tuo account amministratore.
Seleziona l'app che desideri sincronizzare. Ad esempio, sincronizza la prima app.
Trova l'URL dell'istanza, ovvero il sottodominio nella barra degli indirizzi.

Per ottenere l'ID istanza:

Apri una nuova scheda, copia l'URL dell'istanza e aggiungi /_edge/tenant_info all'URL dell'istanza. Ad esempio, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info.
Vai al link per trovare il valore di cloudId. cloudId è l'ID istanza.

Configurare autorizzazioni e ruoli

Accedi ad atlassian.com con il tuo account amministratore.
Fai clic sull'icona del menu in alto a sinistra o vai su admin.atlassian.com.
Nella pagina Amministrazione, fai clic su Gestisci utenti e vai alla pagina Gruppi.
Fai clic su Crea gruppo. Inserisci un nome per il gruppo e crealo.
Nella sezione Accesso ai prodotti del gruppo della pagina del nuovo gruppo, fai clic su Aggiungi prodotti al gruppo.
Per Jira, seleziona User access admin (Amministratore accesso utente) come ruolo del prodotto.
Per Jira Admin, seleziona Product admin (Amministratore prodotto) come ruolo del prodotto e salva le modifiche.
Nella pagina Gruppi, fai clic su Aggiungi membri del gruppo e aggiungi utenti o account per l'autenticazione del connettore.

Ottenere un token di aggiornamento

Se prevedi di configurare le azioni Jira utilizzando la console Google Cloud , non devi ottenere un token di aggiornamento.

Se devi utilizzare l'API per configurare le azioni Jira, è necessario un token di aggiornamento. Per ottenere un token di aggiornamento:

Vai alla tua app nella console Google Cloud .
Seleziona Autorizzazione.
Seleziona Configura accanto a OAuth 2.0 (3LO).
Per l'URL di reindirizzamento, utilizza un segnaposto come https://example.com.
Per ottenere un token di aggiornamento nel flusso di autorizzazione iniziale, aggiungi offline_access al parametro scope dell'URL di autorizzazione. Ad esempio: https://auth.atlassian.com/authorize?audience=api.atlassian.com&client_id=your_client_id**&scope=offline_access**%20read%3Ajira-user&redirect_uri=https%3A%2F%2Fyour-redirect-url&state=%24%7BYOUR_USER_BOUND_VALUE%7D&response_type=code&prompt=consent
Una volta autorizzato, il sistema ti reindirizzerà all'URL di reindirizzamento. Nella barra degli indirizzi, dovresti vedere un parametro di ricerca chiamato "code". Prendi nota del suo valore.
Utilizza strumenti come curl o Postman per inviare una richiesta POST a https://auth.atlassian.com/oauth/token, con un oggetto JSON con le seguenti chiavi:
1. grant_type: authorization_code
2. client_id: il tuo ID client
3. client_secret: il client secret
4. code: il codice ottenuto nel passaggio 6
5. redirect_uri: il tuo URI di reindirizzamento
Riceverai refresh_token nella risposta

Per saperne di più sui token di aggiornamento, consulta Implementazione del flusso del token di aggiornamento nella documentazione di Atlassian.

Configura un'azione Jira

Questa sezione descrive come creare un connettore Jira per le azioni e come attivare le azioni Jira per l'assistente.

Prima di iniziare

Prima di configurare le azioni, assicurati che i seguenti passaggi siano completati:

Il tuo progetto deve essere aggiunto alla lista consentita per le azioni dell'assistente
Un amministratore Jira ha completato i passaggi descritti in Configurare l'autenticazione e le autorizzazioni in Jira e ti ha fornito le seguenti informazioni:
- ID client
- Client secret
- ID istanza
- Token di aggiornamento. Obbligatorio solo per la creazione di azioni Jira tramite l'API anziché tramite la console Google Cloud . Google consiglia di creare azioni tramite la console Google Cloud .

Configurare le azioni Jira nella console Google Cloud

Google consiglia di creare azioni tramite la console Google Cloud .

Per aggiungere azioni alla tua app utilizzando la console:

Nella console Google Cloud , vai alla pagina Gemini Enterprise.
Vai all'app.
Nel menu di navigazione, fai clic su Azioni.
Per Jira, fai clic su Connetti.
Seleziona un'istanza Jira.
Se richiesto, inserisci i dati di autorizzazione per il connettore. Questa operazione è necessaria solo se l'istanza non è ancora stata configurata per un'azione.
Seleziona le azioni da attivare.
Fai clic su Termina configurazione. L'azione viene visualizzata nella pagina Azioni.

Creare e abilitare azioni Jira utilizzando l'API

Google consiglia di creare azioni tramite la console Google Cloud . Se devi creare azioni utilizzando l'API, procedi nel seguente modo:

Crea un connettore Jira e configuralo per la ricerca:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "jira",
    "params": {
      "client_id": "{Client ID of your Jira integration}",
      "client_secret": "{Client Secret of your Jira integration}",
      "refresh_token": "{Refresh Token of your Jira integration}",
      "instance_id": "{Your Jira Cloud instance ID}"
    },
    "refreshInterval": "{ >1800 }s",
    "entities": [
      {
        "entityName" : "project",
        "params" : {
          "inclusion_filters" : {}
        }
      },
      {
        "entityName": "{attachment/comment/issue/worklog}" // Optional, you can build up to 4 different entities
      }
    ],
    "syncMode": "PERIODIC"
  }
}

Sostituisci quanto segue:

PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
COLLECTION_ID: l'ID della raccolta.
COLLECTION_DISPLAY_NAME: un nome visualizzato per la raccolta.

Includi le configurazioni delle azioni nel connettore Jira:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "action_config": {
    "is_action_configured": true,
    "action_params": {
        "client_id": "{Client id from Jira integration}",
        "client_secret": "{Client secret from Jira integration}",
        "instance_uri": "{instance URI of your Jira instance}"
      }
    }
  }'

Attiva le azioni Jira per l'assistente:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "<var>PROJECT_NUMBER</var>")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/CONNECTOR_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "create_jira_issue",
            "actionDisplayName": "Create Jira Issue"
          }
        ]
      }
    }
  }'