Lindy Core Workflow A: Agent Creation
Overview
Complete workflow for creating, configuring, and testing Lindy AI agents.
Agents consist of four components: Prompt (behavioral instructions),
Model (AI engine), Skills (available actions), and Exit Conditions
(completion criteria).
Prerequisites
- Lindy account at
- Use case defined (support bot, email triage, data processor, etc.)
- Required integrations identified (Slack, Gmail, Sheets, etc.)
Instructions
Step 1: Define Agent Specification
Before building, document:
- Purpose: What the agent does (one sentence)
- Trigger: What wakes it up (webhook, email, schedule, chat, etc.)
- Actions: What it does (send email, update sheet, post to Slack, etc.)
- Model: GPT-4 (smart, expensive), Claude Sonnet (balanced), Gemini Flash (fast, cheap)
Step 2: Create the Agent
Option A — Natural Language (recommended):
Click New Agent at
Describe your agent in plain English:
When a customer emails support@company.com, classify the email as
billing/technical/general, draft a response using our knowledge base,
and post the classification to #support-triage in Slack
Agent Builder auto-generates trigger + action nodes
Option B — Manual Build:
- Click New Agent > Start from scratch
- Add trigger: Click "+" > Select trigger type
- Add actions: Click "+" > Search for action
- Connect nodes by dragging arrows between steps
Step 3: Configure the Prompt
Open Settings > Prompt. Structure it with clear sections:
## Identity
You are a customer support classifier and responder for [Company].
## Instructions
1. Read the incoming email carefully
2. Classify into: billing, technical, or general
3. Search the knowledge base for relevant answers
4. Draft a professional response using the KB results
5. If no KB match found, escalate to human
## Constraints
- Never promise refunds or credits without human approval
- Keep responses under 200 words
- Always include ticket reference number
Prompt best practices (from Lindy docs):
- Use action-oriented language (imperatives)
- Break complex logic into numbered steps
- Include few-shot examples for consistent formatting
- Add constraints to prevent unwanted behavior
Step 4: Add Conditions (Branching Logic)
- Click "+" > Condition
- Write natural language condition:
"Go down this path if the email is about billing"
- Add multiple branches for different classifications
- Enable "Force the agent to select a branch" for deterministic routing
Step 5: Configure Actions
For each action, set field modes:
Auto mode — Agent infers the value from all previous step data:
Best for: predictable mappings where field names align
AI Prompt mode — Give natural language instructions:
Summarize the email in 2 sentences, then include the classification.
Reference: {{email_received.body}}
Set Manually mode — Exact value, no AI:
Channel: #support-triage
Step 6: Add Knowledge Base (Optional)
- Go to Settings > Knowledge Base
- Add sources: PDF, DOCX, Google Drive, Notion, websites
- Configure search:
- Max Results: 4 (default) to 10
- Search Fuzziness: 0 (keyword) to 100 (semantic, recommended)
- Agent auto-searches KB when relevant to the task
Step 7: Test the Agent
- Use the Test button in the workflow editor
- Provide sample input matching your trigger type
- Review each step's output in the task detail view
- Iterate on prompt and action configuration
Trigger Types Reference
| Trigger |
Use Case |
Configuration |
| Webhook Received |
External API calls |
URL + secret key |
| Email Received |
Inbox automation |
Gmail/Outlook + label filters |
| Schedule |
Recurring tasks |
Cron-style: daily, weekly, custom |
| Chat Message |
Interactive bot |
Lindy Chat or Embed widget |
| Slack Message |
Team automation |
Channel + keyword filters |
| Agent Message |
Multi-agent delegation |
Receives from other Lindies |
| Calendar Event |
Meeting automation |
Minutes offset (-30 = 30 min before) |
| Form Submission |
Lead capture |
Connected form integration |
Action Categories
| Category |
Actions |
| Email |
Send Email, Draft Reply, Search Inbox, Add Label |
| Slack |
Send Channel Message, Send DM, Thread Reply |
| Sheets |
Update Spreadsheet, Get Document |
| Calendar |
Create Event, Reschedule, Cancel |
| Knowledge |
Search Knowledge Base, Resync KB |
| Code |
Run Code (Python/JS in E2B sandbox) |
| Web |
HTTP Request, Web Search, Website Crawler |
| Memory |
Read/Create/Update/Delete Memory |
| Phone |
Make Call, Transfer Call, End Call |
| Agent |
Agent Send Message (delegation) |
Error Handling
| Error |
Cause |
Solution |
| "No trigger configured" |
Agent has no trigger |
Add at least one trigger node |
| Action fails silently |
Wrong field mode |
Switch to AI Prompt or Set Manually |
| KB returns no results |
Fuzziness too low |
Increase to 100 (semantic search) |
| Condition always picks same path |
Ambiguous prompt |
Make conditions more specific |
| Agent loops indefinitely |
No exit condition |
Add measurable exit criteria |
Output
Produce an agent specification with a named trigger, explicit identity and
constraints, ordered actions, safe failure behavior, and one acceptance fixture
that proves the agent performs the intended task without unintended side work.
Examples
Create a lead-routing agent triggered by a tagged form submission. It validates
the required fields, assigns the record only when the stated routing rule
matches, and otherwise records a review task; a fixture for each branch proves
the constraints are applied before any connected-system action.
Resources
Next Steps
Proceed to lindy-core-workflow-b for triggers, automation, and multi-agent delegation.
1---2name: lindy-core-workflow-a3description: Build and configure multi-step Lindy AI agent workflows. Use when creating agents with triggers, actions, conditions, knowledge bases, or agent steps. Trigger with phrases like "create lindy agent", "build lindy agent", "lindy agent workflow", "configure lindy agent", "lindy workflow".4license: MIT5---6# Lindy Core Workflow A: Agent Creation
7
8## Overview
9
10Complete workflow for creating, configuring, and testing Lindy AI agents.
11Agents consist of four components: **Prompt** (behavioral instructions),
12**Model** (AI engine), **Skills** (available actions), and **Exit Conditions**
13(completion criteria).
14
15## Prerequisites
16
17- Lindy account at
18- Use case defined (support bot, email triage, data processor, etc.)
19- Required integrations identified (Slack, Gmail, Sheets, etc.)
20
21## Instructions
22
23### Step 1: Define Agent Specification
24
25Before building, document:
26
27- **Purpose**: What the agent does (one sentence)
28- **Trigger**: What wakes it up (webhook, email, schedule, chat, etc.)
29- **Actions**: What it does (send email, update sheet, post to Slack, etc.)
30- **Model**: GPT-4 (smart, expensive), Claude Sonnet (balanced), Gemini Flash (fast, cheap)
31
32### Step 2: Create the Agent
33
34**Option A — Natural Language (recommended)**:
35
361. Click **New Agent** at
372. Describe your agent in plain English:
38
39 ```
40 When a customer emails support@company.com, classify the email as
41 billing/technical/general, draft a response using our knowledge base,
42 and post the classification to #support-triage in Slack
43 ```
44
453. Agent Builder auto-generates trigger + action nodes
46
47**Option B — Manual Build**:
48
491. Click **New Agent** > **Start from scratch**
502. Add trigger: Click **"+"** > Select trigger type
513. Add actions: Click **"+"** > Search for action
524. Connect nodes by dragging arrows between steps
53
54### Step 3: Configure the Prompt
55
56Open **Settings > Prompt**. Structure it with clear sections:
57
58```
59## Identity
60You are a customer support classifier and responder for [Company].
61
62## Instructions
631. Read the incoming email carefully
642. Classify into: billing, technical, or general
653. Search the knowledge base for relevant answers
664. Draft a professional response using the KB results
675. If no KB match found, escalate to human
68
69## Constraints
70- Never promise refunds or credits without human approval
71- Keep responses under 200 words
72- Always include ticket reference number
73```
74
75**Prompt best practices** (from Lindy docs):
76
77- Use action-oriented language (imperatives)
78- Break complex logic into numbered steps
79- Include few-shot examples for consistent formatting
80- Add constraints to prevent unwanted behavior
81
82### Step 4: Add Conditions (Branching Logic)
83
841. Click **"+"** > **Condition**
852. Write natural language condition: `"Go down this path if the email is about billing"`
863. Add multiple branches for different classifications
874. Enable **"Force the agent to select a branch"** for deterministic routing
88
89### Step 5: Configure Actions
90
91For each action, set field modes:
92
93**Auto mode** — Agent infers the value from all previous step data:
94
95```
96Best for: predictable mappings where field names align
97```
98
99**AI Prompt mode** — Give natural language instructions:
100
101```
102Summarize the email in 2 sentences, then include the classification.
103Reference: {{email_received.body}}
104```
105
106**Set Manually mode** — Exact value, no AI:
107
108```
109Channel: #support-triage
110```
111
112### Step 6: Add Knowledge Base (Optional)
113
1141. Go to **Settings > Knowledge Base**
1152. Add sources: PDF, DOCX, Google Drive, Notion, websites
1163. Configure search:
117 - **Max Results**: 4 (default) to 10
118 - **Search Fuzziness**: 0 (keyword) to 100 (semantic, recommended)
1194. Agent auto-searches KB when relevant to the task
120
121### Step 7: Test the Agent
122
1231. Use the **Test** button in the workflow editor
1242. Provide sample input matching your trigger type
1253. Review each step's output in the task detail view
1264. Iterate on prompt and action configuration
127
128## Trigger Types Reference
129
130| Trigger | Use Case | Configuration |
131|---------|----------|---------------|
132| **Webhook Received** | External API calls | URL + secret key |
133| **Email Received** | Inbox automation | Gmail/Outlook + label filters |
134| **Schedule** | Recurring tasks | Cron-style: daily, weekly, custom |
135| **Chat Message** | Interactive bot | Lindy Chat or Embed widget |
136| **Slack Message** | Team automation | Channel + keyword filters |
137| **Agent Message** | Multi-agent delegation | Receives from other Lindies |
138| **Calendar Event** | Meeting automation | Minutes offset (-30 = 30 min before) |
139| **Form Submission** | Lead capture | Connected form integration |
140
141## Action Categories
142
143| Category | Actions |
144|----------|---------|
145| **Email** | Send Email, Draft Reply, Search Inbox, Add Label |
146| **Slack** | Send Channel Message, Send DM, Thread Reply |
147| **Sheets** | Update Spreadsheet, Get Document |
148| **Calendar** | Create Event, Reschedule, Cancel |
149| **Knowledge** | Search Knowledge Base, Resync KB |
150| **Code** | Run Code (Python/JS in E2B sandbox) |
151| **Web** | HTTP Request, Web Search, Website Crawler |
152| **Memory** | Read/Create/Update/Delete Memory |
153| **Phone** | Make Call, Transfer Call, End Call |
154| **Agent** | Agent Send Message (delegation) |
155
156## Error Handling
157
158| Error | Cause | Solution |
159|-------|-------|----------|
160| "No trigger configured" | Agent has no trigger | Add at least one trigger node |
161| Action fails silently | Wrong field mode | Switch to AI Prompt or Set Manually |
162| KB returns no results | Fuzziness too low | Increase to 100 (semantic search) |
163| Condition always picks same path | Ambiguous prompt | Make conditions more specific |
164| Agent loops indefinitely | No exit condition | Add measurable exit criteria |
165
166## Output
167
168Produce an agent specification with a named trigger, explicit identity and
169constraints, ordered actions, safe failure behavior, and one acceptance fixture
170that proves the agent performs the intended task without unintended side work.
171
172## Examples
173
174Create a lead-routing agent triggered by a tagged form submission. It validates
175the required fields, assigns the record only when the stated routing rule
176matches, and otherwise records a review task; a fixture for each branch proves
177the constraints are applied before any connected-system action.
178
179## Resources
180
181- [Lindy Introduction](https://docs.lindy.ai/fundamentals/lindy-101/introduction)
182- [Triggers Documentation](https://docs.lindy.ai/fundamentals/lindy-101/triggers)
183- [Actions Documentation](https://docs.lindy.ai/fundamentals/lindy-101/actions)
184- [Prompt Guide](https://docs.lindy.ai/fundamentals/lindy-101/prompt-guide)
185
186## Next Steps
187
188Proceed to `lindy-core-workflow-b` for triggers, automation, and multi-agent delegation.