For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
  • Getting Started
    • What is Runtype?
    • Creating your account
    • Platform keys vs. BYOK
    • Understanding the Runtype UI
    • Quickstart: Social Media Post Generator
    • Quickstart: From Agent to Chat Widget
  • Dashboard
    • What is the Dashboard?
    • Daily executions
  • Playground
    • What is the Playground?
  • Products & Surfaces
    • What are Products?
    • What are Surfaces?
    • Creating a product
    • Setting up a chat surface
    • Setting up an API surface
    • Setting up an MCP surface
    • Setting up an A2A surface
    • Setting up a Slack surface
    • Setting up a webhook surface
    • MCP authentication
    • Authenticating with product API keys
    • Embedding the chat widget (script tag)
    • Embedding the chat widget (React)
    • Surface orchestration modes
    • Product views
    • Adding capabilities to a product
    • Connecting external agents
    • How A2A works
    • Connecting to MCP clients
    • Scoping API keys to capabilities
    • Auto-generated OpenAPI spec
    • Calling your API endpoints
    • Client tokens and domain restrictions
    • AI-powered theme generation
    • Widget theming and customization
    • Product versioning and status
  • Flows
    • What are Flows?
    • Creating and editing flows
    • Flow step types overview
    • Agent and flow templates
    • Using prompt steps
    • Using transform-data steps
    • Using conditional steps
    • Using fetch-url and api-call steps
    • Using record steps (upsert/retrieve)
    • Flow variables and templates
    • Flow versioning and publishing
    • Running flows in batch
    • Handling batch failures
    • Debugging flows
  • Agents
    • What are Agents?
    • Creating and configuring agents
    • Agent tools
  • Records
    • What are Records?
    • Creating and managing records
    • Using records in flows
    • Filtering and searching records
  • Tools
    • What are Tools?
    • Built-in tools
    • Creating custom tools
    • Creating external tools
    • Runtime tools
  • Evals
    • What are Evals?
    • Running an eval
    • Interpreting eval results
  • Schedules
    • What are Schedules?
    • Automating batch processing
  • Logs
    • What are Logs?
    • Working with logs
  • Integrations
    • Connecting AI model providers
    • Slack integration
    • Google Workspace integration
    • GitHub integration
    • Linear integration
    • Weaviate (vector search)
    • Firecrawl (web scraping)
    • Exa (web search)
    • Braintrust (tracing)
  • Settings
    • What's in Settings?
    • Available AI models
    • What are Organizations?
    • Managing AI models
    • Managing API keys
    • Managing secrets
    • Billing and plans
    • Usage data
    • Team members and permissions
    • Appearance and preferences
    • Integrations (PostHog, Weaviate, Daytona)
  • Troubleshooting & FAQ
    • FAQ
    • Rate limits and usage
    • Managing Runtype with Claude
    • Agent skills
    • Flow execution failures
    • Common errors and solutions
    • Authentication issues
Dashboard
LogoLogo
On this page
  • How Agents differ from Flows
  • How Agents work
  • An Agent in action
  • When to use Agents
  • Available tools
  • Next steps
Agents

What are Agents?

Was this page helpful?
Previous

Creating and configuring Agents

Next
Built with

Agents are AI workflows that autonomously decide which tools to use and how to accomplish goals. Unlike Flows, which follow predetermined steps, Agents reason about problems and choose their own path forward.

How Agents differ from Flows

Flows execute a fixed sequence of steps you define. Agents reason about problems and choose their own actions.

FlowsAgents
You define each stepAgent chooses actions
Predictable sequenceDynamic reasoning
Best for defined workflowsBest for open-ended tasks
Faster, more deterministicFlexible, more autonomous

How Agents work

You give an Agent three things:

  • Goal: What to accomplish
  • Tools: Functions it can call
  • Context: Information to work with

The Agent then:

  1. Analyzes the goal
  2. Decides which tool to use
  3. Calls the tool with appropriate parameters
  4. Reviews the result
  5. Repeats until the goal is achieved

An Agent in action

Sarah, a product manager at an interior design company, needs to compile competitive intelligence reports every Monday morning. Her stakeholders want summaries of what competitors shipped last week, but the information is scattered across blog posts, release notes, and documentation sites.

She tried building a Flow, but hit a problem. Each competitor publishes updates differently. Some announce on their blog. Others only update documentation. A few use Twitter threads. A fixed sequence of steps could not adapt to these differences.

Instead, Sarah builds an Agent.

She provides:

  • Goal: “Research what [competitor name] shipped last week and summarize key features”
  • Tools: Exa web search, Firecrawl scraper, a custom JavaScript function that formats markdown reports
  • Context: The competitor’s domain and a list of keywords to watch for

When Sarah triggers the Agent with “Acme Design” as the competitor, it autonomously decides:

  1. Search first. Calls Exa to find recent articles mentioning “Acme Design” and “launch”
  2. Found a blog post. Calls Firecrawl to extract the full content from acmedesign.com/blog
  3. Spots more references. The blog post mentions a new docs section, so it calls Firecrawl again to scrape that page
  4. Synthesizes findings. Analyzes both sources and identifies three new features
  5. Formats output. Calls the custom formatting tool to generate a markdown report
  6. Done. Returns the final summary to Sarah

Sarah never specified these steps. The Agent chose its path based on what it found. When she ran the same Agent for a different competitor the following week, it took a completely different route and went straight to documentation because search returned nothing recent.

That is the difference: Flows execute your plan. Agents make their own.

When to use Agents

Agents are a good fit for:

  • Complex, multi-step research tasks
  • Open-ended problem solving
  • Tasks that require adaptive decision-making
  • Workflows where the path varies by input

Flows are a better fit for:

  • Predictable, repeatable workflows
  • Tasks with a fixed set of steps
  • Workflows that need guaranteed execution order
  • Performance-critical operations

If you’re not sure which to use, start with a Flow. If you find yourself needing more flexibility or your workflow changes based on intermediate results, that is a good signal to try an Agent instead.

Available tools

Agents can tap into a wide range of tools to get things done. See What are Tools? for the full overview.

  • Built-in tools: GPT Image 2 image generation, Exa search, Firecrawl web scraping, and more. See Built-in tools.
  • Custom tools: JavaScript or Python functions you write for your specific needs
  • External tools: Any HTTP API
  • Flow tools: Run your existing Flows as tools to combine the predictability of Flows with the flexibility of Agents
  • MCP tools: Connect to Slack, Google Workspace, Linear, GitHub, or custom MCP servers
  • Subagent tools: Spawn focused child Agents with a subset of tools and isolated context

Next steps

  • Creating and configuring Agents to build your first Agent
  • Agent tools — Deep dive into how tools work with Agents
  • What are Tools? to understand the tool types Agents can use
  • What are Flows? to decide when a Flow is a better fit
  • Agent and Flow Templates to start from an example