Skip to content

Web agents

Give agents a browser you can watch and control from the dashboard.

A web agent runs a browser in your cluster. Watch it in the dashboard, control it yourself, or let an agent use it through Playwright MCP. Open Agents → Web Agents.

Beta
Web agents are in beta. The create button requires an operator with web-agent support.

What a web agent is

  • Live browser: watch or control it with your mouse and keyboard.
  • MCP tools: let agents navigate, click, type, and read pages.
  • Optional coding agent: runs beside the browser and connects automatically.

Create one

Click New web agent. Choose a deployment, enter a DNS-style name, and optionally set a start URL. Set viewport size and stream quality on the resource.

Start an agent session

Enable the embedded agent and choose its runtime, provider and model, LLM gateway, skills, extra MCP servers, memories, and resource limits. It connects to the browser automatically. Disable it to use only the browser.

Agent changes restart the browser
Enabling, editing, or disabling the agent restarts the pod. Stream and MCP URLs stay the same.

Use the browser

A web agent's live browser stream beside the embedded agent chat
The live browser on the left, the agent session on the right.

Enter a task in chat and watch the agent use the browser beside it. Each browser tool call appears in the audit log.

Automations

Choose Save as automation to keep a prompt with a name and description. Run it again from Automations in a live session.

Choose web agents when creating or editing a standalone agent, or add them in YAML:

agent.yaml· yaml
1spec:
2 webAgentRefs:
3 - name: checkout-browser

This lets several agents share a browser or use it only when needed.

Restart & delete

  • Restart: replace the browser pod. Stream and MCP URLs stay the same.
  • Delete: remove the resource, pod, and Service.
  • Force delete: also clear the dashboard record when the deployment is offline.
webagent.yaml· yaml
1apiVersion: autonomic.sh/v1alpha1
2kind: WebAgent
3metadata:
4 name: checkout-browser
5 namespace: adaptive
6spec:
7 url: https://example.com
8 width: 1440
9 height: 900
10 quality: 70
11 agent:
12 enabled: true
13 runtime: ClaudeCode
14 model: claude-opus-4-8
Who can use it
Viewing needs webagents:read; creating and managing needs webagents:write; using it needs webagents:invoke. Ownership and grants in Access determine who can reach it. Remove any broad sharing grant before restricting it to named users, teams, or roles.