WorkflowDefinition
Represents the full definition of a workflow, whether defined through the UI or in code.
Shape: object
| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
name |
yes | string |
Gets the workflow’s unique name. Serves as the key in the catalog and in API routes. | — |
displayName |
no | string |
Gets the display name shown in the UI. Name is used if left empty. |
— |
description |
no | string |
Gets the short description of what the workflow does. | — |
kind |
yes | WorkflowKind |
Gets the built-in pattern to use. | — |
agentNames |
no | array of string |
Gets the agent names to enter the graph. Order is meaningful for WorkflowKind.Sequential; for other kinds it defines the participant set. | — |
managerAgentName |
no | string |
Gets the manager agent’s name. Required for WorkflowKind.Magentic, unused in other patterns. | — |
nodes |
no | array of WorkflowNodeReference |
Gets the ordered node list for a WorkflowKind.Sequential workflow that mixes agent and function nodes. | — |
maxIterations |
no | integer (int32) |
Gets the maximum number of turns. The only guard against an infinite loop in the WorkflowKind.GroupChat, WorkflowKind.Handoff, and WorkflowKind.Magentic patterns. | pattern `^-?(?:0\ |
handoffInstructions |
no | string |
Gets the extra instruction that tells the model how to decide on a handoff. Used only for WorkflowKind.Handoff. | — |
requirePlanApproval |
no | boolean |
Gets whether the plan the manager agent builds must be approved by a human before execution starts. Applies only to WorkflowKind.Magentic. | — |
tenantId |
no | string |
Gets the tenant the definition belongs to. null for workflows defined in code. |
— |
version |
no | integer (int32) |
Gets the definition version. Increments by one on every save. | pattern `^-?(?:0\ |
updatedAt |
no | string (date-time) |
Gets the last modification time (UTC). | — |