Saltar al contenido principal

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​

HerramientaQué hacePermiso
jira_search_issuesBusca incidencias con JQL, que se escapa antes de enviarse.jira:read
jira_get_issueLee una incidencia.jira:read
jira_check_slaLee el nivel de servicio de las solicitudes de un cliente.jira:read
atlassian_knowledge_searchBusca en la base de conocimiento de Confluence y Jira Service Management indexada para la empresa.jira:read
jira_create_issueCrea una incidencia en el proyecto mapeado.jira:write
jira_add_commentAñ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.