Integraciones
26.1 25.2 25.1
26.1 25.2 25.1 Spanish English

skill-anjana-config

Esta página documenta la skill skill-anjana-config, que permite a un asistente de IA dar de alta configuración en Anjana Data Platform mediante la API de administración. Describe qué puede configurar, cómo trabaja, qué controles aplica, quién debe utilizarla y qué precauciones hay que tomar.

Las skills no forman parte del soporte de Anjana Data Platform

Anjana Data SL publica esta skill como una ayuda. No está incluida en el servicio de soporte de la plataforma y se ofrece tal como se publica, sin garantía. Su uso, y el resultado de las acciones que el asistente realice con ella, es responsabilidad del usuario y de su organización.

Para qué sirve

La skill skill-anjana-config permite que un asistente de IA dé de alta configuración en un entorno de Anjana Data Platform a partir de peticiones en lenguaje natural, como «crea el rol Data Steward Finanzas y asígnale permiso de creación sobre datasets». El asistente traduce la petición en las llamadas correspondientes a la API de administración de la plataforma, la misma que utiliza el portal de administración.

Su objetivo es agilizar tareas de configuración repetitivas o extensas, como cargar una taxonomía completa, crear un nuevo tipo de activo con sus menús, secciones y atributos, o completar las traducciones de un idioma. Incorpora además buenas prácticas de configuración, como reutilizar atributos existentes en lugar de duplicarlos o evitar validaciones incompatibles con el tipo de atributo. No sustituye al conocimiento del metamodelo ni al diseño previo de la configuración: el usuario debe saber qué quiere configurar y cómo debe quedar.

Qué puede configurar

  • Usuarios y autorización, alta de usuarios y asignación de roles y unidades organizativas, incluidos los roles cross.

  • Unidades organizativas, de primer y segundo nivel, y de tercer nivel en 26.1.

  • Roles y permisos, incluido el rol por defecto.

  • Metamodelo, atributos de metadatos, valores de referencia de selectores, taxonomías jerárquicas, dependencias entre atributos, tipos de entidad y de relación, menús, secciones, asignación de atributos a secciones y validaciones.

  • Linaje, capas de linaje y relaciones de agregación.

  • Internacionalización, idiomas y traducciones de la configuración. Al terminar cada sesión, la skill comprueba que todo lo creado tenga traducción en todos los idiomas registrados.

  • Notificaciones y filtros, notificaciones de workflow y filtros del buscador.

  • Workflows de validación, generación y validación del fichero BPMN 2.0 del workflow. La skill no lo despliega: el fichero se carga en la plataforma con el procedimiento habitual del entorno, antes de crear el tipo de entidad que lo utiliza.

Versiones compatibles

Versión de Anjana Data Platform

Estado

26.1

Compatible

25.2

Compatible

25.1

Compatible

Otras versiones

No validada. No debe utilizarse.

Muchas operaciones se comportan de forma distinta según la versión: el catálogo de permisos, la asignación de roles cross, la API de idiomas y traducciones o el permiso del asistente de creación. Indicar una versión distinta de la real puede producir una configuración que la plataforma acepta pero que no funciona.

Requisitos

  • Cliente de IA con ejecución de comandos, la skill ejecuta comandos en el equipo del usuario: curl para las llamadas a la API y Python para generar contraseñas cifradas, operaciones masivas y ficheros de workflow (alternativamente, htpasswd para las contraseñas).

  • Conectividad con el entorno, el equipo desde el que se ejecutan los comandos debe alcanzar la URL del entorno de Anjana Data Platform.

  • Usuario con permisos de administración, la API de administración exige un usuario con acceso a la configuración del entorno.

Cómo trabaja

El asistente utiliza la skill cuando la petición encaja con su descripción, por ejemplo «crea un rol» o «añade un filtro al buscador». También puede invocarse de forma explícita incluyendo en la petición el disparador [skill-anjana-config].

  1. Al iniciar la sesión, el asistente pide la versión de Anjana Data Platform, la URL del entorno y si se trata de un entorno productivo. Si el usuario no lo sabe, lo trata como productivo.

  2. Pide autenticación, mediante un token de sesión (JWT) o con usuario y contraseña. Avisa de que cualquier credencial escrita en la conversación queda en su historial y guarda el token en una carpeta temporal privada que elimina al terminar la sesión.

  3. Recoge los datos de la configuración y consulta en el entorno la información que necesita (roles, unidades organizativas, atributos existentes, posibles duplicados).

  4. Muestra un resumen de lo que va a crear y, cuando el usuario lo confirma, ejecuta la llamada e informa del resultado. Tras cada cambio vacía la caché de la plataforma para que sea visible en la interfaz.

Según el tipo de operación, la skill aplica tres niveles de confirmación:

Tipo de operación

Ejemplos

Confirmación

Creación ordinaria

Un atributo, una sección, una unidad organizativa, un rol sin privilegios especiales.

Se confirma el resumen y se ejecuta sin volver a preguntar.

Creación sensible

Permisos ADMIN_ACCESS, API_ADMIN, DELETE_ALL o CHANGE_OU; asignación de un rol cross; rol por defecto; operaciones masivas de más de 20 elementos.

El asistente explica el riesgo concreto y pide una confirmación expresa. En operaciones masivas en producción propone un primer lote pequeño de prueba.

Modificación o borrado

Las excepciones documentadas en el apartado siguiente.

El asistente muestra qué va a cambiar, explica los riesgos, recomienda guardar el estado previo y exige una confirmación explícita de esa operación concreta.

Qué no hace

  • No modifica ni elimina configuración existente como norma general, la skill está pensada para crear configuración nueva y rechaza las peticiones de modificación o borrado, salvo estas excepciones documentadas, que siempre requieren confirmación explícita:

    • Eliminar valores de referencia duplicados.

    • Eliminar validaciones aplicadas a un tipo de atributo incompatible.

    • Marcar una relación existente como relación de agregación para el linaje.

    • Activar o desactivar un idioma, cambiar el idioma por defecto y sobrescribir traducciones que ya tienen valor.

  • No deshace cambios, la API no permite recuperar lo borrado y lo que se recrea obtiene un identificador nuevo. Si una configuración se crea de forma incorrecta, hay que corregirla manualmente desde el portal de administración. Algunos atributos no pueden corregirse a posteriori.

  • No despliega workflows, solo genera y valida el fichero BPMN.

  • No crea activos del Catálogo, trabaja sobre la configuración de la plataforma, no sobre los activos gobernados. Para catalogar activos con un asistente de IA se utiliza el MCP.

Como ya se indica en la página IA, estas restricciones y confirmaciones son instrucciones para el modelo de lenguaje y no controles técnicos. El asistente actúa con todos los permisos del usuario autenticado, por lo que técnicamente podría ejecutar operaciones fuera de lo previsto. La supervisión de cada comando es la única garantía real.

Quién debe utilizarla

Uso exclusivo de profesionales certificados

La skill skill-anjana-config solo debe utilizarla un profesional certificado como administrador funcional y técnico de Anjana Data Platform, y siempre bajo su supervisión directa. Ese profesional es responsable de cada configuración que se cree durante la sesión, igual que si la hubiera creado manualmente desde el portal de administración.

Esta exigencia se debe a la naturaleza de los cambios que realiza la skill:

  • Los cambios no pasan por un flujo de aprobación, a diferencia de los activos creados con el MCP, que nacen en DRAFT, la configuración creada con la skill queda activa en el momento.

  • Afectan a todo el entorno, un rol, un permiso, un atributo, una notificación o un workflow mal configurados repercuten en todos los usuarios y en los procesos de gobierno.

  • Hay errores que la plataforma no rechaza, la API acepta combinaciones que después no tienen efecto en la interfaz o la dejan inconsistente (por ejemplo, permisos con códigos que no corresponden a la versión o valores de referencia duplicados). Detectarlos exige conocer la plataforma.

  • Requieren permisos de administración, el usuario con el que se conecta el asistente necesita privilegios elevados, por lo que un error tiene mayor alcance.

  • Solo un experto puede validar el resumen, el resumen previo muestra nombres técnicos, tipos de atributo, códigos de permiso, identificadores y condiciones de workflow. Valorar si son correctos exige conocer a fondo el metamodelo, el modelo de autorización y los workflows de la plataforma.

Recomendaciones de uso

Además de los guardarraíles generales de la página IA y de las recomendaciones generales de la página Skills, para esta skill se recomienda:

Antes de la sesión

  • Diseñar la configuración por escrito, definir de antemano los nombres, tipos, valores, permisos, relaciones y workflows que se van a crear, y utilizar el asistente para ejecutar ese diseño, no para improvisarlo.

  • Trabajar primero en un entorno no productivo, y reproducir en producción solo la configuración ya validada.

  • Comprobar la versión y la URL, confirmar la versión exacta del entorno y que la URL corresponde al entorno previsto, en especial cuando se trabaja con varios entornos.

  • Declarar con honestidad si el entorno es productivo, la skill refuerza sus avisos y propone lotes de prueba cuando lo es. Ante la duda, debe indicarse que sí.

  • Exportar o documentar la configuración existente, para poder comparar y revertir manualmente si fuera necesario.

Durante la sesión

  • Autenticarse con token de sesión, es preferible a escribir el usuario y la contraseña en la conversación, ya que todo lo que se escribe queda en el historial del cliente de IA y llega al proveedor del modelo. Si se usa contraseña, debe cambiarse al terminar.

  • Leer cada resumen con atención, ya que en las creaciones ordinarias la skill ejecuta la llamada en cuanto se confirma, sin volver a preguntar. Si algo no está claro, no confirmar y pedir aclaración.

  • No tomar las confirmaciones reforzadas como un trámite, la skill las reserva deliberadamente para los casos de mayor riesgo. Si se piden, es porque el error tendría un impacto amplio o difícil de corregir.

  • Mantener la aprobación manual de comandos, no activar en el cliente de IA modos que ejecuten comandos sin pedir permiso. Revisar cada comando antes de autorizarlo permite detectar operaciones que no corresponden a lo solicitado.

  • Avanzar por bloques pequeños, crear y verificar la configuración por partes (por ejemplo, primero el tipo de entidad, después sus menús, secciones y atributos) en lugar de encadenar muchas operaciones de una vez.

  • Revisar los errores en lugar de dejar que el asistente los resuelva solo, la skill no reintenta automáticamente, pero el asistente puede proponer alternativas. Ante un error, conviene comprobar si la operación llegó a aplicarse y entender la causa antes de autorizar otra.

  • Usar contraseñas temporales para usuarios nuevos, la contraseña de un usuario nuevo se escribe en la conversación. Debe ser provisional y cambiarse en el portal de administración.

Traducciones

  • Elegir conscientemente el método de traducción, antes de traducir, la skill pide elegir entre servicios externos de traducción automática (MyMemory y, para el euskera, Itzuli), otro servicio elegido por el usuario o traducciones hechas en la propia conversación o aportadas por el usuario. Los servicios externos no los opera Anjana Data SL y reciben los textos de la configuración (nombres y descripciones de atributos, valores, roles, unidades organizativas, notificaciones…); MyMemory recibe además el correo electrónico del usuario. Solo deben usarse si las políticas de la organización, y en su caso las de su cliente, lo permiten.

  • Revisión lingüística, las traducciones generadas, por cualquier vía, deben revisarse, en particular los términos de negocio propios de la organización.

  • Publicación y caché, las traducciones y la limpieza de caché afectan a todos los usuarios del entorno. En entornos productivos conviene realizar estas operaciones fuera de las horas de mayor uso.

Workflows

  • Revisar el diagrama antes de desplegar, la skill muestra el flujo en texto antes de generar el fichero. Hay que comprobar que las ramas cubren todos los casos sin solaparse: un activo que no cumple ninguna condición queda bloqueado en el workflow.

  • Probar el workflow en un entorno no productivo, antes de desplegarlo en producción, especialmente si utiliza condiciones que la skill marca como pendientes de probar.

Después de la sesión

  • Verificar el resultado en la plataforma, comprobar en el portal de administración y en el Portal de Datos que la configuración creada se comporta como se esperaba, con un usuario que tenga los roles afectados.

  • Registrar lo creado, conservar la relación de elementos creados y sus identificadores, que el asistente devuelve en cada respuesta, para facilitar revisiones y correcciones posteriores.

  • Cerrar la sesión explícitamente, indicar al asistente que se ha terminado para que elimine la carpeta temporal con el token, y comprobar que lo confirma.

  • Gestionar las copias de seguridad, si se guardó el estado previo de la configuración antes de una modificación, ese fichero contiene información de la organización: debe moverse a una ubicación segura o eliminarse.

Esta página está dirigida a administradores funcionales y técnicos certificados de Anjana Data Platform y a los equipos de seguridad, arquitectura y cumplimiento que evalúan el uso de skills de IA en sus entornos.

Last updated: