Integración de JIRA
Conecta tu asistente AI SmartTalk con Atlassian JIRA para habilitar capacidades inteligentes de gestión de proyectos y seguimiento de problemas. Esta integración permite que tu asistente AI busque, cree, actualice problemas, 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 Problemas: Encuentra problemas utilizando consultas en lenguaje natural
- Ver Detalles del Problema: Obtén información completa sobre problemas específicos
- Crear Problemas: Genera nuevos tickets, tareas o errores automáticamente
- Actualizar Problemas: Modifica el estado del problema, prioridad, asignado y otros campos
- 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
Requisitos previos
Antes de comenzar, asegúrate de tener:
- Una cuenta activa de AI SmartTalk con acceso a la configuración del asistente
- Una instancia de JIRA Cloud o Server con privilegios de administrador
- Acceso a la API habilitado en tu instancia de JIRA
- Credenciales de cuenta de usuario con permisos de proyecto apropiados
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 la tarjeta 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 Incidencias (4/4)
- ✅ JIRA_SEARCH_ISSUES: Buscar y filtrar incidencias utilizando lenguaje natural
- ✅ JIRA_GET_ISSUE: Recuperar información detallada sobre incidencias específicas
- ✅ JIRA_CREATE_ISSUE: Crear nuevas incidencias, tareas y errores
- ✅ JIRA_UPDATE_ISSUE: Modificar incidencias 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 de Proyectos
- Haz clic en Sincronizar Proyectos para obtener tus proyectos de JIRA
- Selecciona los proyectos a los que deseas que tu asistente de IA acceda
- Configura permisos y niveles de acceso específicos para los proyectos
- Espera a que se complete la sincronización inicial
Capacidades del Asistente de IA
Búsqueda y Gestión de Problemas
Su 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
Cree 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
Registre 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 a 200 de termostato"
AI Response:
✅ Tiempo registrado con éxito 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
Gestione 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 | ✅ | Informe de errores, asignación de severidad, seguimiento de resolución |
| Subtarea | ✅ | Creación de subtareas y vinculación con el problema padre |
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 |
| Reportero | ✅ | ✅ | 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:
- Verifique el formato de la URL de JIRA (incluya https://)
- Verifique la validez del token de API
- Asegúrese de que la cuenta tenga los permisos adecuados
- Tiempo de Espera de Red:
- Verifique la accesibilidad de la instancia de JIRA
- Revise la configuración del firewall
- Pruebe la conexión desde los servidores de AI SmartTalk
Errores de Permiso
- Permisos Insuficientes:
- Revise los permisos del proyecto de JIRA para su cuenta
- Verifique los permisos de navegación del proyecto y de creación de problemas
- Verifique el acceso de administrador para la configuración del proyecto
- Acceso al Proyecto Denegado:
- Asegúrese de que el usuario esté agregado a los proyectos objetivo
- Revise la configuración de visibilidad del proyecto
- Valide la ortografía de la clave del proyecto
Problemas de Sincronización
- Proyectos No Cargando:
- Actualice la sincronización del proyecto
- Verifique el rendimiento de la instancia de JIRA
- Verifique los límites de tasa de la API
- Actualizaciones de Problemas Fallando:
- Verifique los permisos del flujo de trabajo del problema
- Verifique los requisitos de campo y las reglas de validación
- Asegúrese de que el problema 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 de acceso frecuente
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: Usar nombres descriptivos para proyectos y problemas
- Etiquetado Consistente: Mantener una taxonomía de etiquetas consistente
- Limpieza Regular: Archivar proyectos y problemas completados
Casos de Uso y Ejemplos
Automatización de la Reunión Diaria
Miembro del Equipo: "Muéstrame en qué trabajé ayer y qué está planeado para hoy"
AI: "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 comenzando el lunes por 2 semanas"
AI: "✅ Creado 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"
AI: "✅ Creado error CCS-15: 'Problema de validación de correo electrónico del formulario de inicio de sesión'
- Prioridad: Alta
- Asignado a: Equipo de Desarrollo
- Agregado al sprint actual para atención inmediata"
Seguimiento del Progreso
Propietario del Producto: "¿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"