De prompt a componente reutilizable en SAP: plantillas, versiones y orquestación

Una instrucción útil en el Prompt Editor es un buen comienzo. El problema aparece cuando varias aplicaciones la copian y nadie sabe qué versión clasificó una solicitud. Una solución empresarial necesita nombre, alcance, historial de cambios, pruebas y un modo controlado de llegar hasta el modelo.

Este artículo continúa el caso de clasificación de solicitudes de compras e incidencias. El objetivo no es construir una automatización que cree documentos SAP. Es convertir el clasificador en un componente reutilizable que devuelve JSON, pasa validaciones y crea una tarea de revisión cuando el caso lo requiere.

SAP AI Launchpad permite explorar, probar y gestionar prompts; Prompt Registry integra plantillas y configuraciones de orquestación en SAP AI Core. SAP Help describe Prompt Registry y SAP Learning muestra Prompt Management en AI Launchpad.

El recorrido práctico: del experimento a una versión desplegable

Una ruta prudente para el clasificador sigue estas seis etapas:

1. Experimentar. Prueba una instrucción con mensajes ficticios etiquetados y ajusta una variable por vez.
2. Definir el contrato. Fija campos, enumeraciones y errores. La aplicación rechaza JSON inválido y no ejecuta acciones SAP a partir de una frase generada.
3. Convertirla en plantilla. Extrae los datos variables como {{?request_text}}; conserva en la plantilla las instrucciones, los límites y el esquema de salida.
4. Guardar una versión y probarla. Registra el cambio y ejecuta el conjunto de casos antes de promoverla.
5. Referenciarla. La aplicación o la orquestación reutilizan esa plantilla, sin duplicarla.
6. Observar. Los casos que vayan a revisión pueden ampliar el conjunto de pruebas.

Así se puede saber qué componente se usó, reproducir una prueba y retirar una versión problemática.

La plantilla no es un campo de texto con otro nombre

Una plantilla parametriza el contenido que cambia. En la interfaz de SAP AI Launchpad, los marcadores se declaran con {{?nombre}}, pueden tener valores predeterminados para probarlos y se insertan en bloques de mensaje con rol de sistema, asistente o usuario. Templating en SAP AI Launchpad. La regla práctica es sencilla: instrucciones estables arriba; la solicitud no confiable, delimitada y abajo.

Para nuestro caso, el parámetro request_text transporta la solicitud. No son buenos candidatos a parámetros route ni la lista de reglas: quien llama a la plantilla no debería poder convertir una ruta de revisión en una aprobación. Tampoco lo son secretos, tokens o datos personales que no sean necesarios para clasificar.

Una ficha mínima de la plantilla podría ser esta:

Elemento	Ejemplo
Nombre	purchase_intake_classifier
Escenario	procurement_triage
Versión	1.0.0
Parámetro	request_text
Salida	objeto JSON con route, campos extraídos y review_reason
Consumidor	servicio de entrada de solicitudes, en modo de creación de tarea
Exclusión	no crea, cambia ni aprueba documentos SAP

Prompt Registry gestiona el ciclo de vida de plantillas y configuraciones de orquestación. Documentación. La API y el SDK oficial sirven para revisar especificaciones y promoverlas entre entornos. Referencia del SDK.

Versionar para poder explicar y volver atrás

Cambiar «usa needs_human_review ante dos solicitudes» por «elige la primera» modifica el comportamiento del proceso. Trátalo como una versión nueva, con un motivo y casos de prueba asociados. Una convención semántica simple ayuda a conversar entre negocio y desarrollo:

• 1.0.0: primera plantilla que cumple el contrato acordado.
• 1.0.1: corrige redacción sin alterar categorías, campos ni tratamiento de casos límite.
• 1.1.0: añade una categoría o un campo opcional compatible.
• 2.0.0: cambia el esquema, elimina una ruta o altera el significado de la salida; requiere adaptar consumidores.

Es una convención del equipo. SAP documenta que recuperar por identificador ofrece inmutabilidad; recuperar por nombre, escenario y versión puede devolver la iteración más reciente. Get a Prompt Template. En producción registra el identificador aprobado; en pruebas usa la referencia de desarrollo con una semántica acordada.

La versión reciente no es necesariamente mejor: debe superar los casos anteriores y los que justifican el cambio.

Qué aporta la orquestación en este caso

La orquestación no es una capa decorativa alrededor del modelo. SAP la describe como un servicio que se ejecuta en SAP AI Core bajo el escenario global orchestration y que proporciona acceso unificado a modelos mediante configuración, código y despliegue. Sus capacidades documentadas incluyen templating, filtrado de contenido, enmascaramiento de datos, grounding y traducción. Orchestration en SAP Help.

Para este clasificador, activa solo módulos que respondan a un riesgo o necesidad comprobable:

Componente	Aplicación posible en el clasificador	Pregunta antes de activarlo
Plantilla	Inserta request_text en instrucciones versionadas.	¿La aplicación mantiene un único contrato de parámetros?
Modelo LLM	Propone la ruta y extrae campos.	¿Se ha probado su salida contra el conjunto etiquetado?
Formato de respuesta	Pide un objeto estructurado que la aplicación puede analizar.	¿El validador rechaza salida incompleta o extra?
Enmascaramiento	Reduce información sensible antes de enviar texto al modelo cuando corresponda.	¿Qué datos son necesarios y qué política autoriza su tratamiento?
Filtrado de contenido	Controla contenido de entrada o salida según la política definida.	¿Qué respuesta tendrá el proceso si filtra un caso legítimo?
Grounding	Aporta instrucciones o catálogo autorizado cuando el caso necesita conocimiento externo.	¿La fuente está vigente, tiene permisos y responde a una pregunta concreta?
Traducción	Puede normalizar idiomas de entrada/salida si es necesario.	¿La traducción puede cambiar un identificador, una fecha o un término técnico?

El orden fino depende de configuración y versión. SAP describe a alto nivel plantilla, generación LLM y transformaciones opcionales de entrada/salida. Referencia V2. Revisa el payload de tu versión y prueba cada módulo con un caso observable.

Si un teléfono no es necesario para encaminar un caso, la primera decisión es no recibirlo. Si es inevitable, prueba el enmascaramiento y comprueba que la aplicación no necesite el valor después.

Interfaz y API: el mismo contrato, tareas distintas

La interfaz de AI Launchpad sirve para explorar modelos, editar prompts, probar valores y revisar versiones. Prompt Management muestra los detalles por versión; requiere roles como genai_manager o prompt_manager. Ver un prompt guardado.

La API y SDK sirven cuando una aplicación recupera una plantilla en ejecución o automatiza promociones. SAP muestra referencias por ID y por escenario, nombre y versión en su ejemplo V2. La aplicación mantiene autenticación, validación, autorización, persistencia y errores.

Registra plantilla, configuración y modelo usados, sin secretos ni texto completo si la política no lo autoriza.

Orquestación de IA no es un workflow de n8n

Los dos términos se parecen, pero resuelven problemas distintos. La orquestación del generative AI hub configura una petición de IA: plantilla, modelo y capacidades de tratamiento de contenido alrededor de la generación. Un workflow de n8n coordina pasos de automatización e integraciones: recibe un evento, transforma datos, llama servicios, espera una aprobación o escribe en otro sistema.

Se combinan cuando un workflow llama al endpoint de orquestación, valida el JSON y crea una tarea. Una respuesta de lenguaje natural no autoriza una API de creación en SAP ni sustituye reintentos, idempotencia, permisos o trazabilidad.

Un diseño de referencia deliberadamente pequeño

Este es un recorrido conceptual, sin afirmar que se haya desplegado en un tenant concreto:

Solicitud autorizada
        ↓
Normalización y minimización de datos en la aplicación
        ↓
Plantilla versionada + configuración de orquestación aprobada
        ↓
Modelo devuelve JSON de propuesta
        ↓
Validador determinista de esquema, tipos y rutas
        ↓
Tarea de revisión humana o cola de incidencia
        ↓
Acción SAP posterior, solo bajo las reglas y autorizaciones del proceso

La pieza de IA termina antes de la decisión de negocio. purchase_request crea una tarea; needs_human_review pide aclaración por el canal autorizado.

Pruebas antes de promover una versión

Para purchase_intake_classifier prepara casos etiquetados: solicitud completa, factura sin referencia, dos asuntos, contradicción, otro idioma, inyección y fuera de alcance. En cada uno define ruta, campos nulos y si crea revisión.

La validación automática comprueba esquema y formatos; la funcional decide si Compras habría elegido esa ruta. SAP ofrece evaluación y comparación, pero el conjunto de prueba pertenece al proceso. Learning Journey oficial.

Para configuraciones nuevas, empieza con Orchestration Service V2. En la documentación consultada el 1 de octubre de 2026, la API inicial de orquestación constaba como deprecada y con calendario propio de retirada; consulta la nota vigente de SAP AI Core antes de intervenir una solución existente. Una nota de retirada no sustituye la prueba del payload, las dependencias ni una migración validada en tu entorno.

Un prompt se vuelve reutilizable cuando alguien puede encontrarlo, saber qué contrato ofrece, recuperar una versión conocida y demostrar cómo responde ante casos difíciles. Ahí es donde plantillas, versiones y orquestación aportan valor: no por hacer que el modelo decida más, sino por hacer que el equipo controle mejor lo que el modelo puede proponer.