flights_search()

Create a Google Flights tool for one-way and round-trip routes.

Usage

Source

flights_search(
    *,
    provider="auto",
    include_examples=True,
    api_key=None,
    client=None,
    default_params=None,
    timeout=None,
    mode=SearchResultMode.COMPACT,
    response_format=SearchResultFormat.MARKDOWN,
    result_limit=10,
    name="flights_search"
)

The returned tool requires departure, arrival, and outbound date fields. Adding return_date selects a round trip. Cabin class and passenger counts are semantic typed fields; no synthetic q field is exposed.

Parameters

provider: ProviderName | str = "auto"

Agent SDK adapter name, "auto", or "function".

include_examples: bool = True

Add a short call example to the model-facing description.

api_key: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

client: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

default_params: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

timeout: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

mode: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

response_format: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

result_limit: int | None = 10

Maximum items kept in each result list in both response modes; use None to keep all returned results.

name: str = "flights_search"

Tool name presented to the model.

Returns

Any

A provider-native Google Flights route-search tool.