Automation

Agent

Updated 2026-11-09·6 min read·View as Markdown

Add an AI Agent to Any Step

Drop one of your Custom AI Agents into the middle of an automation and it reads the incoming data, decides what to do, and hands the result to the next step. Ask an agent a question, run a predefined command, and use the response in later steps. This is how you add real judgment, not only fixed rules, to an automation.

TL;DR: The Agent action runs an AI agent as a step inside an automation. Ask the agent a question or run a command. Then pass its response to the next step. It taps frontier models from top AI labs, custom tools, and project knowledge to classify, draft, or decide mid-workflow.

This means your automations are no longer limited to simple if-then logic. An AI agent can analyze data, draft content, classify information, or make decisions, and then pass the result to the next action in the chain. Agents run on frontier models from top AI labs. They can also use custom tools, tap project knowledge, or coordinate with an agent team.


Custom Agent Actions

Here are the actions you can use in your automations:

🏷️ Field 🔤 Description
(ACTION) Ask an agent Uses a custom AI agent to respond to a query.
(ACTION) Run an agent command Uses a custom AI agent command.

Agent Automation Settings

Connector options give you full control over Agent automations:

Action: Ask an agent

🏷️ Field 🔤 Description
AGENT Choose the AI agent to ask. This field is required.
INPUT Type your question or command for the AI agent. You can type "@" or click the ➕ plus button to insert data dynamically.
OUTPUT TYPE (optional) Pick Plain Text or Structured Output. With Structured Output, click ➕ Add Field to define typed fields. Each field becomes a variable for later steps. See Get Structured Output from an Agent.

Action: Run an agent command

🏷️ Field 🔤 Description
AGENT Select the AI agent that runs the command. This field is required.
COMMAND Choose the specific command you want the AI agent to run. This field is required.
INPUT If the command needs more input, add it here. You can type "@" or click the ➕ plus button to insert data.
OUTPUT TYPE (optional) Pick Plain Text or Structured Output. With Structured Output, add typed fields the same way as structured output on Ask an agent. Each field becomes a variable for later steps.

💡 Structured output works on Run an agent command too. Set Output Type to Structured Output, then click ➕ Add Field to define typed fields (Text, Number, Boolean, Date, JSON Object, and more). The step then returns those fields instead of free-form text. Use it when a command feeds a Branch, Insert Row, or Update Custom Field step.

Example: A /qualify-lead command on a Sales Agent returns score (Number) + tier (Single Select). Wire tier into a Branch and score into an Update Custom Field. No prose parsing required.


Use Cases

Here are a few ways to use the Agent action in your automations:

🪄 Use Case 🔤 Description
Email triage Feed incoming emails to an agent that classifies them by urgency and drafts suggested replies.
Content generation After scraping a webpage, ask an agent to summarize the content or rewrite it for a specific audience.
Data enrichment Pass lead information through an agent that researches the company and appends context before creating a CRM entry.
Code review assistance Send code snippets to an agent that checks for common issues and returns improvement suggestions.

Tip: The Agent action works best when paired with data-gathering steps like Read a web page or Search the web. Feed real-world data into your agent for more accurate, context-aware responses.


Plan for Long Agent Steps

An Ask an agent or Run an agent command step runs once and has up to 15 minutes to finish. Taskade does not start the step again on its own.

An agent can write to your projects and send messages. A second copy of the same step can repeat that work, so give each agent step one clear job.

  • Keep each request focused. A short, specific request finishes well inside the limit.
  • Split a long research task into two or more agent steps. Pass the result of each step to the next one.
  • If an agent step fails, open the Runs tab and read the error. Fix the cause, then retry the run. A retry runs the agent step again.

The Agent Brings Its Own Model

The Ask an agent step runs the agent exactly as it is set up, so it uses the model you picked in the agent's own settings. There is no model dropdown on the step itself. To change which model answers, open the agent and change it there.

  • Open the agent and go to General → AI Model.
  • Pick from the full model menu: Auto at the top, then the speed and reasoning tiers, then All Models with the credit cost beside each name.
  • Save. Every automation that calls this agent picks up the change.

If the agent runs on your own AI provider key, your provider bills the model call. Taskade then bills one fixed step fee in credits for each Ask an agent step, the same fee as every other automation step on your key. The fee applies from the first step, because the included agent steps of your plan do not cover automation steps. See Bring Your Own AI Keys.

Want to choose a model per step instead of per agent? Use the Taskade AI step. Each Taskade AI step, from Ask AI to Categorize with AI, carries its own Model (optional) menu with TSK-Auto and the TSK tiers. See AI Models & Credit Costs for which tier fits which job.


Was this helpful?