Docs › Agent › Tools › Web search and reading pages

Web search and reading pages

How the agent searches the web and reads a page, what asks first, and how to turn either off.

On this page

The agent can look things up that your code cannot tell it: whether a library's API has changed, a version's release notes, an error message from a dependency, current documentation. Two tools do this, and each has its own switch.

web_search returns ranked results: each page's title, address, date and an extract. The agent can limit a search to particular sites or to recent pages, and it cites the address of any result it relies on.

Reading a page

web_fetch reads one page as plain text, with scripts and styles removed. It is for documentation and references, not for your running app: for that, see Browser tools.

What it is told about web content

Search results and fetched pages are other people's text. They reach the agent fenced and labelled as data, never as instructions, so a page that tells it to do something is something to mention to you, not to act on. Anything it decides to do afterwards still goes through your approvals.

Settings

SettingDefaultWhat it does
astracode.agent.webSearchonLet the agent search the web, in Agent, Plan and Ask.
astracode.agent.webFetchonLet the agent read a page as text, in Agent and Plan.

If something goes wrong

← Running commands Browser tools →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference