Skip to main content
Released: September 8, 2026 Agent turns a question into a multi-step research loop: it plans its own searches, follows up on what it finds, and keeps going until it has enough to answer, rather than the single grounding search Answer makes. Because that loop can take a while, a run is asynchronous: create it, then poll or wait for it to finish.

Highlights

  • Multi-step research — Plans its own searches and follows up on what it finds, instead of grounding in a single search.
  • Cited outputoutput.text is a cited Markdown report, with inline [n] markers pointing at output.sources.
  • Optional structured output — Pass output_schema to also get output.structured, a JSON result shaped by your schema, plus output.grounding for field-level citations.
  • Async by designcreate returns at once with the run in pending state; poll get yourself, or let wait / createAndWait do it for you.
  • Best-effort cancellationcancel requests that a run stop; a run close to finishing can still complete before cancellation takes effect.

Quick Start

Concepts

The run lifecycle, output shapes, and citations

Quickstart

Make your first request