Node Adornments are a powerful feature that allows you to “wrap” individual nodes with additional functionality, such as error handling and retry logic. They act as nodes themselves, treating the node they wrap as a single-node subworkflow.
Node Adornments simplify what would otherwise be complex workflow structures, making your workflows more readable and maintainable.
Vellum currently supports two types of Node Adornments:
The Retry Node Adornment repeatedly invokes a node until it either succeeds or reaches the maximum number of attempts. This is particularly useful for nodes that interact with external services that might experience temporary failures or rate limits.
Key features:
The Try Node Adornment attempts to invoke a node and continues with an Error output if it fails. This allows your workflow to gracefully handle errors and continue execution along an alternative path.
Key features:
Node Adornments are accessible in the Node sidepanel after clicking on a node in your workflow:
When monitoring workflow executions, Node Adornment invocations appear as if the targeted node was invoked as a single-node subworkflow:
This provides clear visibility into how many times a node was retried or whether it encountered errors during execution.
Apply a Retry Node Adornment to API Nodes that call external services which might experience temporary outages or rate limiting.
Use a Retry Node Adornment with Prompt Nodes to automatically retry when encountering non-deterministic LLM errors like timeouts or rate limits.
Apply a Try Node Adornment to provide fallback behavior when a node fails, such as using a cached response or a simpler alternative.