---
title: "Put an agent to work on a project"
description: "Deploy an agent to a project, brief it with a goal and instructions, choose what starts it and test it on a sample event."
url: "https://okido.io/en/docs/ai/put-an-agent-on-a-project"
chapter: "AI"
chapterUrl: "https://okido.io/en/docs/ai.md"
plans: ["Starter", "Pro", "Business"]
roles: "Owner, Admin"
language: "en"
edition: "2026-10-23"
---

# Put an agent to work on a project

> Deploy an agent to a project, brief it with a goal and instructions, choose what starts it and test it on a sample event.

An agent works on a project once you deploy it there. The project's **Agents** tab is where you do that, and where you brief the agents: a goal and instructions that every agent on the project follows, and for each agent what makes it start, how often it asks for approval and instructions for that agent only.

Owners and admins manage a project's agents, and members who have the Advanced AI features. Everyone else sees the tab without changing it.

## Open the project's agents

1. Open the project and choose the **Agents** tab.

At the top you see the **Project goal** and the **Project instructions**, shared by every agent on the project. Below them, under **Briefing for**, are the agents working here; choose one to see and change its settings. On the right, **Briefing** shows what the agent reads before it starts, **Memory** what agents remember about the project, and **Recent runs** what the agent did here lately.

![The Agents tab of a project with its goal, its instructions and the copywriter agent's recent runs](https://okido.io/docs/screenshots/en/project-agents-view.webp)

## Deploy an agent

1. Choose **Deploy agent**.
2. Choose an agent from the list. It shows your organization's active agents that are not on this project yet.
   ![The list of agents to deploy to the project](https://okido.io/docs/screenshots/en/deploy-agent-menu.webp)

The agent is added to the project. It starts when it is assigned a task or @mentioned in a comment on this project.

## Brief the agent

1. Fill in the **Project goal** and the **Project instructions** if the project does not have them yet. Every agent on the project gets them.
2. Under **Briefing for**, choose the agent.
3. Under **When it starts working**, tick the events that start it: a task assigned to it, an @mention, a new task, an updated task, a completed task or any comment. Next to each event you see how often it happened in the project last week.
   ![The events that start the QA agent on this project, with a completed task ticked](https://okido.io/docs/screenshots/en/agent-briefing.webp)
4. Under **How often it asks for approval**, choose how careful the agent is, from **None** (never asks) to **Full** (asks before every change).
5. Write instructions for this agent only, if it needs any.
6. Choose **Save changes** in the bar at the bottom.

The agent follows the new briefing from its next run on. Choose **Who starts on what** to see for all agents at once which events start them.

## Test the agent on a sample event

1. On the right, choose **Test run**.
2. Pick an **Event** and, under **About task**, a task of the project. For a comment event, type the comment too.
3. Choose **Run test**.
   ![The result of a test run: what the agent would do and its answer](https://okido.io/docs/screenshots/en/agent-test-run.webp)

You see what the agent would do, in order, and its answer. Nothing it would change is applied and nothing is posted. The test uses the saved briefing, so save your changes first.

> **Tip:** To take an agent off the project, choose it under **Briefing for** and choose **Remove from project**. Its settings elsewhere stay the same.