Add Agents to a Workspace

1 When to add an agent

Add an agent when a folder has a clear job and you want OpAgent to use the same helper repeatedly.

Examples:

• a writing folder uses a writing or editing agent;
• a research folder uses a research agent;
• a coding folder uses a development agent;
• a project folder uses a project-specific assistant.

2 Add an existing agent

1. Open the workspace folder

   Open the workspace or subfolder where you want the agent to work.

2. Open the Add Agent menu

   Use the + button next to the folder or right-click the folder and choose Add Agent….

3. Search for the agent

   The popup shows agents that are already available in your OpAgent environment. Search by name if the list is long.

4. Select the agent

   Click the agent you want to attach. The folder will show an agent badge after it is added.

5. Chat with that agent

   Open the conversation panel. When you work inside that folder, use the selected agent for summaries, rewrites, planning, coding help, or other tasks.

3 Where agents come from

Agents can come from different places:

• built-in OpAgent resources;
• agents installed from Marketplace;
• custom agents you create yourself;
• agents shared by your team or placed in the agents folder.

If the agent you expect does not appear, open Marketplace or refresh the agent list after adding the resource.

4 Switch to another agent

If a folder already has an agent, switch it from the folder’s agent controls or replace the folder agent with a different one.

A good rule: one folder should have one clear agent role. If the job changes completely, create a new folder or switch to a more suitable agent.

5 Tips

• Use a writing agent for documents and drafts.
• Use a research agent for collecting and summarizing material.
• Use a coding agent for code repositories or technical tasks.
• Keep related files in the same folder so the agent has better context.