Jira para agentes de IA
Los agentes de voz y de chat con IA pueden leer y escribir en Jira mediante un conjunto fijo de herramientas. Las herramientas usan la misma conexión que las funciones de llamadas y siguen las mismas reglas: aislamiento de inquilinos, credenciales cifradas y una entrada de auditoría por cada llamada.
Las herramientas
| Herramienta | Qué hace | Permiso |
|---|---|---|
jira_search_issues | Busca incidencias con JQL, que se escapa antes de enviarse. | jira:read |
jira_get_issue | Lee una incidencia. | jira:read |
jira_check_sla | Lee el nivel de servicio de las solicitudes de un cliente. | jira:read |
atlassian_knowledge_search | Busca en la base de conocimiento de Confluence y Jira Service Management indexada para la empresa. | jira:read |
jira_create_issue | Crea una incidencia en el proyecto mapeado. | jira:write |
jira_add_comment | Añade un comentario a una incidencia. | jira:write |
Un agente tiene las herramientas solo si su lista de permitidas las incluye, y solo si la persona detrás del agente tiene el permiso correspondiente. Sin conexión, no se ofrece ninguna herramienta.
Las escrituras requieren confirmación
Una escritura no se ejecuta con la primera petición. La herramienta devuelve primero una vista previa. La escritura solo se ejecuta si los mismos argumentos se confirman en un turno posterior de la conversación, y cada confirmación funciona una sola vez. Una prueba en seco muestra lo que se escribiría sin escribir nada.
Lo que ve el agente
El texto de Jira, incluidas las descripciones de incidencias y los artículos de conocimiento, llega al modelo como datos, no como instrucciones. Los resultados se recortan a un tamaño fijo.
Base de conocimiento
La base de conocimiento contiene páginas de Confluence y artículos de Jira Service Management como texto plano. Los artículos que cambian se vuelven a indexar, y los que se eliminan en Atlassian se quitan del índice. Si no se puede contactar con Atlassian, se usa el último índice.
Auditoría
Cada llamada a una herramienta se escribe en el registro de auditoría con su resultado y, en las escrituras, la clave de la incidencia. El texto de la petición y el de la respuesta no se escriben allí.
Disponibilidad
Las herramientas están disponibles para el agente de voz. La lista permitida de cada agente y los ajustes de sincronización de conocimiento se gestionan en la página de ajustes de Jira (Jira para agentes de IA: casillas de herramientas por agente, claves de espacio de Confluence, ids de service desk y el interruptor de sincronización), o mediante la API.