Esta página se ha traducido con Cloud Translation API.

Añadir 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 incidencias de Jira
Editar problemas de Jira

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

El asistente puede leer y editar los siguientes campos de Jira mediante acciones:

Campo	Descripción
ID del problema	Obligatorio. ID del problema que se va a modificar. Por ejemplo, KAN-123.
Título	Título del problema.
Tipo de problema	Tipo de problema.
Prioridad	Prioridad del problema.
Estado	Estado del problema.
Descripción	Descripción del problema en formato Markdown.
Componente	Componente del problema.
Usuario asignado	Persona asignada al problema, por ejemplo, usuario@google.com.

Configurar 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 específicas para las acciones de Jira. Es necesario para conectar tu integración de Jira y permitir el permiso de lectura y escritura para las acciones.

Los clientes de autorización de las acciones de Jira son diferentes de los que se usan para ingerir datos de Jira. Usan permisos y una URL de retrollamada diferentes. Para saber cómo configurar clientes de autorización para conectores de Jira Cloud para ingerir datos, consulta Conectar Jira Cloud.

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

Crear un ID de cliente y un secreto de cliente

Inicia sesión en developer.atlassian.com.
En la esquina superior derecha, haz clic en el icono de perfil y selecciona Consola de desarrollador.
Haga clic en Crear y seleccione Integración de OAuth 2.0.
Introduce un nombre para la aplicación.
- Marca la casilla de los términos y condiciones.
- Haz clic en Crear.
Haz clic en Autorización.
En la tabla Tipo de autorización, selecciona Añadir en OAuth 2.0 (3LO).
En el campo URL de retrollamada, introduce https://vertexaisearch.cloud.google.com/oauth-redirect y, a continuación, haz clic en Guardar cambios.
Haz clic en Permisos:
1. Ve a API de Jira, haz clic en Añadir y, a continuación, en Configurar.
2. Ve a la pestaña Scopes clásicos y haz clic en Editar scopes. Selecciona los siguientes ámbitos y guarda los cambios:
  - Permisos clásicos:
    - read:jira-work
    - read:jira-user
    - write:jira-work
  - Ámbitos granulares:
    - read:user:jira
Haga clic en Distribución, seleccione Editar y haga lo siguiente:
1. Selecciona primero el botón de radio Compartir para poder editar otros campos.
2. Rellena los campos restantes.
  1. En Proveedor, selecciona Google.
  2. En Política de Privacidad, introduce https://policies.google.com.
  3. En ¿Almacena su aplicación datos personales?, seleccione Yes.
  4. Marca la casilla Confirmo que he implementado 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 de cliente.

Obtener la URL y el ID de la instancia

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

Ve a atlassian.net e inicia sesión con tu cuenta de administrador.
Selecciona la aplicación que quieras sincronizar. Por ejemplo, sincroniza la primera aplicación.
Busca la URL de la instancia, que es el subdominio de la barra de direcciones.

Para obtener el ID de instancia, sigue estos pasos:

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

Configurar permisos y roles

Inicia sesión en atlassian.com con tu cuenta de administrador.
Haz clic en el icono de menú situado en la parte superior izquierda o ve a admin.atlassian.com.
En la página Administrar, haga clic en Gestionar usuarios y vaya a la página Grupos.
Haz clic en Crear grupo. Escribe el nombre del grupo y créalo.
En la sección Agrupar acceso a productos de la página de tu nuevo grupo, haz clic en Añadir productos al grupo.
En Jira, selecciona Administrador de acceso de usuario como rol de producto.
En Administrador de Jira, selecciona Administrador de producto como rol de producto y guarda los cambios.
En la página Grupos, haga clic en Añadir miembros al grupo y añada los usuarios o las cuentas con los que se autenticará el conector.

Obtener un token de actualización

Si tienes previsto configurar acciones de Jira mediante la consola Google Cloud , no es necesario que obtengas 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, sigue estos pasos:

Ve a tu aplicación en la Google Cloud consola.
Selecciona Autorización.
Selecciona Configurar junto a OAuth 2.0 (3LO).
En la URL de redirección, usa un marcador de posición, como https://example.com.
Para obtener un token de actualización en tu flujo de autorización inicial, añade offline_access al parámetro de ámbito 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
Una vez que se te haya autorizado, se te redirigirá a la URL de redirección. En la barra de direcciones, debería ver un parámetro de consulta llamado "code". Apunta 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 tenga las siguientes claves:
1. grant_type: authorization_code
2. client_id: tu ID de cliente
3. client_secret: tu secreto de cliente
4. code: el código que has obtenido en el paso 6
5. redirect_uri: tu URI de redirección
Obtendrás refresh_token en la respuesta.

Para obtener más información sobre los tokens de actualización, consulta el artículo Implementar el flujo de tokens de actualización de la documentación de Atlassian.

Configurar 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 en tu asistente.

Antes de empezar

Antes de configurar tus acciones, asegúrate de que has completado los siguientes pasos:

Tu proyecto debe añadirse a la lista de permitidos de las acciones del Asistente
Un administrador de Jira ha completado los pasos que se indican en el artículo Configurar la autenticación y los permisos en Jira y te ha proporcionado la siguiente información:
- ID de cliente
- Secreto de cliente
- ID de instancia
- Token de actualización. Solo es necesario para crear acciones de Jira a través de la API en lugar de a través de la Google Cloud consola. Google recomienda crear acciones a través de la consola de Google Cloud .

Configurar acciones de Jira en la Google Cloud consola

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

Para añadir acciones a tu aplicación mediante la consola, sigue estos pasos:

En la Google Cloud consola, ve a la página de Gemini Enterprise.
Ve a tu aplicación.
En el menú de navegación, haga clic en Acciones.
En Jira, haz clic en Conectar.
Selecciona una instancia de Jira.
Si se te solicita, introduce la información de autorización de tu conector. Solo es necesario si la instancia aún no se ha configurado para una acción.
Selecciona las acciones que quieras habilitar.
Haz clic en Finalizar configuración. La acción se muestra en la página Acciones.

Crear y habilitar acciones de Jira mediante la API

Google recomienda crear acciones a través de la Google Cloud consola. Si necesitas crear acciones con la API, sigue estos pasos:

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

Haz los cambios siguientes:

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

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