Advanced

Workflow YAML definition

Workflows can be defined in YAML for advanced customization. Some examples are below.

1. Webhook Trigger

trigger:
  type: webhook
  events: ["issues.opened"]

2. Format Message Node

// Script node to format the message
const issue = triggers['github-issue'].payload;
return {
  text: `🚨 New Issue: ${issue.title}`,
  url: issue.html_url,
  author: issue.user.login
};

3. Post to Slack Node

# Slack integration node
channel: "#dev-alerts"
message: |
  {{nodes['format-message'].output.text}}
  
  Author: {{nodes['format-message'].output.author}}
  Link: {{nodes['format-message'].output.url}}

Test Your Workflow

Save the workflow
Run Test to verify functionality
Set up webhook in GitHub repository
Create test issue to confirm workflow

4. Conditional Logic

# Condition node
if: "nodes['format-message'].output.priority === 'high'"
then: ["urgent-notification"]
else: ["standard-notification"]

5. AI Processing

# AI node for issue analysis
model: "gemini-2.5-flash"
prompt: "Analyze and categorize this issue: {{trigger.payload.body}}"
output_schema:
  category: ["bug", "feature", "documentation", "question"]
  priority: ["low", "medium", "high", "critical"]

Step 4: Manage Variable

Variables

Non-sensitive configuration values with hierarchical scoping.

Create Variable:

Go to Variables in project/organization settings
Click Add Variable
Set key-value (e.g., ENVIRONMENT: production)
Reference in workflows: {{variables.ENVIRONMENT}}

Step 5: Monitor and Debug

Workflow Runs

Each execution creates a run record with:

Status: Success, failure, or running
Duration: Execution time
Node Results: Output from each node
Logs: Detailed execution information

Common Issues

Node Failures

Check logs for error messages
Validate all required inputs
Test integration connections

Authentication Errors

Verify integration permissions
Check API key validity

Advanced

On this page