Add both for the best behaviour: the tool gives the capability, the skill gives the judgement. The tool works on its own, but the skill makes the agent read the right pages, size its reads, and relay failures plainly.
Add it to an agent
- Open your agent → Capabilities → Add capability.
- Pick Web Reader (category Search). The server URL is pre-filled; nothing to type.
- (Recommended) Add Web Reader (skill) as well.
Approving a new website
The first time the agent wants to read a website in a conversation, the chat pauses on an approval card that names the website and shows the full address the agent is about to open. Nothing is read before you answer.- Approve: the page is read and the agent picks up. That website is not asked again for the rest of the conversation.
- Reject: the agent is told you said no and continues without the page.
Why the approval. A page the agent reads may contain hidden instructions written for the model. Without approval, such a page could get the agent to open
https://some-site.example/?d=<text from your conversation> and leak that text to a website without any action from you. The approval puts you between the agent and every new website.The tools
web_read
web_read_many
Each page is read independently: a page that fails comes back with its reason while the others keep their content.
A successful read returns the page as Markdown with a citation of the address actually read, after redirects. A long page is cut at
max_chars, and the text says so at the end. A result longer than about 30,000 characters is moved out of the conversation into a paginated artifact, as for any tool.
What it can and cannot read
- Web pages, plain text, JSON and XML. HTML is converted to Markdown: headings, lists, tables, code blocks and links are kept, and navigation, footers and hidden text are dropped.
- No JavaScript. A page that builds itself in the browser comes back empty, and the agent says so instead of inventing content.
- No documents. A PDF, an image or an Office file behind a URL is refused. Attach the file to the conversation instead, where it is parsed and indexed.
- Public websites only. Internal and private network addresses, cloud metadata endpoints and the platform’s own API are always refused, whatever the configuration. Each redirect is checked against the same rules before it is followed.
- Bounded requests. Each request stops after 15 seconds without data, and a response larger than 5 MB is not downloaded.
Page content is treated as data
Everything a page returns was written by whoever runs that website. The tool puts a warning first, then the page between two markers the page cannot know in advance or fake, and the skill tells the agent never to follow instructions found in a page. This narrows the risk of prompt injection; it does not remove it. Keep the approval of each new website, and do not give an agent that reads the web tools that act without approval.For administrators
The tool’s settings live in the configuration of the Web Reader workspace (tools-web-reader) and apply to every agent that uses it:
A textual check cannot detect a public name that resolves to a private address. If your platform runs in a private network, also restrict the runtime’s outbound traffic at the network level.
Errors
The tool tells the agent what happened, and the skill has it relay the reason rather than guess at the content:Next Steps
Capabilities
Add and configure the other capabilities of your agent
Tool permissions
Hold other tool calls for human approval