Contrato de entrada e saída do Case Manager

Pesquise o formato de entrada e saída exato exigido pelo Gerenciador de Caso, incluindo os objetos caseManagerDecisions e caseCurrentExecutionState.

	Caso do Maestro	BPMN do Maestro	Fluxo do Maestro
O conteúdo aplica-se a	✅	❌	❌

Visão geral

O Gerenciador de Caso orquestra um caso usando regras, um agente ou ambos juntos. Independentemente do modo que você usar, a tarefa Gerenciador de Casos deve aceitar e retornar formas de dados específicas. Esta página documenta esse contrato. As tarefas do Case Manager falham silenciosamente (a execução relata como bem-sucedida, mas nenhuma tarefa é executada e nenhuma transição de estágios) quando a saída não corresponde exatamente a esse contrato.

Para obter uma visão geral conceitual da orquestração baseada em regras versus por agentes, consulte Gerenciador de casos no dicionário de componentes.

Contrato de entrada

Campo	Tipo	Preenchido por	Description
caseCurrentExecutionState	Object	Maestro (automático)	O estado atual do caso: quais estágios estão ativos, encerrados ou concluídos, quais tarefas estão em execução ou concluídas e valores variáveis do caso atual.
caseRulesDecisions	Object	Maestro (apenas configurações automáticas, baseadas em regras ou híbridas)	As decisões recomendadas do próprio mecanismo de regras, avaliadas antes da execução do agente. Mesma forma que caseManagerDecisions abaixo.

Observação:

Não mapeie um valor para nenhuma entrada por conta própria. Desde que a tarefa Case Manager declare uma entrada com um desses nomes exatos, o Maestro a preenche automaticamente em cada execução.

Quando usar o caseCurrentExecutionState

Faça referência caseCurrentExecutionState a quando a decisão do seu agente depende do histórico de casos — por exemplo, "enviar apenas a tarefa de acompanhamento se a tarefa de revisão já tiver sido concluída". Isso inclui:

• Quais estágios foram inseridos, retirados ou concluídos
• Quais tarefas estão em execução ou foram concluídas
• Valores de variáveis de caso, agrupados por estágio

Quando usar CaseRulesDe Decisions

Faça referência a caseRulesDecisions apenas se seu plano de caso combinar regras determinísticas com um agente. Nessa configuração, o mecanismo de regras é executado primeiro e produz suas próprias decisões recomendadas — o agente pode usar isso como ponto de partida e substituí-lo ou estendá-lo. Se seu plano de caso usar apenas o agente, você não precisará dessa entrada.

Contrato de saída

A tarefa Gerenciador de Caso deve retornar um único campo de saída chamado caseManagerDecisions. Esse campo controla cada decisão de orquestração para o caso.

caseManagerDecisions chave	Tipo	Description
tasksToRun	Matriz de objetos	Tarefas a serem disparadas em seguida. Cada objeto tem um campo: taskName.
tasksToCancel	Matriz de objetos	Tarefas em execução a serem canceladas. Cada objeto tem um campo: identifier, correspondendo ao identificador da tarefa de caseCurrentExecutionState.
stagesEntered	Matriz de objetos	Estágios a serem ativados. Cada objeto tem um campo: stageName.
stagesExited	Matriz de objetos	Estágios a serem encerrados cedo. Cada objeto tem um campo: stageName.
stagesCompleted	Matriz de objetos	Estágios para marcar como concluídos. Cada objeto tem um campo: stageName.
caseResolution	Object	Encerra o caso. Contém type, definido como completed ou exited.

Cada chave é opcional — inclua apenas as decisões relevantes para o evento atual. Por exemplo, uma decisão que inicia apenas uma tarefa não precisa incluir stagesEntered ou caseResolution.

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

Para encerrar um caso:

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

Erro comum

Uma matriz simples de nomes de tarefas — por exemplo ["Task 1", "Task 2"] — não é uma saída válida. O Gerenciador de caso silenciosamente não realiza nenhuma ação em vez de gerar um erro de validação. Sempre aninhe a matriz em caseManagerDecisions.tasksToRun, com cada entrada como um objeto contendo taskName.

Recursos relacionados

• Estabelecimento de contratos de E/S de tarefas e Write-back — etapa de solução de problemas se as tarefas ainda não forem disparadas após a correção do formato de saída.
• Gerenciador de caso — visão geral do gerenciador de caso baseado em regras versus agêntico.