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

# From Agent Builder

> Create a task while creating or editing an agent

Create a task in the **agent builder** when you are already setting up that agent. The same step exists in the assistant builder.

This attaches the task to the agent (or assistant) you are editing. To create tasks for any agent and manage templates or results, use [From Workspace Admin](https://docs.utopikai.com/tasks/workspace_admin.md).

## Create a task

1. Open the agent and go to **step 7: Tasks**. See [Creating Agents](https://docs.utopikai.com/guides/agents.md#step-7-tasks).
2. Search existing tasks by **Task ID**, or click **+ Add Task**.
3. Fill in the form, then **Create Task**.

![Tasks step in the agent builder](https://mintcdn.com/utopikai/IqQK-An4oxjyCiuB/images/guides/agents/07-tasks.png?fit=max\&auto=format\&n=IqQK-An4oxjyCiuB\&q=85\&s=3ff93a78ea589b8b222a7cc6d5cf6b75)

If none exist, the empty state is *No tasks for this agent yet.*

For an assistant, use **step 7: Tasks** in [Creating Assistants](https://docs.utopikai.com/guides/assistants.md#step-7-tasks). The empty state is *No tasks for this assistant yet.*

## New task form

![New task form in the agent builder](https://mintcdn.com/utopikai/oidXP_yBGYs8w75G/images/guides/agents/07-new-task.png?fit=max\&auto=format\&n=oidXP_yBGYs8w75G\&q=85\&s=f40b93b70b835fbced300f769d83d39d)

The **Agent** field is the agent you are editing (name, version, and status). It does not create a separate entity. The note reads *This task is created for the agent you are editing.*

When you add a task from the assistant builder, that field is the assistant.

| Field | Required | What it does |
| - | - | - |
| **Agent** | Yes | The agent or assistant you are editing |
| **Instructions** | Yes | Task instructions in Markdown |
| **Budget Currency** | No | Currency for the run budget |
| **Allowed Budget for each time task is running** | No | Spend cap per run |
| **Schedule type** | Yes | For example **Single** |
| **Run at** | Yes | Date and time for a single run |
| **Allowed Number of Steps** | No | Maximum steps per run (default `10`) |
| **Input Files** | No | Space to save files, plus drag-and-drop or **Choose files** |

Click **Create Task** to save, or **Cancel** to close without adding a task.

The full field list is also on [Tasks Overview](https://docs.utopikai.com/tasks/overview.md#new-task-form).

## Related documentation

* [Tasks Overview](https://docs.utopikai.com/tasks/overview.md)
* [From Workspace Admin](https://docs.utopikai.com/tasks/workspace_admin.md)
* [Task Templates](https://docs.utopikai.com/tasks/task_templates.md)
* [Task Results](https://docs.utopikai.com/tasks/task_results.md)
* [Creating Agents](https://docs.utopikai.com/guides/agents.md#step-7-tasks)
* [Creating Assistants](https://docs.utopikai.com/guides/assistants.md#step-7-tasks)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.