Skip to main content
1

Create an account

Navigate to your Agility instance and sign up for a new account using your email address.Once signed in, you’ll be directed to the workflow builder interface.
2

Access the workflow builder

Click Try the Workflow Builder from the homepage or navigate directly to /workflow.You’ll see:
  • Canvas - The main workspace where you build workflows
  • Agent Panel - Left sidebar with available agents
  • Configuration Panel - Right sidebar (appears when you select an agent)
3

Create your first workflow

You can create workflows in two ways:

​
Method 1: Manual Creation

  1. Drag an agent from the left panel onto the canvas
  2. Click the agent to open its configuration panel
  3. Configure the agent with required credentials and settings
  4. Click Save Configuration

​
Method 2: AI-Powered Generation

  1. Look for the AI workflow generation input
  2. Describe your workflow in plain English (e.g., “Read my Gmail, summarize with AI, send to Discord”)
  3. Click Generate Workflow
  4. The AI will create a complete workflow with connected agents
AI generation is the fastest way to get started - describe your automation goal and let Agility build it for you.
4

Configure your agents

For each agent in your workflow, you’ll need to provide configuration:Text Generator:
  • OpenAI or Anthropic API key
  • Model selection (gpt-4, gpt-3.5-turbo, claude-3-5-sonnet)
  • Prompt text (supports placeholders like \{\{input.text\}\})
Gmail Reader:
  • Gmail OAuth credentials
  • Filter by sender email
  • Maximum results to fetch
Gmail Sender:
  • Gmail OAuth credentials
  • Recipient email
  • Subject and body (supports placeholders)
Discord Messenger:
  • Discord webhook URL
  • Message content (supports placeholders)
  • Optional: Custom username and avatar
GitHub Reader:
  • GitHub Personal Access Token
  • Repository name (owner/repo format)
  • Branch to monitor
Credentials are stored securely in your Supabase database with encryption.
5

Connect your agents

Create data flows between agents:
  1. Click and drag from one agent’s output port to another agent’s input port
  2. A connection line appears showing the data flow
  3. Connected agents can access previous agent outputs using placeholders
Example: Connect Gmail Reader → Text Generator:
  • In Text Generator prompt, use \{\{input.emailBody\}\} to access the email content
  • Use \{\{input.emailSubject\}\} to access the subject line
Hover over an agent to see its available output fields and placeholder syntax.
6

Test your workflow

Before running the full workflow, test individual agents:
  1. Click an agent to select it
  2. Click Test Agent in the configuration panel
  3. Review the test results
  4. Fix any errors in configuration
Once all agents pass testing, run the complete workflow:
  1. Click Test Workflow in the toolbar
  2. Select the starting agent
  3. Watch the execution progress
  4. Review results for each agent
Make sure all agents are configured and saved before running the workflow.
7

Save and deploy

Once your workflow is working:
  1. Click Save Workflow in the toolbar
  2. Give your workflow a descriptive name
  3. Your workflow is automatically saved to your account
For automated execution, you can set up triggers:
  • GitHub Reader: Configure webhooks for automatic execution on push events
  • Gmail Reader: Can be set up as a scheduled workflow (polling)
  • API Triggers: Call the workflow via API endpoint
See Testing Workflows for advanced testing techniques.

​
Next steps

Core Concepts

Understand workflows, agents, and connections in depth

Agent Reference

Explore all available agents and their capabilities

Workflow Patterns

Learn common workflow patterns and best practices

API Reference

Integrate workflows with your applications via API

​
Example workflow

Here’s a complete example workflow that monitors GitHub commits and posts summaries to Discord: 
// Workflow: GitHub Commit Notifier
// 
// 1. GitHub Reader Agent
//    - Repository: "username/my-repo"
//    - Branch: "main"
//    - Triggers on: Push events
//
// 2. Text Generator Agent  
//    - Model: "gpt-4"
//    - Prompt: "Summarize these commits concisely:\n\{\{input.commits\}\}"
//
// 3. Discord Messenger Agent
//    - Webhook URL: "https://discord.com/api/webhooks/..."
//    - Message: "📦 New commits to my-repo:\n\{\{input.text\}\}"
This workflow automatically:
  1. Detects new commits via GitHub webhook
  2. Generates an AI summary of the changes
  3. Posts the summary to your Discord channel
Copy this pattern and modify the agents to create your own custom automations.

​
Troubleshooting

Make sure you click Save Configuration after entering credentials. Check the browser console for any error messages.
Test each agent individually first. Common issues:
  • Invalid API keys or credentials
  • Incorrect placeholder syntax
  • Missing required configuration fields
Ensure both agents are properly placed on the canvas. Try refreshing the page if connections appear stuck.
Verify your OAuth credentials are correctly configured in Supabase. See Gmail Reader for detailed setup instructions.
Need more help? Check out our detailed guides or deployment documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us