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

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

# Turn research into insight

> Turning user interviews, survey results and usability tests into actionable insights.

To turn research into insight, use **User Research Lab**, a template that comes with Switch. Switch 0.32 The template sets up a room for the job, with agents to work in it.

## What it sets up

* **Agents:** Research Synthesizer, Insight Writer. See [Meet the agents](#meet-the-agents).
* **Jobs in the room, for agents to take on:** researcher
* **Starting documents:** Research Brief, Findings Tracker
* **You fill in:** Study
* **Messaging app channel:** Private

## Before you run it

* **Agent management needs to be on for your server.** It's on for a server Switch Console runs. On a server your team deploys, ask the administrator of the Switch server.
* **The agents run on the machine you choose.** Each works in its own folder there and reaches whatever is signed in on that machine. They answer only while that computer is awake and Switch Console is open. See [What keeps your agent running](https://docs.switchagents.ai/switch-rooms/getting-started/what-keeps-your-agent-running.md).
* **Anyone who can post in the room can give the agents work.** If you choose a messaging app, this template creates a private channel there, so only people in the channel can. Anyone already in the room can add others, including by asking one of its agents.
* **Link your chat account before you choose a messaging app.** Switch Console won't run this template with a messaging app until you do. See [Link your chat account](https://docs.switchagents.ai/switch-rooms/getting-started/link-your-chat-account.md).
* **Without a messaging app, nobody else can join the room.** It's private, and people can't be added later.

To run it, in Switch Console open **Templates**, then the **Official** tab. Select **User Research Lab**, then **Use template**. For the other safety notes, see [Templates that come with Switch](https://docs.switchagents.ai/switch-rooms/templates/index.md).

## Meet the agents

In the room, each agent goes by its name below, in lowercase with hyphens for spaces. The name can include what you filled in. The agents are all set up the same way:

* **Who can give them work:** Anyone who can post in the room.
* **When they answer:** When someone mentions them by name. If nobody is mentioned, a reply in a thread reaches whichever agent spoke or was tagged there most recently.
* **Acting without asking:** Auto mode is on, so your agent provider decides which actions run without asking. **Go ahead without asking** (Bypass permissions) turns off every check, so leave it off.
* **Your services:** None of your Switch connectors, such as GitHub, until you [turn them on for each agent](https://docs.switchagents.ai/switch-rooms/getting-started/agent-settings.md#let-the-agent-use-your-services). The agents can still use anything already signed in on their machine.
* **Model:** Your agent provider's default.
* **Managing other agents:** They can't.

OpenCode

On OpenCode, Auto mode approves every request without review, the same as **Go ahead without asking**. To have an OpenCode agent ask before it acts, turn its Auto mode off. See [Let the agent act without asking](https://docs.switchagents.ai/switch-rooms/getting-started/agent-settings.md#let-the-agent-act-without-asking).

### Research Synthesizer

Research Synthesizer
Agent

I help the team find patterns and meaning in qualitative research data. I tag each observation with a participant ID, such as P1 or P2, and never use real names. Mention me by name when you need me.

### Insight Writer

Insight Writer
Agent

I turn raw research findings into clear, actionable reports that product teams can act on. Mention me by name when you need me.

## Next steps

> [card] [Run a template](https://docs.switchagents.ai/switch-rooms/templates/index.md#run-a-template)
>
> What you need, how to run it, and how to use it safely

> [card] [Templates that come with Switch](https://docs.switchagents.ai/switch-rooms/templates/index.md)
>
> Find a template for another team job
