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

# Managed Agents (Advanced)

> Optional, more technical custom agents. Most people should use the Core Agent instead.

<Warning>
  **Most people do not need Managed agents.** If you are non-technical, stay with the [Core Agent](/user-guide/agents/what-are-agents) in the Agents tab — chat with it, create [docs, sheets, and PDFs](/user-guide/agents/create-files), and you're done. Managed agents are an advanced option for teams that need heavily automated, hands-off runs.
</Warning>

## What is a Managed agent?

A **Managed agent** is a custom agent that runs in a **managed environment** — AI Suite handles more of the infrastructure behind the scenes. It is aimed at bigger, more independent tasks that may take several steps and several tools.

> An [**Assistant**](/user-guide/assistants) is a specialist you chat with.
> A **Managed agent** is closer to a **worker you hand a whole job to**, which then runs with less back-and-forth.

## Who this is for

| You want…                                     | Use this                                  |
| --------------------------------------------- | ----------------------------------------- |
| Everyday docs, sheets, PDFs, and tasks        | **[Core Agent](/user-guide/first-agent)** |
| A reusable specialist with fixed instructions | **[Assistant](/user-guide/assistants)**   |
| Advanced, more autonomous automated runs      | **Managed agent** (this page)             |

## How to create one

<Steps>
  <Step title="Create a Managed agent">
    Go to **Agents** (or the Platform area) and choose **Create** → **Managed agent**.

    <Frame caption="Creating a new Managed agent.">
      <img src="https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-managed-create.png?fit=max&auto=format&n=s9bw5Uhxs58-xnp0&q=85&s=3a9b56062cd44c563b7450b5ab238e52" alt="The create managed agent screen" width="1440" height="900" data-path="images/user-guide/agents-managed-create.png" />
    </Frame>
  </Step>

  <Step title="Name it and describe its goal">
    Give it a name and describe the **outcome**:

    > *Every week, gather our new customer sign-ups, group them by country, and produce a short summary report.*
  </Step>

  <Step title="Choose a model and tools">
    Pick the model and turn on only the tools it needs (see [Connect your tools](/user-guide/integrations)).
  </Step>

  <Step title="Set it running">
    Start the agent and watch progress.

    <Frame caption="A Managed agent working through its task, step by step.">
      <img src="https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-managed-run.png?fit=max&auto=format&n=s9bw5Uhxs58-xnp0&q=85&s=939c66a35f4836a2eb3f45d54fda8adb" alt="A managed agent showing its run steps and progress" width="1440" height="900" data-path="images/user-guide/agents-managed-run.png" />
    </Frame>
  </Step>

  <Step title="Review the result">
    Check what it produced. Refine the goal or tools and run again if needed.
  </Step>
</Steps>

## Good practices

* **Prefer the Core Agent first** — prove the workflow in a normal Agent chat before automating it.
* **Describe the goal clearly** — managed agents need a well-defined outcome.
* **Give it only the tools it needs.**
* **Check its work** before relying on it for anything important.

## Next step

<Card title="Back to the Core Agent" icon="robot" href="/user-guide/agents/what-are-agents">
  Return to the primary path most people use every day.
</Card>