Se usó la API de Cloud Translation para traducir esta página.

Agrega acciones de Jira Cloud

Cuando las acciones de Jira están activadas, los usuarios finales pueden pedirle al asistente que realice las siguientes acciones de Jira Cloud:

Crear problemas de Jira
Editar problemas de Jira

Por ejemplo, un usuario podría ingresar "crea una historia de Jira llamada "Lanzar el proyecto Y" en el proyecto ABC" o "actualiza el título del ticket de Jira JCD-1 a "Lanzar el proyecto Y"" en tu app. El asistente solicita detalles adicionales si es necesario y, luego, le pide al usuario que confirme la solicitud de creación o edición.

El asistente puede leer y editar los siguientes campos de Jira a través de acciones:

Campo	Descripción
ID del problema	Obligatorio. ID del problema que se modificará, por ejemplo, KAN-123.
Título	Es el título del problema.
Tipo de problema	Es el tipo de problema.
Prioridad	Es la prioridad del problema.
Estado	Estado del problema.
Descripción	Es la descripción del problema en formato Markdown.
Componente	Es el componente del problema.
Usuario asignado	Es el usuario asignado al problema, por ejemplo, usuario@google.com.

Configura la autenticación y los permisos en Jira

Antes de activar las acciones de Jira, un administrador de Jira debe configurar credenciales de OAuth 2.0 dedicadas para las acciones en Jira. Esto es necesario para conectar tu integración de Jira y permitir permisos de lectura y escritura para las acciones.

Los clientes de autorización para las acciones de Jira son diferentes de los que se usan para transferir datos de Jira. Usan diferentes permisos y una configuración de URL de devolución de llamada diferente. Para obtener información sobre cómo configurar clientes de autorización para conectores de Jira Cloud para la transferencia de datos, consulta Conecta Jira Cloud.

En estas instrucciones, se explica cómo crear un ID de cliente y un secreto del cliente a través de la consola para desarrolladores de Atlassian, configurar los permisos de OAuth 2.0 necesarios y establecer permisos para los usuarios. Por último, recupera la URL y el ID de tu instancia, configura roles y autentícate para leer y escribir datos entre Jira Cloud y Google.

Crea un ID de cliente y un secreto del cliente

Accede a developer.atlassian.com.
Haz clic en el ícono de perfil que se encuentra en la esquina superior derecha y selecciona Consola para desarrolladores.
Haz clic en Crear y selecciona Integración de OAuth 2.0.
Ingresa un nombre para la app.
- Marca la casilla de verificación de los Términos y Condiciones.
- Haz clic en Crear.
Haz clic en Autorización.
En la tabla Tipo de autorización, selecciona Agregar para OAuth 2.0 (3LO).
En el campo URL de devolución de llamada, ingresa https://vertexaisearch.cloud.google.com/oauth-redirect y, luego, haz clic en Guardar cambios.
Haz clic en Permisos:
1. Ve a API de Jira, haz clic en Agregar y, luego, en Configurar.
2. Ve a la pestaña Permisos clásicos y haz clic en Editar permisos. Selecciona los siguientes permisos y, luego, guarda los cambios:
  - Permisos clásicos:
    - read:jira-work
    - read:jira-user
    - write:jira-work
  - Permisos detallados:
    - read:user:jira
Haz clic en Distribución, selecciona Editar y haz lo siguiente:
1. Primero, selecciona el botón de selección Compartir para habilitar la edición de otros campos.
2. Completa los campos restantes.
  1. En Proveedor, selecciona Google.
  2. En Política de privacidad, ingresa https://policies.google.com.
  3. En ¿Tu app almacena datos personales?, selecciona Yes.
  4. Selecciona la casilla de verificación Confirmo que implementé la API de informes de datos personales.
3. Haz clic en Guardar cambios.
Selecciona Configuración para copiar tu ID de cliente y tu secreto del cliente.

Recupera la URL y el ID de la instancia

Para obtener la URL de la instancia, sigue estos pasos:

Ve a atlassian.net y accede con tu cuenta de administrador.
Selecciona la app que quieras sincronizar. Por ejemplo, sincroniza la primera app.
Busca la URL de la instancia, que es el subdominio en la barra de direcciones.

Para obtener el ID de instancia, haz lo siguiente:

Abre una pestaña nueva, copia la URL de la instancia y agrega /_edge/tenant_info a la URL de la instancia. Por ejemplo, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
Navega al vínculo para encontrar el valor de cloudId. El cloudId es el ID de tu instancia.

Configura permisos y roles

Accede a atlassian.com con tu cuenta de administrador.
Haz clic en el ícono de menú en la parte superior izquierda o ve a admin.atlassian.com.
En la página Administrador, haz clic en Administrar usuarios y ve a la página Grupos.
Haz clic en Crear grupo. Ingresa un nombre para el grupo y créalo.
En la sección Group product access de la página del grupo nuevo, haz clic en Add products to group.
En Jira, selecciona Administrador de acceso de usuarios como el rol del producto.
En Administrador de Jira, selecciona Administrador de productos como el rol del producto y guarda los cambios.
En la página Grupos, haz clic en Agregar miembros del grupo y agrega los usuarios o las cuentas con los que se autenticará el conector.

Obtén un token de actualización

Si planeas configurar acciones de Jira con la consola de Google Cloud , no necesitas obtener un token de actualización.

Si necesitas usar la API para configurar tus acciones de Jira, se requiere un token de actualización. Para obtener un token de actualización, haz lo siguiente:

Ve a tu app en la consola de Google Cloud .
Selecciona Autorización.
Selecciona Configurar junto a OAuth 2.0 (3LO).
Para la URL de redireccionamiento, usa un marcador de posición, como https://example.com.
Para obtener un token de actualización en tu flujo de autorización inicial, agrega offline_access al parámetro de alcance de la URL de autorización. Por ejemplo: 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
Después de que se te autorice, se te redireccionará a la URL de redireccionamiento. En la barra de direcciones, deberías ver un parámetro de consulta llamado "code". Toma nota de su valor.
Usa herramientas como curl o Postman para enviar una solicitud POST a https://auth.atlassian.com/oauth/token con un objeto JSON que incluya las siguientes claves:
1. grant_type: authorization_code
2. client_id: Tu ID de cliente
3. client_secret: Tu secreto del cliente
4. code: El código que obtuviste en el paso 6
5. redirect_uri: Tu URI de redireccionamiento
Obtendrás refresh_token en la respuesta.

Para obtener más información sobre los tokens de actualización, consulta Implementación del flujo de tokens de actualización en la documentación de Atlassian.

Configura una acción de Jira

En esta sección, se describe cómo crear un conector de Jira para acciones y habilitar las acciones de Jira para tu asistente.

Antes de comenzar

Antes de configurar tus acciones, asegúrate de completar los siguientes pasos:

Tu proyecto debe agregarse a la lista de entidades permitidas para las acciones del asistente
Un administrador de Jira completó los pasos que se indican en Configura la autenticación y los permisos en Jira y te proporcionó la siguiente información:
- ID de cliente
- Secreto del cliente
- ID de instancia
- Es el token de actualización. Solo se requiere para crear acciones de Jira a través de la API en lugar de la consola de Google Cloud . Google recomienda crear acciones a través de la consola de Google Cloud .

Configura acciones de Jira en la consola de Google Cloud

Google recomienda crear acciones a través de la consola de Google Cloud .

Para agregar acciones a tu app con la consola, haz lo siguiente:

En la consola de Google Cloud , ve a la página de Gemini Enterprise.
Ve a tu app.
En el menú de navegación, haz clic en Acciones.
En Jira, haz clic en Conectar.
Selecciona una instancia de Jira.
Si se te solicita, ingresa la información de autorización para tu conector. Solo se requiere si la instancia aún no se configuró para una acción.
Selecciona las acciones que quieres habilitar.
Haz clic en Finalizar configuración. Tu acción se muestra en la página Acciones.

Crea y habilita acciones de Jira con la API

Google recomienda que crees acciones a través de la consola de Google Cloud . Si necesitas crear acciones con la API, haz lo siguiente:

Crea un conector de Jira y configúralo para la búsqueda:

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"
  }
}

Reemplaza lo siguiente:

PROJECT_NUMBER: Es el número de tu proyecto de Google Cloud .
COLLECTION_ID: ID de la colección.
COLLECTION_DISPLAY_NAME: Es un nombre visible para la colección.

Incluye la configuración de acciones en tu conector de 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}"
      }
    }
  }'

Habilita las acciones de Jira para tu asistente:

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"
          }
        ]
      }
    }
  }'