Integración de JIRA
Conecta tu asistente AI SmartTalk con Atlassian JIRA para habilitar capacidades inteligentes de gestión de proyectos y seguimiento de incidencias. Esta integración permite que tu asistente AI busque, cree, actualice incidencias, registre tiempo y gestione sprints directamente a través de interacciones en lenguaje natural.
Descripción general
La integración de JIRA permite que tu asistente AI:
- Buscar Incidencias: Encuentra incidencias utilizando consultas en lenguaje natural
- Ver Detalles de Incidencias: Obtén información completa sobre incidencias específicas
- Crear Incidencias: Genera nuevos tickets, tareas o errores automáticamente
- Actualizar Incidencias: Modifica el estado, prioridad, asignado y otros campos de la incidencia
- Seguimiento de Tiempo: Registra el tiempo de trabajo con comentarios y descripciones detalladas
- Gestión de Sprints: Lista tableros, sprints y gestiona la planificación de sprints
- Gestión de Proyectos: Accede a información del proyecto y datos de colaboración del equipo
Prerequisites
Before you begin, ensure you have:
- An active AI SmartTalk account with assistant configuration access
- A JIRA Cloud or Server instance with administrator privileges
- API access enabled in your JIRA instance
- User account credentials with appropriate project permissions
Configuración Paso a Paso
Paso 1: Acceder a la Integración de JIRA
- Inicia sesión en tu cuenta de AI SmartTalk
- Navega a Administración → Mis Asistentes → [El Nombre de Tu Asistente]
- Haz clic en Conectores en la barra lateral izquierda
- Localiza JIRA en la lista de conectores disponibles
- Haz clic en el mosaico de integración de JIRA
Paso 2: Configurar la Conexión de JIRA
- URL de JIRA: Ingresa la URL de tu instancia de JIRA (por ejemplo,
https://yourcompany.atlassian.net) - Nombre de Usuario/Correo Electrónico: Proporciona la dirección de correo electrónico de tu cuenta de JIRA
- Token de API: Genera e ingresa tu token de API de JIRA
- Ve a la configuración de tu cuenta de Atlassian
- Navega a Seguridad → Crear y gestionar tokens de API
- Genera un nuevo token para la integración de AI SmartTalk
- Haz clic en Configurar para establecer la conexión
Paso 3: Habilitar Capacidades de IA
Configura las capacidades de IA que deseas habilitar:
Gestión de Problemas (4/4)
- ✅ JIRA_SEARCH_ISSUES: Buscar y filtrar problemas utilizando lenguaje natural
- ✅ JIRA_GET_ISSUE: Recuperar información detallada sobre problemas específicos
- ✅ JIRA_CREATE_ISSUE: Crear nuevos problemas, tareas y errores
- ✅ JIRA_UPDATE_ISSUE: Modificar problemas existentes y sus propiedades
Seguimiento de Tiempo (1/1)
- ✅ JIRA_LOG_TIME: Registrar tiempo de trabajo con comentarios y descripciones
Gestión de Sprints (2/2)
- ✅ JIRA_LIST_BOARDS_AND_SPRINTS: Ver tableros disponibles y sprints activos
- ✅ JIRA_CREATE_SPRINT: Crear nuevos sprints y gestionar la planificación de sprints
Paso 4: Sincronización del Proyecto
- Haz clic en Sincronizar Proyectos para obtener tus proyectos de JIRA
- Selecciona los proyectos a los que deseas que tu asistente de IA tenga acceso
- Configura los permisos y niveles de acceso específicos del proyecto
- Espera a que se complete la sincronización inicial
Capacidades del Asistente de IA
Búsqueda y Gestión de Problemas
Tu asistente de IA puede manejar consultas en lenguaje natural como:
Ejemplos de Búsqueda:
- "Encuentra todos los problemas relacionados con las cookies"
- "Muéstrame los errores de alta prioridad asignados a John"
- "Lista todas las tareas en el sprint actual"
- "¿Cuáles son los problemas abiertos para el proyecto CCS?"
Detalles del Problema:
User: "Cuéntame sobre el problema CCS-11"
AI: Aquí están los detalles para CCS-11:
- Título: Preparar galletas de chocolate con contenido detallado
- Estado: Por Hacer
- Prioridad: Baja
- Asignado a: No asignado
- Descripción: [Descripción completa del problema]
Creación de Problemas
Crea problemas a través de comandos conversacionales:
Ejemplos de Creación:
- "Crea un informe de error para el problema de inicio de sesión"
- "Agrega una tarea para implementar la autenticación de usuarios"
- "Crea una historia para la nueva función del panel de control"
Registro de Tiempo
Registra el tiempo de trabajo con lenguaje natural:
Ejemplos de Seguimiento de Tiempo:
User: "@PO Bot confirmo que las galletas están en el horno para CCS-11, y registro 2 horas de termostato 200"
AI Response:
✅ Tiempo registrado exitosamente para CCS-11:
- Tiempo Gastado: 2 horas
- Comentario: Galletas en el horno a 200°C de termostato
- Fecha de Inicio: 14 de noviembre de 2025, 12:00 PM
Gestión de Sprints
Gestiona sprints y tableros de manera conversacional:
Ejemplos de Sprint:
- "¿Qué hay en nuestro sprint actual?"
- "Crea un nuevo sprint para la próxima semana"
- "Muéstrame todos los tableros disponibles"
- "Mueve CCS-11 al sprint activo"
Funciones de JIRA Soportadas
Tipos de Problemas
| Tipo | Soportado | Capacidades de IA |
|---|---|---|
| Épico | ✅ | Crear, actualizar, vincular problemas hijos |
| Historia | ✅ | Operaciones CRUD completas, estimación de puntos de historia |
| Tarea | ✅ | Gestión y seguimiento completo de tareas |
| Error | ✅ | Reporte de errores, asignación de severidad, seguimiento de resolución |
| Subtarea | ✅ | Creación de subtareas y vinculación con el problema principal |
Campos y Propiedades
| Campo | Leer | Escribir | Comprensión de IA |
|---|---|---|---|
| Resumen | ✅ | ✅ | Procesamiento de lenguaje natural |
| Descripción | ✅ | ✅ | Soporte para texto enriquecido y formato |
| Estado | ✅ | ✅ | Gestión del estado del flujo de trabajo |
| Prioridad | ✅ | ✅ | Asignación inteligente de prioridades |
| Asignado a | ✅ | ✅ | Reconocimiento de miembros del equipo |
| Reportador | ✅ | ✅ | Mapeo automático de usuarios |
| Etiquetas | ✅ | ✅ | Sugerencias inteligentes de etiquetas |
| Componentes | ✅ | ✅ | Organización basada en componentes |
| Versión de Corrección | ✅ | ✅ | Integración de planificación de lanzamientos |
Solución de problemas
Problemas Comunes
Problemas de Conexión
- Autenticación Fallida:
- Verifica el formato de la URL de JIRA (incluye https://)
- Revisa la validez del token de API
- Asegúrate de que la cuenta tenga los permisos adecuados
- Tiempo de Espera de Red:
- Verifica la accesibilidad de la instancia de JIRA
- Revisa la configuración del firewall
- Prueba la conexión desde los servidores de AI SmartTalk
Errores de Permiso
- Permisos Insuficientes:
- Revisa los permisos del proyecto de JIRA para tu cuenta
- Verifica los permisos de navegación del proyecto y de creación de incidencias
- Asegúrate de tener acceso de administrador para la configuración del proyecto
- Acceso al Proyecto Denegado:
- Asegúrate de que el usuario esté agregado a los proyectos objetivo
- Revisa la configuración de visibilidad del proyecto
- Valida la ortografía de la clave del proyecto
Problemas de Sincronización
- Proyectos No Cargando:
- Actualiza la sincronización del proyecto
- Verifica el rendimiento de la instancia de JIRA
- Revisa los límites de tasa de la API
- Actualizaciones de Incidencias Fallando:
- Verifica los permisos del flujo de trabajo de incidencias
- Revisa los requisitos de campo y las reglas de validación
- Asegúrate de que la incidencia esté en estado editable
Optimización del Rendimiento
Límites de Tasa de API
- Monitorear Uso: Rastrear llamadas a la API y límites de tasa
- Operaciones por Lotes: Agrupar múltiples operaciones cuando sea posible
- Estrategia de Caché: Implementar caché inteligente para datos accedidos frecuentemente
Manejo de Grandes Instancias
- Filtrado de Proyectos: Sincronizar solo proyectos relevantes
- Paginación de Problemas: Manejar conjuntos de resultados grandes de manera eficiente
- Sincronización Selectiva: Elegir tipos de problemas y estados específicos
Mejores Prácticas
Organización del Proyecto
- Nombres Claros: Utiliza nombres descriptivos para proyectos y problemas
- Etiquetado Consistente: Mantén una taxonomía de etiquetas consistente
- Limpieza Regular: Archiva proyectos y problemas completados
Casos de Uso y Ejemplos
Automatización de Reuniones Diarias
Miembro del Equipo: "Muéstrame en qué trabajé ayer y qué está planeado para hoy"
IA: "Ayer completaste CCS-9 (2 horas registradas) y CCS-10 (1.5 horas).
Hoy tienes CCS-11 y CCS-12 asignados en el sprint actual."
Planificación del Sprint
Scrum Master: "Crea un nuevo sprint que comience el lunes por 2 semanas"
IA: "✅ Se creó un nuevo sprint 'Sprint 24' comenzando el 18 de noviembre de 2025 por 2 semanas.
Listo para agregar problemas del backlog."
Reporte de Errores
Tester de QA: "Crea un error: El formulario de inicio de sesión no valida correctamente el formato del correo electrónico, alta prioridad"
IA: "✅ Se creó el error CCS-15: 'Problema de validación del correo electrónico en el formulario de inicio de sesión'
- Prioridad: Alta
- Asignado a: Equipo de Desarrollo
- Agregado al sprint actual para atención inmediata"
Seguimiento del Progreso
Product Owner: "¿Cómo estamos en el proyecto de preparación de galletas?"
AI: "Estado del proyecto de galletas (CCS):
- 5 problemas completados (CCS-1 a CCS-5)
- 3 en progreso (CCS-7, CCS-9, CCS-11)
- 2 por hacer (CCS-12, CCS-13)
- Finalización del sprint: 67% en camino"