> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteroid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow Settings

> Configure the settings that apply to your whole workflow

Workflow settings apply to every node in the workflow, and to all of its executions. You'll find them as chips along the bottom of the Builder.

<Info>
  **Workflow settings vs. Agent Profiles**

  * **Workflow settings** (this page): the environment, the execution timeout, and global rules. They belong to the workflow itself.

  * **Agent Profiles**: browser environment settings like proxies, cookies, cache persistence, and credentials. Profiles are reusable across workflows. See [Agent Profiles](/fundamentals/profiles).
</Info>

## Workflow-level configuration

<CardGroup cols={3}>
  <Card title="Environment" icon="display" horizontal>
    Whether the workflow runs in a browser or on a full desktop
  </Card>

  <Card title="Settings" icon="clock" horizontal>
    The timeout that bounds every run
  </Card>

  <Card title="Global Rules" icon="scroll" horizontal>
    Instructions that apply across Agent nodes
  </Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Environment">
    Choose **Browser** for a Chromium web browser, or **Linux** or **Windows** for a full desktop. The environment decides which capabilities each Agent node can use — see [Capabilities](/fundamentals/ai-capabilities) and [Environments](/fundamentals/environments).
  </Accordion>

  <Accordion title="Settings">
    **Timeout (minutes)** `1-120`

    Maximum time an execution may run before it stops. An execution that exceeds this limit is canceled with the reason `timeout` — see [Execution Statuses](/fundamentals/execution-statuses#cancellation-reasons).
  </Accordion>

  <Accordion title="Global Rules">
    Instructions that apply across the whole workflow rather than to a single node. Every Agent node receives these rules alongside its own instructions, which makes them the right place for guidance that should hold everywhere — tone and formatting conventions, sites or actions to avoid, or how to handle a blocker that can appear at any point in the run.

    Rules support the same `{{.variable}}` templating as node instructions, so you can reference your workflow's inputs.
  </Accordion>
</AccordionGroup>

***

## Profile-Level Settings

The following settings are configured in **Agent Profiles**, not in workflow settings. Profiles allow you to reuse browser environment configurations across multiple agents.

<AccordionGroup>
  <Accordion title="Proxy Configuration">
    **Proxy settings** (country, type, persistent IP) are configured in [Agent Profiles](/fundamentals/profiles#profile-configuration).

    <Info>
      Configure proxy settings when creating or editing an agent profile. This allows you to reuse the same proxy configuration across multiple agents.
    </Info>
  </Accordion>

  <Accordion title="Cache & Cookie Persistence">
    **Cache persistence** and **cookie management** are configured in [Agent Profiles](/fundamentals/profiles#profile-configuration).

    <Info>
      Enable cache persistence in your agent profile to maintain browser state, cookies, and cached data between executions. This is separate from workflow-level cache clearing.
    </Info>
  </Accordion>

  <Accordion title="Credentials & Authentication">
    **Credentials, cookies, and 2FA secrets** are managed in [Agent Profiles](/fundamentals/profiles#credentials-management).

    <Info>
      Store authentication credentials securely in agent profiles. These can be reused across multiple agents that need the same authentication.
    </Info>
  </Accordion>
</AccordionGroup>

***

## Agent Management

<CardGroup cols={2}>
  <Card title="Agent Identity" icon="user" horizontal>
    Manage agent name and organizational settings
  </Card>

  <Card title="Data Management" icon="database" horizontal>
    Clear workflow-level cache and stored data
  </Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Agent Identity">
    **Change Agent Name**

    Update the display name for this agent

    **Organization**

    Set or change the organization that owns this agent. Anyone with access to this organization will be able to see and use this agent.
  </Accordion>

  <Accordion title="Data Management">
    **Clear Browser Cache**

    Clear the browser cache for this agent. This removes:

    * All cached data and files
    * Stored cookies and sessions
    * Browser state and preferences

    <Info>
      This clears workflow-level cache. For profile-level cache persistence settings, see [Agent Profiles](/fundamentals/profiles#profile-configuration).
    </Info>
  </Accordion>

  <Accordion title="Agent Deletion">
    **Delete Agent**

    Permanently remove this agent, including:

    * All previous versions
    * All execution history
    * All associated data

    <Warning>
      This action cannot be undone. Consider exporting important data before deletion.
    </Warning>
  </Accordion>
</AccordionGroup>