Contratos de salida de workflows y salidas específicas por rama
Los contratos de salida de workflows definen qué debe producir un workflow cuando finaliza. Todo workflow tiene o bien una única salida de respaldo o un conjunto de salidas específicas por rama. El motor aplica el contrato al final de una ejecución, y la ejecución falla si el workflow produce el tipo de salida incorrecto para la rama seleccionada.
Tipos de salida
El motor de workflows admite tres tipos de salida:
Tipo | Qué debe entregar el workflow |
|---|---|
answer | Una respuesta solo de chat. El workflow no debe crear ni cargar un documento. |
document | Un documento generado o cargado. El workflow debe producir un archivo de documento. |
table | Una tabla estructurada o un libro de trabajo. El workflow debe producir la salida tabular. |
Salida de respaldo vs. salidas específicas por rama
Cuando todas las ramas terminales de un workflow producen el mismo entregable, configure una sola salida de respaldo. Cuando distintas ramas producen entregables diferentes, use en su lugar salidas específicas por rama.
Salida de respaldo — un contrato de salida aplicado a todas las ramas terminales.
outputs — un contrato de salida por rama, de modo que el entregable coincida con la ruta de rama tomada.
Durante una ejecución, solo debe completarse una rama de salida. Si el workflow produce el tipo incorrecto para la rama seleccionada, la ejecución falla con un error explícito.
Aplicación del contrato
El motor comprueba la salida al final de cada ejecución. Entre los fallos comunes de contrato se incluyen:
Producir un documento cuando el contrato de la rama espera una respuesta.
Finalizar sin producir la salida de documento requerida.
Finalizar sin producir ninguna salida requerida.
Cuando no hay ningún contrato de salida configurado, la página de detalles del workflow muestra el mensaje: "No explicit output contract is set."
Cómo configurar salidas específicas por rama
En el generador de workflows, abra la sección de salida.
Agregue un bloque de salida para cada rama que necesite un entregable distinto.
Seleccione el tipo de salida para cada bloque: answer, document o table.
Vincule cada bloque de salida con su rama de destino.
Pruebe el workflow para verificar que cada rama produzca el tipo de salida correcto.
Cuando se establece una salida específica por rama, el motor solo comprueba el contrato de la rama que se seleccionó. Las ramas no seleccionadas se omiten y sus contratos de salida se ignoran.
Qué leer después
Descripción general de Workflows para crear y ejecutar workflows
Reanudar una ejecución de workflow en espera de entrada humana para reanudar ejecuciones pausadas desde el chat
Playbooks para aplicar estándares firmes de forma constante