Tasks
Tasks allow agents to help you execute recurring actions.
Some examples of tasks an agent can help you execute:
- Make a recurring buy of a token
- Sell a target at a target market cap
- Email a daily research report of the top trending token
- Post or reply on X
- Deposit leftover USDC in your wallet to earn yield
Creating a Task
Tasks are composed of four parts:
- Title - brief description of the task for humans
- Prompt - instruction given to the agent to execute
- Interval - frequency to execute the task
- Agent - the selected agent that executes the task
Let's go into each element in more detail.
Title
The title is for organizational purposes and helps you keep track of recurring tasks. Tasks are executed within a thread and the thread will share this title.
Prompt
The prompt is the instruction given to your agent to execute. Prompts should be clear instructions about what to do during a single execution of the task.
For example if you want the agent to sell a token at a target market cap:
- Avoid saying something like "Monitor the market cap of the token and sell when it hits a 2x". The agent does not continuously run the task to do monitoring.
- Instead give a clear instruction to "Get the market cap of the token. If the market cap is above [insert target market cap here], sell all of the token."
This makes it clear that in a single execution of the task, you want to get the token's market cap, check if it is above a target market cap, and to sell all of the token if it is.
You can test your prompts directly in the thread the task runs. Open task tab in the thread sidebar and hit play.
Interval
The interval specifies how frequently the task will run. Tasks can run as frequently as every 15 minutes.
Tasks are executed based on the number of minutes since UTC midnight.
For example, if the interval is set to 1440 minutes (24 hours), the task will execute every day at UTC midnight.
Agent
Tasks are assigned to a specific agent that executes the instructions in the prompt.
When selecting an agent, it is important to make sure the agent has the ability to do the task. Agents need to have the specific actions enabled to do things like post on X, swap tokens, or get trending tokens.
If you are unsure if an agent is capable of a certain action, you can test your task within the thread.
Testing a Task
Tasks are executed within a thread. In the thread sidebar, you can manually trigger a task execution in the task tab.
When a task is executed, messages are saved in the thread history. You can also view any actions executed in the thread sidebar's history tab.
Updating a Task
You can update a task's title, prompt, and interval in the task tab of the thread sidebar.
You can also pause or delete the task if you no longer want the task to execute.
Energy for Tasks
There is no limit on how many tasks your account can have. However, task execution incurs the same energy costs as chatting with an agent.
You can read more about energy here.
Turn energy into action
Create an account to get started