Saltar al contenido principal
Version: Next 🚀

Guía de Instalación

Deepseek for Jira se instala como una aplicación Forge en Jira Cloud. La instalación la realiza un administrador de Jira o un administrador del sitio.

Instalación en la versión 1.1.0

Esta versión no está publicada en Atlassian Marketplace. La instalación se realiza con el enlace de distribución de Forge que proporciona MB Group. Si no tienes el enlace, contacta con tu administrador de Jira o con el equipo de MB Group.

Prerrequisitos​

  • Un sitio de Jira Cloud.
  • Permisos de administrador de Jira o administrador del sitio para instalar aplicaciones.
  • Un workspace de Bitbucket Cloud disponible para el servicio. El consumer OAuth se configura durante el alta.
  • En sitios de desarrollo, la persona que usa el agente debe ser colaborador de la app. Si no lo es, Jira muestra un fallo genérico.

Pasos para la instalación​

  1. Inicia sesión en Jira Cloud con una cuenta de administrador.
  2. Abre el enlace de distribución de Forge que te haya proporcionado MB Group.
  3. Selecciona el sitio de Jira Cloud si se solicita.
  4. Revisa los permisos solicitados y confirma la instalación.
  5. Espera a que Atlassian complete el despliegue de la aplicación Forge.
  6. Verifica en Apps → Manage apps que Deepseek for Jira aparece como instalada.
  7. Comprueba que el agente aparece en el campo Responsable, en las menciones y en el panel de Rovo Chat.
Nombre del agente

El nombre visible del agente admite hasta 30 caracteres.

Permisos y acceso a Bitbucket​

La aplicación solicita estos scopes de Jira:

  • read:jira-work
  • write:jira-work (nuevo en 1.1.0): publicar la respuesta a una mención como comentario en el elemento de trabajo.
  • read:app-user-token
  • read:app-system-token
  • Lectura del Teamwork Graph (nuevos en 1.1.0): leer los enlaces del elemento de trabajo, como el repositorio, la rama, el commit, el pull request y las páginas enlazadas. La lectura se hace en nombre de la persona que asignó o mencionó al agente. No escribe en el grafo.
    • read:graph:issue:jira
    • read:graph:repository:external
    • read:graph:branch:external
    • read:graph:commit:external
    • read:graph:pull-request:external
    • read:graph:page:confluence
Teamwork Graph en vista previa

La lectura de enlaces usa el Teamwork Graph de Atlassian, que está en vista previa. Si no responde, el agente sigue con las demás fuentes y lo indica en el panel.

La aplicación no solicita scopes de Bitbucket. El acceso a Bitbucket se realiza con un consumer OAuth del workspace, nunca con un token de API personal. El consumer necesita estos scopes:

  • repository:write
  • pullrequest:write

La configuración del consumer y del proveedor del modelo se realiza fuera de Jira, durante el alta del servicio. En 1.1.0 no hay una página de administración dentro de Jira. Para cambiar estos valores, contacta con el equipo que administra el servicio.

Actualizar desde la versión 1.0.0​

La versión 1.1.0 añade el scope write:jira-work y los scopes de lectura del Teamwork Graph (read:graph:*). Las aplicaciones Forge se actualizan desde la infraestructura de Atlassian y, cuando una versión añade permisos, un administrador tiene que aceptarlos.

  1. Ve a Apps → Manage apps.
  2. Ubica Deepseek for Jira y acepta la actualización de permisos.

Hasta aceptar la actualización, el sitio sigue con la versión anterior: el agente no publica la respuesta a una mención como comentario ni lee los enlaces del elemento de trabajo.

Después de instalar​

  1. Confirma que el agente aparece en Responsable y en las menciones.
  2. Abre el panel de Rovo Chat y comprueba que responde.
  3. Revisa la Guía del Administrador para conocer el modelo, el consumer de Bitbucket, los límites, la red del entorno y los datos que salen al proveedor.
  4. Menciona al agente en un elemento de trabajo de prueba con una pregunta y comprueba que la respuesta queda como comentario.

Qué ocurre al desinstalar​

Al desinstalar la aplicación se borran las credenciales y las tareas de ese sitio. Una reinstalación crea un registro nuevo y no mezcla las tareas del ciclo anterior.

Qué escribe la app en el elemento de trabajo​

La app solo escribe un comentario cuando se menciona al agente: publica su respuesta final. Una asignación no publica nada en el elemento de trabajo; el resultado queda en el panel del agente. Los fallos tampoco se publican: quedan en el panel.