AGENTS.md. It holds:
- Agents, including the agents in its subfolders.
- Instructions that load only when someone asks in that folder. This is where folder routing rules go.
- Files that every question in the folder can use.
- Evals that test the folder’s routing and answers.
Before you start
- You can create folders. You need to be able to create agents or manage connections, or have manage access to at least one agent. Whoever creates a folder can manage it.
- You can manage the agents you move. Moving an agent needs manage access to the agent and to both folders.
- You have two or more agents that the same team asks about.
Step 1: Create a folder
- Open Agents.
- In the Agents section header, click New folder.
- Name it Analytics and confirm.
The Instructions tree has its own folders for organizing instructions. Those only change how the list looks. They don’t group agents and they don’t affect routing. Agent folders are the ones in the Agents section, with Folder settings and Share buttons.
Step 2: Move agents into the folder
Drag Music Store onto the Analytics folder, or open the agent’s menu and choose Move agent. Do the same for Financial Market Agent. An agent sits in one folder at a time. Instructions, files and evals can be attached to several folders.Step 3: Add a folder routing rule
A folder rule loads in every question asked in that folder, before BOW picks an agent. That makes it the place for routing rules that only apply to this team.- Select the Analytics folder.
- Under Instructions, click + Add.
-
Name it Analytics routing and write one rule per line:
- Questions about customers, invoices, sales, revenue, tracks, artists, genres or employees → use the Music Store agent.
- Questions about stock prices, gold, bitcoin, GDP, country economics or bank failures → use the Financial Market Agent.
- If a question about ‘countries’ doesn’t say which, default to Music Store sales by country.
- Check the settings under Details. A new folder instruction starts as Active and Always, and the scope shows the Analytics folder. Keep all three.
- Click Create.
Attaching a global instruction to a folder makes it a folder instruction. It no longer loads everywhere. Keep rules that apply to every team in a separate global instruction.
Step 4: Ask in the folder
- Start a New report.
- Click the agent selector. Below Auto you see your folders, with their agents nested under them. Search with Search agents and folders….
- Click Analytics. The selector now shows the folder’s name.
-
Ask:
Top 10 countries
How did gold do vs bitcoin last year?
Which contracts renew next quarter?The first goes to the Financial Market Agent. For the second, BOW doesn’t leave the folder to find Contract Desk. It asks a clarifying question instead. You can pick more than one folder. BOW then chooses among all their agents, and each folder’s rules load. The selector shows the first folder and +N.
Step 5: Add folder files and evals (optional)
- Files. Under Files, click + Upload files. Every question asked in the folder can read them. Use this for a team glossary or a metric definitions sheet.
- Evals. Under Evals, choose New suite and add cases with Add case. A case such as Top 10 countries → Music Store catches routing regressions when someone edits the rule. See Test an agent with evals.
- Training. Folder managers see a Training button on the folder. In a Training conversation started there, BOW can save routing rules and evals to the folder instead of to one agent. See Train an agent.
Step 6: Share the folder
Click Share on the folder and add people or groups:- Can query. They can ask in the folder, and they can query every agent inside it.
- Can manage. They can also edit the folder, its instructions, files and evals, and share it.
What loads in a folder question
Where else folders work
Tips
- One folder per team or domain. Put agents that overlap in the same folder, and give the folder one routing instruction.
- Keep cross-team rules global. A folder rule should only cover choices inside the folder. Don’t repeat a global rule in the folder, and don’t contradict it.
- Name agents exactly. Write rules as “topic → agent” with the agent name as it appears in Agents.
- Give every ambiguous word a default. “Countries”, “revenue” and “customers” are common overlaps.
- Test in a new report with the folder picked. Ask the same short question twice. If BOW picks different agents, add a default for it.
