Early accessGnani Evon v3.5 is now available as an API to early access registrants.
Answer questions that need up-to-date information, and show where each fact came from. The built-in web search tool runs the searches for you; your code only adds the tool, then turns the [n] citations into links.
When to use this
- Users ask about things that change: weather, prices, schedules, recent news.
- You need to show sources next to the answer.
- You do not want to run your own search or retrieval pipeline.
Ask a question
How it works
- You add
{"type": "web_search"}totools. You do not write a search function. - The model decides whether it needs to search. For a question it can answer on its own, it may not search at all.
- The service runs the searches and gives the results to the model, which writes the answer with numbered citations.
message.web_searchlists thequeriesand thesources. Each source’sidis the number cited as[id].
Options
Turn citations into links
Turn citations into links
Replace each
[n] with a Markdown link to the source with that id. Unknown numbers are left as they are.Show search progress while streaming
Show search progress while streaming
With See Web search for every
"stream": true, chunks with delta.web_search report each search before the answer streams in delta.content:status value.Combine with your own functions
Combine with your own functions
You can send your own function tools in the same request. If the model calls one, you get
tool_calls back and run it as in Tool calling. Do not name your functions web_search or search.Gotchas
- A failed search does not fail the request. The model answers from what it knows and says live search was not available. Check whether
sourcesis empty before you show a “Sources” list. - Searched answers use more tokens.
usageincludes the search results the model read, and counts toward your daily token quota. tool_choicemust beautoornonewhen you sendweb_search.noneturns search off for the request.- Search results are screened by the safety filters. A result that fails the check is dropped.
Related
Web search
The web search tool, response fields and streaming events.
Tool calling
Add your own functions next to web search.
Streaming
Stream the answer as it is written.
Limits
Daily search and token limits.