---
title: "Run an agent"
slug: "run-an-agent"
abstract: "How to run an agent in SitecoreAI."
---
# Run an agent

[Agents](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-agents/understanding-agents.html "Understanding agents") can help you you complete marketing tasks quickly and efficiently, such as generating content, conducting research, or translating copy. You can run a single agent on demand for focused tasks. If your task involves multiple steps or coordination between agents, consider using an agentic flow instead.

> [!tip]
> To help you get started, SitecoreAI include several [prebuilt agents](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-agents/understanding-agents.html#available-agents "Prebuilt agents").

When you run an agent, it generates an artifact. The AI thought process is displayed to help you understand how the outcome was generated. You can convert the chat conversation into a [space](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-chat/convert-a-chat-to-a-space.html "Convert a chat to a space") to track progress and store results.

> [!note]
> **Before you begin**
> -   Make sure you know what you want to achieve. A clear objective helps you choose the right agent and get better results.
>
> -   Review [available agents](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-agents/understanding-agents.html#available-agents "Prebuilt agents") to find the best fit for your task.
>
> -   Make sure the agent is configured for your needs. See [Before you start using agents](https://doc.sitecore.com/sai/en/users/sitecoreai/understanding-agents.html#before-you-start-using-agents).

You can run an agent in three ways:

- [From the Agents page.](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-agents/run-an-agent/run-an-agent.html#run-an-agent-from-the-agents-page "Run an agent from the Agents page")
- [From the chat interfaces in Agentic studio.](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-agents/run-an-agent/run-an-agent.html#run-an-agent-from-the-chat-interface "Run an agent from the Chat interface")
- [From anywhere in SitecoreAI by clicking **AI assistant** in the upper-right corner.](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-agents/run-an-agent/index.html#run-an-agent-from-anywhere-in-sitecoreai)

## Run an agent from the Agents page

To run an agent from the **Agents** page:

1. In the navigation menu, click **Agentic**.
2. In the left sidebar, click :mdiStarFourPointsBoxOutline: **Agents**.
3. On the **Agents** page, find and click the agent you want to run.

    This opens the agent in the [Chat interface](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-chat/understanding-chat.html "Understanding chat"). If the agent requires additional information, you are prompted to answer questions before continuing. You can also add additional tools and context before generating a response.

## Run an agent from the Chat interface

To run an agent from the Chat interface:

> [!important]
> Always review AI-generated artifacts carefully and validate key information before using them.

1. In the navigation menu, click **Agentic**.
2. In the left sidebar, either click :mdiSpeedometer: **Overview** or :mdiChatOutline: **Chat**
3. In the chat interface, click **Select Agent** and choose the agent you want to run.

    ![AS_Agents_select_agent_chat.png](https://doc.sitecore.com/api/markdown-image/sai/en/users/sitecoreai/images/AS_Agents_select_agent_chat.png)

4. Enter a prompt.
5. On the **Agents** tab, if setup is required, click the agent and configure it (for example, select target languages for the **Translator** agent).
6. Optionally, add more information to guide the agent:
    - Click **Context** :mdiBookOpenBlankVariantOutline: to include sources such as artifacts or your organization’s brand kit.
    - Click **Items** :mdiNoteTextOutline: to include sites, collections, artifacts, briefs, or CSV files.
    - Click **Attach files** :mdiPaperclip: to upload files related to your request.
7. Press Cmd + Enter (Mac) or Ctrl + Enter (Windows) to submit the request.

    > [!tip]
    > Processing might take some time. You can leave the page and return to the [space](https://doc.sitecore.com/sai/en/users/sitecoreai/working-with-agentic-studio/understanding-spaces/understanding-spaces.html "Understanding spaces") at any time to track progress.

    The agent processes your request and when processing is complete, the results appear in the chat.

8. To move this chat into a space for further collaboration, click **Convert to space** :mdiArrowTopRight:.

## Run an agent from anywhere in SitecoreAI

To run an agent from anywhere in SitecoreAI:

1. Click **AI assistant** in the upper-right corner.
2. In the chat drawer, click :mdiPlayOutline: **Run agents** and, in the panel that opens, click the agent you want to run.
3. Provide the required input.
4. On the **Agents** tab, if setup is required, click the agent and configure it (for example, select target languages for the **Translator** agent).
5. Optionally, add more information to guide the agent:
    - Click **Context** :mdiBookOpenBlankVariantOutline: to include sources such as artifacts or your organization’s brand kit.
    - Click **Items** :mdiNoteTextOutline: to include sites, collections, artifacts, briefs, or CSV files.
    - Click **Skills & Tools** :mdiLightningBoltOutline: to add agent skills.
    - Click **Attach files** :mdiPaperclip: to attach files to the request.
6. Click **Start** to run the agent.

    The agent processes your request and when processing is complete, the results appear in the chat conversation.

> [!tip]
> Processing might take some time. You can leave the page and return at any time to track progress.

> [!important]
> Always review AI-generated artifacts carefully and validate key information before using them.