@alvarobr/n8n-nodes-glpi-connect 1.1.0 → 1.2.0

package/README.md

@@ -38,6 +38,8 @@ Creado por **Álvaro Blanca Rodríguez**.
 ### Otros
 - **Usuario → Identificar por correo**: usuario de GLPI asociado a un correo.
 - **Base de conocimiento → Buscar preguntas frecuentes**: artículos FAQ públicos.
+- **Base de conocimiento → Índice de preguntas frecuentes**: títulos e ID de todas las FAQ públicas. Páselo al prompt del agente para que sepa qué artículos existen y no busque a ciegas.
+- **Base de conocimiento → Leer artículo**: contenido completo de una FAQ pública por su ID.
 - **Petición API → Petición personalizada**: cualquier ruta de `apirest.php` con la sesión ya gestionada. No comprueba permisos por usuario, así que **no debe conectarse a un agente de IA**.
 
 ## Seguridad

package/dist/nodes/GlpiConnect/GlpiConnect.node.js

@@ -112,7 +112,11 @@ const properties = [
         type: 'options',
         noDataExpression: true,
         displayOptions: show(['conocimiento']),
-        options: [{ name: 'Buscar preguntas frecuentes', value: 'buscar', action: 'Buscar en la base de conocimiento' }],
+        options: [
+            { name: 'Buscar preguntas frecuentes', value: 'buscar', action: 'Buscar en la base de conocimiento' },
+            { name: 'Índice de preguntas frecuentes', value: 'indice', action: 'Listar los títulos de la base de conocimiento', description: 'Títulos e ID de las preguntas frecuentes públicas, para que la IA sepa qué hay antes de consultar' },
+            { name: 'Leer artículo', value: 'leer', action: 'Leer un artículo de la base de conocimiento', description: 'Contenido completo de una pregunta frecuente por su ID' },
+        ],
         default: 'buscar',
     },
     {
@@ -350,7 +354,15 @@ const properties = [
         required: true,
         default: '',
         placeholder: 'vpn',
-        displayOptions: show(['conocimiento']),
+        displayOptions: show(['conocimiento'], ['buscar']),
+    },
+    {
+        displayName: 'ID del artículo',
+        name: 'articuloId',
+        type: 'number',
+        required: true,
+        default: 0,
+        displayOptions: show(['conocimiento'], ['leer']),
     },
     // --- Petición API ---------------------------------------------------
     {
@@ -462,6 +474,10 @@ async function runOperation(ctx, client, users, i) {
     const resource = ctx.getNodeParameter('resource', i);
     const operation = ctx.getNodeParameter('operation', i);
     if (resource === 'conocimiento') {
+        if (operation === 'indice')
+            return ops.faqIndex(client);
+        if (operation === 'leer')
+            return ops.readFaq(client, Number(ctx.getNodeParameter('articuloId', i)));
         return ops.searchFaq(client, ctx.getNodeParameter('busqueda', i));
     }
     if (resource === 'api') {

package/dist/nodes/GlpiConnect/operations.js

@@ -21,6 +21,8 @@ exports.linkAsset = linkAsset;
 exports.createTicket = createTicket;
 exports.myAssets = myAssets;
 exports.computerSheet = computerSheet;
+exports.faqIndex = faqIndex;
+exports.readFaq = readFaq;
 exports.searchFaq = searchFaq;
 exports.apiRequest = apiRequest;
 const GlpiClient_1 = require("./GlpiClient");
@@ -707,6 +709,37 @@ async function computerSheet(client, user, computerId, search) {
 // ----------------------------------------------------------------------
 // Base de conocimiento
 // ----------------------------------------------------------------------
+const FAQ_INDEX_LIMIT = 200;
+/** Solo las preguntas frecuentes se consideran públicas para el usuario. */
+function isPublicFaq(article) {
+    return !!article && typeof article === 'object' && (article.is_faq === undefined || Number(article.is_faq) === 1);
+}
+/** Títulos de todas las preguntas frecuentes, para que la IA sepa qué existe antes de consultar. */
+async function faqIndex(client) {
+    const response = await client.raw('GET', 'KnowbaseItem', { qs: { range: `0-${FAQ_INDEX_LIMIT - 1}`, sort: 'name', order: 'ASC' } });
+    if (response.statusCode >= 300 || !Array.isArray(response.body)) {
+        return { ok: false, error: 'No se ha podido consultar la base de conocimiento.' };
+    }
+    const articles = response.body.filter(isPublicFaq).map((a) => ({ id: Number(a.id), titulo: (0, utils_1.plainText)(a.name, 200) }));
+    return (0, utils_1.compact)({
+        ok: true,
+        total: articles.length,
+        articulos: articles,
+        aviso: response.body.length >= FAQ_INDEX_LIMIT ? `Solo se muestran los ${FAQ_INDEX_LIMIT} primeros artículos.` : undefined,
+    });
+}
+/** Contenido completo de una pregunta frecuente. */
+async function readFaq(client, articleId) {
+    const id = Number(articleId);
+    if (!Number.isSafeInteger(id) || id <= 0)
+        return { ok: false, error: 'Falta el ID del artículo. Use el índice de la base de conocimiento.' };
+    const response = await client.raw('GET', `KnowbaseItem/${id}`);
+    if (response.statusCode >= 300 || !response.body || Array.isArray(response.body) || !isPublicFaq(response.body)) {
+        return { ok: false, error: `No existe una pregunta frecuente pública con el ID ${id}.` };
+    }
+    const a = response.body;
+    return { ok: true, articulo: { id, titulo: (0, utils_1.plainText)(a.name, 200), contenido: (0, utils_1.plainText)(a.answer, 8000), enlace: `${client.front}/helpdesk.faq.php?id=${id}` } };
+}
 async function searchFaq(client, text) {
     const term = String(text ?? '').trim();
     if (term.length < 2)
@@ -720,10 +753,9 @@ async function searchFaq(client, text) {
         if (r.statusCode >= 300 || !Array.isArray(r.body))
             continue;
         for (const a of r.body) {
-            if (!a || typeof a !== 'object' || seen.has(a.id))
+            if (!a || seen.has(a.id))
                 continue;
-            // Solo preguntas frecuentes (públicas)
-            if (a.is_faq !== undefined && Number(a.is_faq) !== 1)
+            if (!isPublicFaq(a))
                 continue;
             seen.add(a.id);
             articles.push({ id: a.id, titulo: (0, utils_1.plainText)(a.name, 200), contenido: (0, utils_1.plainText)(a.answer, 1500), enlace: `${client.front}/helpdesk.faq.php?id=${a.id}` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alvarobr/n8n-nodes-glpi-connect",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Nodo de n8n para GLPI: autoservicio IT seguro para flujos y agentes de IA. Tickets, inventario, software y base de conocimiento con sesión automática, permisos por usuario y confirmación de cambios.",
   "keywords": [
     "n8n-community-node-package",