- Introducción
- Primeros pasos
- Modelado de procesos con BPMN
- Comprender el modelado del proceso
- Abrir el lienzo de modelado
- Modelar tu proceso
- Alinear y conectar elementos BPMN
- Autopilot para Maestro (vista previa)
- Repositorio de procesos
- Modelado de procesos con gestión de casos
- Definir claves de caso (de sistema o externo)
- Establecer contratos de entrada/salida y de escritura diferida de tareas
- Reglas de salida y terminación temprana de etapas
- Modelar las etapas principal y secundaria
- Iniciar un caso desde Data Fabric
- Implementar perfiles y permisos a nivel de etapa
- Establecer SLA y reglas de escalado automatizadas
- Configurar un bucle de reprocesamiento (reingreso)
- Gestionar instancias de casos en ejecución: pausar, migrar y reintentar
- Contrato de entrada y salida del gestor de casos
- Diccionario de componentes de la gestión de casos de Maestro
- Modelado de procesos con Flow
- Implementación del proceso
- Depuración
- Simular
- Publicar y actualizar procesos de agente
- Escenarios de implementación comunes
- Extracción y validación de documentos
- Operaciones de proceso
- Supervisión de procesos
- Optimización de procesos
- Información de referencia
Busca la forma de entrada y salida exacta requerida por el Gestor de casos, incluidos los objetos caseManagerDecisions y caseCurrentExecutionState.
| Caso de Maestro | Maestro BPMN | Flujo de Maestro | |
|---|---|---|---|
| El contenido se aplica a | ✅ | ❌ | ❌ |
Información general
El gestor de casos orquesta un caso utilizando reglas, un agente o ambos a la vez. Cualquiera que sea el modo que utilices, la tarea Gestor de casos debe aceptar y devolver formas de datos específicas. Esta página documenta ese contrato. Las tareas del Gestor de casos fallan silenciosamente (la ejecución se informa como correcta, pero no se ejecuta ninguna tarea ni transición de etapas) cuando la salida no coincide exactamente con este contrato.
Para obtener una descripción general conceptual de la orquestación basada en reglas frente a la orquestación agéntica, consulta Gestor de casos en el diccionario de componentes.
Contrato de entrada
| Campo | Tipo | Rellenado por | Descripción |
|---|---|---|---|
caseCurrentExecutionState | Objeto | Maestro (automático) | El estado actual del caso: qué etapas están activas, abandonadas o completadas, qué tareas se están ejecutando o completadas y valores de variables del caso actuales. |
caseRulesDecisions | Objeto | Maestro (solo configuraciones automáticas, basadas en reglas o híbridas) | Las propias decisiones recomendadas del motor de reglas, evaluadas antes de que se ejecute el agente. La misma forma que caseManagerDecisions, a continuación. |
No asigne un valor a ninguna de las entradas usted mismo. Mientras la tarea Gestor de casos declare una entrada con uno de estos nombres exactos, Maestro la rellenará automáticamente en cada ejecución.
Cuándo utilizar caseCurrentExecutionState
Referencia caseCurrentExecutionState cuando la decisión de tu agente dependa del historial del caso, por ejemplo, "enviar solo la tarea de seguimiento si la tarea de revisión ya se ha completado". Incluye:
- En qué etapas se ha entrado, salido o completado
- Qué tareas se están ejecutando o se han completado
- Valores de variables de caso, agrupados por etapa
Cuándo utilizar CaseRulesDecisions
Referencia caseRulesDecisions solo si tu plan de caso combina reglas deterministas con un agente. En esa configuración, el motor de reglas se ejecuta primero y produce sus propias decisiones recomendadas: el agente puede utilizarlo como punto de partida y anularlo o ampliarlo. Si tu plan de caso utiliza solo el agente, no necesitas esta entrada.
Contrato de salida
La tarea Gestor de casos debe devolver un único campo de salida llamado caseManagerDecisions. Este campo controla cada decisión de orquestación para el caso.
caseManagerDecisions clave | Tipo | Descripción |
|---|---|---|
tasksToRun | Matriz de objetos | Tareas que se desencadenarán a continuación. Cada objeto tiene un campo: taskName. |
tasksToCancel | Matriz de objetos | Tareas en ejecución para cancelar. Cada objeto tiene un campo: identifier, que coincide con el identificador de la tarea de caseCurrentExecutionState. |
stagesEntered | Matriz de objetos | Etapas que se van a activar. Cada objeto tiene un campo: stageName. |
stagesExited | Matriz de objetos | Etapas para terminar antes de tiempo. Cada objeto tiene un campo: stageName. |
stagesCompleted | Matriz de objetos | Etapas para marcar como completadas. Cada objeto tiene un campo: stageName. |
caseResolution | Objeto | Finaliza el caso. Contiene type, establecido en completed o exited. |
Cada clave es opcional: incluye solo las decisiones relevantes para el evento actual. Por ejemplo, una decisión que solo inicia una tarea no necesita incluir stagesEntered o caseResolution.
{
"caseManagerDecisions": {
"tasksToRun": [
{ "taskName": "Task 1" },
{ "taskName": "Task 2" }
],
"stagesCompleted": [
{ "stageName": "Intake" }
]
}
}
{
"caseManagerDecisions": {
"tasksToRun": [
{ "taskName": "Task 1" },
{ "taskName": "Task 2" }
],
"stagesCompleted": [
{ "stageName": "Intake" }
]
}
}
Para finalizar un caso:
{
"caseManagerDecisions": {
"caseResolution": {
"type": "completed"
}
}
}
{
"caseManagerDecisions": {
"caseResolution": {
"type": "completed"
}
}
}
Error común
Una matriz simple de nombres de tareas, por ejemplo, ["Task 1", "Task 2"], no es una salida válida. El Gestor de casos no realiza ninguna acción silenciosamente en lugar de generar un error de validación. Anida siempre la matriz bajo caseManagerDecisions.tasksToRun, con cada entrada como un objeto que contiene taskName.
Recursos relacionados
- Establecer contratos de E/S de tareas y reescritura : pasos de solución de problemas si las tareas aún no se desencadenan después de corregir la forma de salida.
- Gestor de casos : descripción general de Case Manager basado en reglas frente a agente.