Saltar al contenido principal
Version: 26.2

Crear con IA - Microservicios

El diseño de microservicios mediante Inteligencia Artificial (IA) permite su generación automática a partir de peticiones expresadas en lenguaje natural. Esta funcionalidad reduce la necesidad de conocimientos técnicos avanzados y agiliza el proceso de desarrollo al eliminar la necesidad de programación manual.

El código del microservicio se genera de acuerdo con la solicitud realizada, pero el proceso de creación se completa en la sección Diseñador, desde donde el microservicio puede ser habilitado para que pueda ser ejecutado a través del módulo Workspaces o desde el dispositivo del usuario final.

ai_designer

Crear un microservicio​

Los pasos para crear un microservicio a través de la IA son los siguientes:

  1. Acceder a Portal -> Microservicios -> Crear con IA.

  2. En el panel central, escribir la solicitud en lenguaje natural y con un máximo de 400 caracteres. En la parte inferior, Prueba con algo como esto ofrece ejemplos que pueden ayudar a crear una solicitud.

    try_this_prompts

  3. En el desplegable, elegir en qué ámbito se ejecutará: Microservicio de Sistema o Microservicio de Sesión.

    choose-system-session-ms

  4. Hacer clic en la flecha del cuadro naranja para continuar.

  5. En caso de que existan microservicios similares, se ofrecerán como alternativas disponibles. El usuario podrá hacer clic sobre cada uno de ellos para analizar su uso en relación con el objetivo deseado. Al hacerlo, se le redirigirá a la sección Marketplace.

    Si después de revisar las alternativas, el usuario considera que debe crear un nuevo microservicio, debe hacer clic en Crear con IA.

    exist-ms

  6. Unos segundos después, la IA diseñará el microservicio.

    iadesign-panel

    El botón Copiar código permite copiar el código generado en el portapapeles, facilitando su uso en pruebas si así se requiere.

    copy-script

    info

    Esta funcionalidad solo genera microservicios en PowerShell.

  7. Revisar el código del microservicio.

    expand-code

  8. El recuadro Mejora el microservicio, ubicado en la parte inferior derecha de la pantalla, permite al usuario añadir información para optimizar el microservicio. Con cada mejora se genera una nueva versión del código, que se puede ver en la columna Microservicios creados, ubicada en la parte superior.

  9. Hacer clic en Crear microservicio.

    info

    Si se vuelve a hacer clic en Crear microservicio sobre una petición de microservicio ya existente, se le solicitará confirmación al usuario para verificar si desea crear uno nuevo. En caso afirmativo, se generará otro microservicio cuyo nombre incluirá un número al final para diferenciarlo del original. En ningún caso se sobrescribirá el código o configuración de un microservicio ya creado.

    used_project

  10. A continuación, se dirigirá al usuario a la sección Diseñador para que pueda editar la configuración del microservicio, si así lo desea.

    ia-ms-edit

  11. Hacer clic en Guardar.

  12. El microservicio aparecerá en el listado de las secciones Diseñador y Marketplace.

info

Por defecto, los microservicios generados con IA se crean sin ninguna categoría y tienen la licencia Flexxible Microservices License. Esta configuración se puede modificar en Diseñador.

aviso

La IA también puede cometer errores. La ejecución de microservicios diseñados con este método es responsabilidad del usuario.

Redacción de solicitudes​

Mientras más detallada sea una solicitud, más preciso y útil será el microservicio generado. Para lograrlo, se recomienda que los mensajes cumplan con las siguientes pautas:

1. Conciso

  • Evitar frases vagas, redundantes o excesivamente largas.
  • Utilizar un lenguaje directo.
  • La claridad debe tener prioridad sobre la cantidad de palabras.

2. Específico

  • Explicar exactamente qué se desea obtener.
  • Incluir detalles como el formato de salida, las herramientas, objetivo, restricciones, etc.
  • Cuantos más detalles se proporcionen, mejor será el resultado.

3. Contexto

  • Indicar dónde se aplicará la acción.
  • Si falta contexto, la IA podría crear resultados genéricos.
  • Especificar el propósito del microservicio.

4. Verbos en modo imperativo

  • Se sugiere utilizar verbos que indiquen con claridad qué debe hacer la IA.
  • Ejemplos: crea, haz, analiza, genera, busca, compara, etc.

Recomendaciones​

Además de escribir solicitudes claras, es recomendable estructurarlas de forma que la IA comprenda con precisión qué debe hacer y cómo debe presentar el resultado. Para lograrlo, se sugiere tener en cuenta las siguientes recomendaciones:

  • Evitar la ambigüedad. Cada solicitud debe tener una sola interpretación posible.
  • Iterar y mejorar. Si el resultado no es óptimo, se puede ajustar la solicitud agregando más contexto.
  • Usar ejemplos cuando sea posible. Mostrar un modelo de salida orienta mejor el resultado.
  • Especificar la acción concreta. Describir de forma directa la tarea que la IA debe ejecutar.
  • Incluir ejemplos de referencia. Mostrar cómo debería ser la salida esperada, para guiar correctamente la interpretación de la IA.
  • Establecer restricciones o reglas. Indicar los límites, condiciones o requisitos que deben cumplirse durante la ejecución.
  • Definir criterios de éxito. Explicar qué condiciones debe cumplir el resultado para considerarse satisfactorio.

Ejemplos de cómo realizar una solicitud​

❌✅
¿Puedes hacer una copia de seguridad del escritorio y de los documentos?Haz una copia de seguridad del escritorio y la carpeta Documentos. Copia estos archivos en ZIP a \nas\backups<nombre de usuario>. Además, quiero mantener únicamente la última copia. Elimina el resto de los archivos en el momento en que la copia se haya completado correctamente.
Crear una tarea programada en los equipos que cierre la sesión cuando lleve cierto tiempo de inactividad.Crea una tarea programada en Windows 11. La tarea debe cerrar la sesión del usuario actual cuando se detecten 30 minutos de inactividad.

Mis solicitudes​

La columna Mis solicitudes, ubicada a la izquierda de la pantalla, muestra las peticiones de microservicios que el usuario ha hecho a la IA. Cada usuario solo puede ver las suyas, no se comparten con el resto de la organización.

my_request

Esta funcionalidad permite que el histórico de solicitudes sea visible en todo momento por el usuario que la creó para que siempre se pueda volver a ellas. También permite dar feedback sobre el resultado; para ello, el usuario puede hacer clic sobre los botones con formas de dedo pulgar, ubicados en el extremo superior derecho de la pantalla.

feedback_ms

Eliminar una solicitud​

  1. Ir a la columna Mis solicitudes, ubicada al lado izquierdo de la pantalla.

  2. Hacer clic sobre una solicitud del listado para entrar al detalle del código.

  3. Hacer clic en el icono de Eliminar, ubicado en el extremo superior derecho de la pantalla.

  4. Leer el mensaje de advertencia.

    delete_project

  5. Hacer clic en Cancelar o Eliminar, según sea el caso.

info

Eliminar una solicitud no implica borrar el microservicio creado a partir de esta.

Microservicios creados​

En el extremo derecho de la pantalla, la columna Microservicios creados presenta el listado de todos los microservicios creados a partir de una solicitud. Este panel permite identificar si una petición ha dado lugar a uno o varios microservicios, así como acceder directamente a cada uno de ellos para su revisión.

  • Cuando la IA diseña la primera versión de un microservicio, pero este no ha sido creado a través del botón Crear microservicio, la columna Microservicios creados muestra un mensaje como el de la siguiente imagen:

    ms_no_created

La flecha naranja ubicada en el recuadro de cada versión permite cargar el código de la versión anterior.

  • Cuando la IA diseña la primera versión y se hace clic en Crear microservicio, la columna Microservicios creados muestra el nombre del microservicio. Si se hace clic sobre él, se accede a su vista de detalle en la sección Diseñador.

    one_ms_created

  • Cuando la IA diseña y crea más de una versión de un microservicio, la columna Microservicios creados muestra la palabra Múltiple.

    multiple_ms_created

    Al hacer clic en Múltiple se abre una ventana modal con el listado de los microservicios creados a partir de esa solicitud. Al seleccionar uno de ellos se accede a su vista de detalle en la sección Diseñador.

    ms_related

Habilitar un microservicio​

El proceso para habilitar o deshabilitar un microservicio generado con IA es el mismo que el utilizado para crear microservicios de forma manual.

Pasos para habilitar un microservicio desde Diseñador:

  1. Acceder a Portal -> Microservicios -> Diseñador.

  2. Buscar el microservicio en el listado y hacer clic sobre él.

  3. Hacer clic en el botón Habilitar, ubicado en la parte superior derecha de la pantalla.

    enabled-ms

  4. El microservicio aparecerá marcado con un punto verde (signo de estar habilitado) en la sección Marketplace.

    enabled-marketplace

Pasos para habilitar un microservicio desde Marketplace:

  1. Acceder a Portal -> Microservicios -> Marketplace.
  2. Buscar el microservicio en el listado y hacer clic sobre él.
  3. Hacer clic en el botón Habilitar, ubicado en la parte superior derecha de la pantalla.
  4. El microservicio aparecerá marcado con un punto verde (signo de estar habilitado).
info

Los microservicios habilitados se ejecutan a demanda desde el módulo Workspaces: sección Workspaces (contexto Sistema) y sección Sesiones (contexto Sesión), según la configuración definida.

Habilitar un microservicio para el usuario final​

El proceso de habilitar un microservicio creado con IA para su ejecución por el usuario final es el mismo que el de los microservicios diseñados de forma manual.

Por favor, consulta la guía Habilitar microservicios para el usuario final.

info

Flexxible recomienda revisar las pestañas Privacidad y Destinatarios en la sección Diseñador antes de habilitar un microservicio para comprobar que tienen la configuración deseada.