Escenarios de IA

Configura escenarios en /ai/scenarios. Ver requiere permiso de lectura; crear y editar requieren permiso de gestión. Sin el permiso correspondiente, la tarjeta queda no disponible o solo de lectura.

Contrato del escenario

Define key y nombre estables, descripción, categoría, enabled, useCase (text_improve, text_fix, json_analysis, custom), outputMode (text o json), systemPrompt, userPromptTemplate, tags y un responseSchema opcional. Elige connectionId o hereda la conexión predeterminada del módulo.

Los límites son maxPromptChars, maxOutputChars, maxContextChars, requestTimeoutMs y overflowMode (reject o truncate). No desactives la instrucción del sistema sin entender la consecuencia: disableSystemPrompt=true deja solo la plantilla de usuario.

Probar antes de activar

Ejecuta el escenario desde Playground con entrada sintética. Para JSON, verifica que el esquema sea un objeto válido, que los campos obligatorios sean necesarios y que el formulario receptor procese la respuesta. Prueba entrada larga, timeout, conexión ausente y carga parcial. Desactiva un escenario obsoleto (enabled=false) en vez de reutilizar su key.

Formulario y conflictos de edición

Para crear o editar se requieren key y nombre. Si se indica, responseSchema debe ser un objeto JSON; introduce las tags separadas por comas. Actualizar en la ventana del escenario vuelve a cargar los últimos datos guardados y avisa si el registro se eliminó o ya no se encuentra. Si tiene una conexión asociada, el formulario puede abrir su ficha; desactivar conserva el registro y establece enabled en false.

Seguridad

Los prompts no deben pedir contraseñas, tokens, datos personales innecesarios, importes contractuales ni archivos de otro cliente. Un escenario que cambia CRM, tareas, calendario o documentos siempre requiere revisión humana. La descripción debe indicar propietario, contexto permitido y criterio de finalización.

Si un escenario no carga, no se ejecuta o devuelve una respuesta vacía, muestra la causa y vuelve a revisar su configuración. En las demostraciones usa datos sintéticos, sin dinero ni secretos, y comprueba las etiquetas en el idioma de la interfaz.

Relacionado: Playground de IA, Conexiones de IA, Ajustes de IA y Assistant.