Web & browser
Read the open web and, under governance, act in a web application. Search to find, fetch to read, and a real browser only when a page has to be driven.
| Tool | What it does |
|---|---|
web_search | Searches the web and returns titles, URLs and snippets. |
web_fetch | Reads a URL. |
browser_use | Drives a headless browser: navigate and extract read a page; click, type, submit and download act on it. |
web_search
Searches the web and returns titles, URLs and snippets. Use it to find sources for anything current, then read the ones that matter with web_fetch.
How an agent gets it. Declare it in the agent's tools: list.
- Needs a search provider configured for the organisation under Admin โ Web Search; without one it answers web_search is not configured.
depth: "thorough"runs a deeper, costlier search โ for niche or very recent topics. The default isfast.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
query | string | yes | |
depth | one of fast, thorough |
web_fetch
Reads a URL. A web page comes back as its main text, with navigation and boilerplate removed, plus its title, publication date and source; a PDF comes back as text with [page N] markers.
How an agent gets it. Declare it in the agent's tools: list. Needs outbound web access in the deployment (tools_web_enabled); without it the tool answers that it is disabled.
- Long documents come back in sections: the reply says which characters you have and the
offsetto pass to read on. - Fetched images and PDFs are also saved as run artifacts and placed in
/workfor a latercode_executioncall. - A page's list of images ("Images on this page") is how the Document Author finds a company's real logo.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
url | string | yes | |
offset | integer | Character offset to start reading from (default 0). | |
max_chars | integer | How many characters to return in this call. |
browser_use
Drives a headless browser: navigate and extract read a page; click, type, submit and download act on it.
How an agent gets it. Declare it in the agent's tools: list.
- Which sites it may reach is decided by the
browser_egresspolicy, which is deny by default. - Every write action pauses for approval before it happens; extracted text is DLP-screened; every session is recorded as an artifact.
- See Browser actions and the IT Fulfilment agent, its first user.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
op | one of navigate, extract, click, type, submit, download | yes | |
url | string | yes | Target URL (required for the op). |
target | string | Selector/label for click/type. | |
value | string | Text to type. | |
destructive | boolean |