> For the complete documentation index, see [llms.txt](https://wren.atriasafety.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wren.atriasafety.org/guides-and-faq/how-does-search-work.md).

# How Does Search Work?

Sometimes you will ask Wren a question that it just doesn't know the answer to. Maybe it is a question about today's news, or a very specific fact about a video game. That is where Wren's Search feature comes in!

## The Brave Search Engine

When Wren gets stuck, it uses the Brave Search engine to look up the answer on the internet.

{% hint style="success" %}
Brave Search is fast and private, meaning Wren can get you the information you need quickly without compromising your safety.
{% endhint %}

## What does Wren do with the results?

Wren doesn't just copy and paste a bunch of links for you to read. That would be boring! Instead, Wren acts like a research assistant.

1. Wren takes your question and turns it into a web search.
2. It reads the top websites that come back.
3. It takes all that information, summarizes it, and writes a friendly reply just for you.

You can even ask Wren to find specific things, like "Find me a recipe for chocolate chip cookies" or "What is the weather like in London today?" Wren will handle all the hard work!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wren.atriasafety.org/guides-and-faq/how-does-search-work.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
