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

# Get started with Agents

> Build your first Agent with AI Marketer (Aim), run it, and refine it in chat

This guide takes you from an empty Agents page to an Agent that runs on its own. You describe the task, let AI Marketer (Aim) build the Agent, run it, and refine it in the same chat.

## Before you start

* **Pick a task with a clear outcome.** A weekly summary of a Visibility Score change, a content brief from a keyword, and a digest of new brand mentions are all good use cases for Agents.
* **Decide how the Agent should run:** on demand, on a schedule, or when something happens on the web or with your Profound data. Change this at any time.
* **Check for Workflows you can reuse.** If a Workflow already handles part of the task, the Agent can run it as a step instead of repeating that work.

## Build an Agent

**1. Start a new Agent**

In the Profound platform, go to **Workspace > Agents** in the left sidebar and select **Create**. Or select **+** next to **Agents** in the sidebar.

The **Create an agent** page opens with an empty Aim chat. Templates are listed below it under **Use a template**.

To build a Workflow instead, select the arrow next to **Create**, then **Workflows** > **New Workflow**.

**2. Describe the Agent**

Write what the Agent should do, when, and where the result goes. One or two sentences are enough. For example:

```txt wrap theme={null}
Every Monday, check whether our Visibility Score dropped week over week for the AI Visibility Products category and save a short summary as a Document.
```

If a Workflow should handle part of the job, name it in your description, for example, "Use the Competitor Snapshot Workflow to pull the numbers, then write the summary."

Send the message, and Aim starts working.

**3. Answer the questions**

Aim asks for anything it can't infer from your description. In the example above, it may ask what time on Monday to run and how detailed the summary should be.

The questions appear in the message box, one at a time. Select the option Aim suggests, select **Skip** to let Aim choose for you, or type your own answer in the **Other...** field. Select **Next** to move on and **Submit** after the last question.

When Aim has a name and instructions for the Agent, it creates the Agent and shows an **Agent created** message. The Agent's page opens with the chat on the left and the Agent's settings on the right.

**4. Review the Agent**

The settings panel lists the Agent's building blocks: **Triggers**, **Inputs**, **Instructions**, **Outputs**, **Tools**, **Context**, and **Advanced settings**. Learn more about them in [Building blocks of an Agent](https://docs.tryprofound.com/agents/building-blocks-of-agent.md).

Review each one. To change something, edit it directly or describe the change in the chat. Changes apply to the Agent right away: there's no separate publish step.

To have the Agent run one of your Workflows as a step, type **/** in the instructions, open **Agents**, and pick the Workflow. Learn more in [Agents and Workflows: when to use which](https://docs.tryprofound.com/agents/agents-vs-workflows.md).

**5. Run the Agent**

Select **Run Agent** at the top of the page, or above the message box. If the Agent has inputs, a short form opens in the message box: fill in each input, then select **Start run**.

The run happens in the Agent's chat. You see each step, each tool call, and the result as they happen. When the run finishes, ask follow-up questions about the results, or describe what to change in the Agent and Aim updates it. Run the Agent again after each change to check the output.

If the run button is unavailable because some of the tools the Agent needs aren't connected, connect the missing tools in the **Tools** section first.

**6. Review runs and artifacts**

The Agent's page keeps a record of its work. Select either option at the top of the page:

* **Past Runs**: every run, manual or triggered. Select a run to reopen it in the chat.
* **Artifacts**: the Documents, Sheets, and files the Agent produced.

**7. Refine the Agent**

Use what you learned from the first runs to improve the Agent. There are two ways to do it:

* **Edit the configuration yourself.** Change the instructions, inputs, outputs, tools, or context directly in the settings panel.
* **Give feedback in the chat.** Describe what you'd like to be different, and Aim updates the Agent. For example, "Pull in my brand kit to better align with my brand's tone of voice."

Changes apply right away. Select **Run Agent** to check the result, and repeat until the output is what you need.

**8. Add triggers and share**

To have the Agent run on its own, add a trigger under **Triggers** in the settings panel and make sure that trigger's switch is on. Learn more in [Triggers in Agents](https://docs.tryprofound.com/agents/triggers-in-agents.md).

To give teammates access, select **Share** at the top of the page.

## Starting from a template

Templates are a quick way to get started with Agents. Select **See all** in the template carousel on the Agents page to browse them. Filter templates by category or search for one. Templates also appear under **Use a template** on the **Create an agent** page.

Select a template to see its description, **Steps**, and **Instructions**. Select **Use template**, and Aim builds your own private copy of the template in a new chat and helps you set it up. Connect any tools it needs, and adjust it however works best for you.

## Finding your Agents

The Agents page lists your Agents. Use the **All**, **My Agents**, **Favorites**, and **Shared with me** tabs to find them. Filter by **Created by**, use **Type** to show only Agents or only Workflows, or select **Search** to find one by name.

Each row shows the Agent's name, owner, and an icon that shows whether access is private or shared. Incomplete Agents have a **Draft** label. Select the star on a row to add an Agent to the **Favorites** tab.
