What This Covers
This page explains how to write effective instructions for your agents. Clear instructions lead to consistent, accurate results. Where to write instructions:- When creating an agent, type your task in the input on the homepage
- For existing agents, use the chat (left panel) to describe what you want—Incredible updates your agent automatically
- You can also directly edit the task in the right panel
The Formula
Every effective instruction has three parts:
- Where to get information — Which app, what data, what timeframe
- What to do with it — Summarize, copy, calculate, filter, etc.
- Where to put the result — Email, Slack, spreadsheet, etc.
Being Specific
- Good
- Needs work
- Specific time and frequency
- Clear search topic
- Defined number of results
- Exact email address
- Defined subject line format
Details to Include
| Detail type | Example | Why it matters |
|---|---|---|
| Links | https://docs.google.com/spreadsheets/d/abc123 | Agent can’t guess which spreadsheet you mean |
| Email addresses | [email protected] | ”Email me” requires knowing where |
| Channel names | #sales-updates | Slack has many channels |
| Time ranges | ”last 24 hours”, “from Dec 1-7” | Prevents unbounded searches |
| Quantities | ”top 5”, “all”, “first 10” | Sets clear expectations |
| Column names | ”the ‘Status’ column” | Identifies exact data location |
| Filters | ”with label ‘urgent‘“ | Narrows scope precisely |
Full Example
- Exact spreadsheet link provided
- Time range and timestamp column specified
- Clear list of what to research
- Specific columns for each data point
- Defined notification channel and message format
Common Mistakes
| Mistake | Problem | How to fix |
|---|---|---|
| ”Check my calendar” | Which calendar app? | ”Check my Google Calendar" |
| "Send to the team” | Who specifically? | ”Send to #team-updates in Slack" |
| "Recent emails” | How recent? | ”Emails from the last 48 hours" |
| "Important items” | What criteria? | ”Items with ‘urgent’ in subject or from @vip.com" |
| "Add to my spreadsheet” | Which one? | Include the full spreadsheet URL |
| ”Summarize the data” | Deliver where? | ”Email the summary to me at [address]“ |
| Schedule in task | Causes confusion | Set schedule separately using Add Trigger (⚡) |
Checklist Before Running
Task describes where to get data
Task describes what to do with it
Task describes where results go
All links and addresses included
Time ranges specified
Quantities defined (how many)
Advanced patterns
Advanced patterns
Conditional logic:Multiple outputs:Handling missing data:
Next: Managing Costs →
