Contrat d’entrée et de sortie du gestionnaire de cas

Recherchez la forme d'entrée et de sortie exacte requise par le gestionnaire de cas, y compris les objets DécisionsGestionnaireCas et ÉtatExécutionActuel.

	Cas Maestro	BPMN Maestro	Flux Maestro
Le contenu s'applique à	✅	❌	❌

Vue d'ensemble (Overview)

Le gestionnaire de cas orchestre un cas à l'aide de règles, d'un agent ou des deux ensemble. Quel que soit le mode que vous utilisez, la tâche Case Manager doit accepter et renvoyer des formes de données spécifiques. Cette page documente ce contrat. Les tâches du gestionnaire de cas échouent silencieusement (l'exécution est signalée comme réussie, mais aucune tâche ne s'exécute et aucune transition d'étape) lorsque la sortie ne correspond pas exactement à ce contrat.

Pour obtenir un aperçu conceptuel basé sur des règles par rapport à l'orchestration agentique, consultez le gestionnaire de cas dans le dictionnaire de composants.

Contrat d’entrée

Champ	Saisie de texte	Renseigné par	Description
caseCurrentExecutionState	Objet	Maestro (automatique)	L’état actuel du cas: les étapes actives, quittées ou terminées, les tâches en cours d’exécution ou terminées et les valeurs actuelles des variables du cas.
caseRulesDecisions	Objet	Maestro (configurations automatiques, basées sur des règles ou hybrides uniquement)	Les décisions recommandées par le moteur de règles, évaluées avant l'exécution de l'agent. Même forme que caseManagerDecisions, ci-dessous.

Remarque :

Ne mappez pas une valeur à vous-même. Tant que la tâche Gestionnaire de cas déclare une entrée avec l'un de ces noms exacts, Maestro la remplit automatiquement à chaque exécution.

Quand utiliser caseCurrentExecutionState

Référencez caseCurrentExecutionState lorsque la décision de votre agent dépend de l’historique des incidents, par exemple: "envoiez uniquement la tâche de suivi si la tâche de révision est déjà terminée". Il comprend les éléments suivants:

• Quelles étapes ont été saisies, quittées ou terminées
• Quelles tâches sont en cours d'exécution ou terminées
• Valeurs des variables de cas, regroupées par étape

Quand utiliser caseRulesDecisions

Référencez caseRulesDecisions uniquement si votre plan de scénario combine des règles déterministes avec un agent. Dans cette configuration, le moteur de règles s'exécute en premier et produit ses propres décisions recommandées — l'agent peut utiliser cela comme point de départ et le remplacer ou l'étendre. Si votre plan de cas utilise l’agent seul, vous n’avez pas besoin de cette entrée.

Contrat de sortie

La tâche Gestionnaire de cas doit renvoyer un champ de sortie unique nommé caseManagerDecisions. Ce champ contrôle chaque décision d'orchestration du cas.

caseManagerDecisions touche	Saisie de texte	Description
tasksToRun	Tableau d’objets	Tâches à déclencher ensuite. Chaque objet a un champ: taskName.
tasksToCancel	Tableau d’objets	Exécution des tâches à annuler. Chaque objet a un champ: identifier, correspondant à l’identifiant de la tâche (caseCurrentExecutionState).
stagesEntered	Tableau d’objets	Étapes à activer. Chaque objet a un champ: stageName.
stagesExited	Tableau d’objets	Étapes à terminer tôt. Chaque objet a un champ: stageName.
stagesCompleted	Tableau d’objets	Étapes à marquer comme terminées. Chaque objet a un champ: stageName.
caseResolution	Objet	Se termine le cas. Contient type, défini sur completed ou exited.

Chaque clé est facultative: inclure uniquement les décisions pertinentes par rapport à l'événement actuel. Par exemple, une décision qui démarre uniquement une tâche n'a pas besoin d'inclure stagesEntered ou caseResolution.

{
  "caseManagerDecisions": {
    "tasksToRun": [
      { "taskName": "Task 1" },
      { "taskName": "Task 2" }
    ],
    "stagesCompleted": [
      { "stageName": "Intake" }
    ]
  }
}

Pour mettre fin à un cas:

{
  "caseManagerDecisions": {
    "caseResolution": {
      "type": "completed"
    }
  }
}

Erreur courante

Un tableau simple de noms de tâches, par exemple ["Task 1", "Task 2"], n'est pas une sortie valide. Le gestionnaire de cas n'effectue aucune action en mode silencieux au lieu de générer une erreur de validation. Imbriquez toujours le tableau sous caseManagerDecisions.tasksToRun, chaque entrée étant un objet contenant taskName.

Ressources connexes

• Mise en place de contrats E/S et de réécriture — étapes de dépannage si les tâches ne se déclenchent toujours pas après avoir corrigé la forme de la sortie.
• Gestionnaire de cas - Aperçu du gestionnaire de cas basé sur des règles par rapport au gestionnaire de cas agentique.