Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt

Use this file to discover all available pages before exploring further.

This page provides a complete reference for all node types and condition options available in workflows.

Node Types

Start Node

The Start node is the entry point for the workflow. Duckie creates it automatically when you create a workflow. Outputs:
  • Next — Begins workflow execution

Tool Node

Executes a tool or another reusable resource. Configuration:
FieldDescription
NameDisplay name for this node
ToolThe Duckie tool, app tool, custom tool, MCP tool, runbook, or workflow to execute
InputsValues mapped to the selected tool’s parameters
OutputsValues produced by the tool for later nodes
Outputs:
  • Success — Tool executed successfully
  • Failure — Tool execution failed
Example uses:
  • Search company docs
  • Send a response with the Responder tool
  • Call a custom API
  • Call a tool from an MCP server
  • Run a runbook or another workflow
  • Create a Jira ticket or update a Zendesk ticket

Decision Node

Routes the workflow across branches. Branches are evaluated from top to bottom. The first matching branch is taken; if no branch matches, the Else path is taken. Configuration:
FieldDescription
NameDisplay name for this node
BranchesOrdered rule or AI conditions
ElseFallback path when no branch matches
Outputs:
  • One output per branch
  • Else fallback output

End Node

Marks a workflow path as complete.

Condition Reference

Decision branches can use a Rule condition or an AI condition.

Rule Conditions

Rule conditions compare a selected value against another value.
FieldDescription
CheckThe value to evaluate
ConditionThe comparison to apply
ValueThe value to compare against, when the comparison needs one
Available comparisons:
ComparisonUse for
equalsExact matches
does not equalExcluding a value
is greater thanNumeric comparisons
is less thanNumeric comparisons
is at leastNumeric lower bounds
is at mostNumeric upper bounds
containsText or list membership
does not containExcluding text or list membership
starts withPrefix checks
ends withSuffix checks
is emptyMissing or null values
is not emptyPresent values
is trueBoolean true
is falseBoolean false

AI Conditions

AI conditions use a prompt and selected inputs to make a judgment.
FieldDescription
ModeBasic or Advanced reasoning
PromptThe decision the AI should make
InputsContext the AI should evaluate
Example prompt:
Determine whether the customer is satisfied with the resolution.
Consider their latest message, conversation history, and whether the original issue appears resolved.

Input Mapping

Use input mapping to pass values into tool parameters and conditions.
SourceUse for
Manual ValueFixed strings, numbers, booleans, or JSON
Ticket DataMetadata from the conversation or source ticket
Previous NodeOutputs from earlier workflow nodes
Saved ValueValues saved for reuse in the workflow
Generate with AIValues generated from selected context
Multiple ItemsLists of values for parameters that accept arrays

Best Practices

Node Naming

  • Use descriptive names: “Check order eligibility” not “Decision 1”
  • Include the action: “Lookup order in database”
  • Be consistent across workflows

Error Handling

  • Always connect Failure outputs
  • Provide fallback paths for errors
  • Consider retry logic for transient failures

Testing

  • Test each path through the workflow
  • Verify variable mapping works correctly
  • Check edge cases and error conditions

Next Steps

Create Workflows

Build workflows using these nodes

Tools Reference

See available tools for Tool nodes