Module: config

Builders in this module

Builder

Description

A2aAgentExecutorConfig

Configuration for the A2aAgentExecutor.

AgentConfig

The config for the YAML schema to create an agent.

BaseAgentConfig

The config for the YAML schema of a BaseAgent.

AgentRefConfig

The config for the reference to another agent.

ArgumentConfig

An argument passed to a function or a class’s constructor.

CodeConfig

Code reference config for a variable, a function, or a class.

ContextCacheConfig

Configuration for context caching across all agents in an app.

LlmAgentConfig

The config for the YAML schema of a LlmAgent.

LoopAgentConfig

The config for the YAML schema of a LoopAgent.

ParallelAgentConfig

The config for the YAML schema of a ParallelAgent.

RunConfig

Configs for runtime behavior of agents.

ToolThreadPoolConfig

Configuration for the tool thread pool executor.

SequentialAgentConfig

The config for the YAML schema of a SequentialAgent.

EventsCompactionConfig

The config of event compaction for an application.

ResumabilityConfig

The config of the resumability for an application.

FeatureConfig

Feature configuration.

AudioCacheConfig

Configuration for audio caching behavior.

SimplePromptOptimizerConfig

Configuration for the IterativePromptOptimizer.

BigQueryLoggerConfig

Configuration for the BigQueryAgentAnalyticsPlugin.

RetryConfig

Configuration for retrying failed BigQuery write operations.

GetSessionConfig

The configuration of getting a session.

BaseGoogleCredentialsConfig

Base Google Credentials Configuration for Google API tools (Experimental).

AgentSimulatorConfig

Configuration for AgentSimulator.

InjectionConfig

Injection configuration for a tool.

ToolSimulationConfig

Simulation configuration for a single tool.

AgentToolConfig

The config for the AgentTool.

BigQueryCredentialsConfig

BigQuery Credentials Configuration for Google API tools (Experimental).

BigQueryToolConfig

Configuration for BigQuery tools.

BigtableCredentialsConfig

Bigtable Credentials Configuration for Google API tools (Experimental).

DataAgentToolConfig

Configuration for Data Agent tools.

DataAgentCredentialsConfig

Data Agent Credentials Configuration for Google API tools.

ExampleToolConfig

Fluent builder for ExampleToolConfig.

McpToolsetConfig

The config for McpToolset.

PubSubToolConfig

Configuration for Pub/Sub tools.

PubSubCredentialsConfig

Pub/Sub Credentials Configuration for Google API tools (Experimental).

SpannerCredentialsConfig

Spanner Credentials Configuration for Google API tools (Experimental).

BaseToolConfig

The base class for all tool configs.

ToolArgsConfig

Config to host free key-value pairs for the args in ToolConfig.

ToolConfig

The configuration for a tool.

A2aAgentExecutorConfig

Fluent builder for google.adk.a2a.executor.a2a_agent_executor.A2aAgentExecutorConfig

Configuration for the A2aAgentExecutor.

Quick start:

from adk_fluent import A2aAgentExecutorConfig

result = (
    A2aAgentExecutorConfig()
    .build()
)

Control Flow & Execution

.build() -> A2aAgentExecutorConfig Control Flow & Execution

Resolve into a native ADK A2aAgentExecutorConfig.

Example:

config = A2aAgentExecutorConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.a2a_part_converter(value)

`Callable[[Part], Part

.gen_ai_part_converter(value)

`Callable[[Part], Part

.request_converter(value)

`Callable[[RequestContext, Callable[[Part], Part

.event_converter(value)

`Callable[[Event, InvocationContext, str


AgentConfig

Fluent builder for google.adk.agents.agent_config.AgentConfig

The config for the YAML schema to create an agent.

Quick start:

from adk_fluent import AgentConfig

result = (
    AgentConfig("root_value")
    .build()
)

Constructor

AgentConfig(root: RootModelRootType)

Argument

Type

root

RootModelRootType

Control Flow & Execution

.build() -> AgentConfig Control Flow & Execution

Resolve into a native ADK AgentConfig.

Example:

config = AgentConfig("config").build("...")

BaseAgentConfig

Fluent builder for google.adk.agents.base_agent_config.BaseAgentConfig

The config for the YAML schema of a BaseAgent.

Quick start:

from adk_fluent import BaseAgentConfig

result = (
    BaseAgentConfig("name_value")
    .describe("...")
    .build()
)

Constructor

BaseAgentConfig(name: str)

Argument

Type

name

str

Core Configuration

.describe(value: str) -> Self Core Configuration

  • Maps to: description

  • Set agent description (metadata for transfer routing and topology display — NOT sent to the LLM as instruction). Always set this on sub-agents so the coordinator LLM can pick the right specialist.

Example:

config = BaseAgentConfig("config").describe("...")

.sub_agent(value: AgentRefConfig) -> Self Core Configuration

Append to sub_agents (lazy — built at .build() time).

Example:

config = BaseAgentConfig("config").sub_agent("...")

Configuration

.after_agent_callback(value: CodeConfig) -> Self Configuration

Append to after_agent_callbacks (lazy — built at .build() time).

Example:

config = BaseAgentConfig("config").after_agent_callback(my_callback_fn)

.before_agent_callback(value: CodeConfig) -> Self Configuration

Append to before_agent_callbacks (lazy — built at .build() time).

Example:

config = BaseAgentConfig("config").before_agent_callback(my_callback_fn)

Control Flow & Execution

.build() -> BaseAgentConfig Control Flow & Execution

Resolve into a native ADK BaseAgentConfig.

Example:

config = BaseAgentConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.agent_class(value)

`Literal[‘BaseAgent’]

.sub_agents(value)

`list[AgentRefConfig]

.before_agent_callbacks(value)

`list[CodeConfig]

.after_agent_callbacks(value)

`list[CodeConfig]


AgentRefConfig

Fluent builder for google.adk.agents.common_configs.AgentRefConfig

The config for the reference to another agent.

Quick start:

from adk_fluent import AgentRefConfig

result = (
    AgentRefConfig()
    .build()
)

Control Flow & Execution

.build() -> AgentRefConfig Control Flow & Execution

Resolve into a native ADK AgentRefConfig.

Example:

config = AgentRefConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.config_path(value)

`str

.code(value)

`str


ArgumentConfig

Fluent builder for google.adk.agents.common_configs.ArgumentConfig

An argument passed to a function or a class’s constructor.

Quick start:

from adk_fluent import ArgumentConfig

result = (
    ArgumentConfig("value_value")
    .build()
)

Constructor

ArgumentConfig(value: Any)

Argument

Type

value

Any

Control Flow & Execution

.build() -> ArgumentConfig Control Flow & Execution

Resolve into a native ADK ArgumentConfig.

Example:

config = ArgumentConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.name(value)

`str


CodeConfig

Fluent builder for google.adk.agents.common_configs.CodeConfig

Code reference config for a variable, a function, or a class.

Quick start:

from adk_fluent import CodeConfig

result = (
    CodeConfig("name_value")
    .arg(...)
    .build()
)

Constructor

CodeConfig(name: str)

Argument

Type

name

str

Configuration

.arg(value: ArgumentConfig) -> Self Configuration

Append to args (lazy — built at .build() time).

Example:

config = CodeConfig("config").arg("...")

Control Flow & Execution

.build() -> CodeConfig Control Flow & Execution

Resolve into a native ADK CodeConfig.

Example:

config = CodeConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.args(value)

`list[ArgumentConfig]


ContextCacheConfig

Fluent builder for google.adk.agents.context_cache_config.ContextCacheConfig

Configuration for context caching across all agents in an app.

Quick start:

from adk_fluent import ContextCacheConfig

result = (
    ContextCacheConfig()
    .build()
)

Control Flow & Execution

.build() -> ContextCacheConfig Control Flow & Execution

Resolve into a native ADK ContextCacheConfig.

Example:

config = ContextCacheConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.cache_intervals(value)

int

.ttl_seconds(value)

int

.min_tokens(value)

int


LlmAgentConfig

Fluent builder for google.adk.agents.llm_agent_config.LlmAgentConfig

The config for the YAML schema of a LlmAgent.

Quick start:

from adk_fluent import LlmAgentConfig

result = (
    LlmAgentConfig("name_value", "instruction_value")
    .describe("...")
    .build()
)

Constructor

LlmAgentConfig(name: str, instruction: str)

Argument

Type

name

str

instruction

str

Core Configuration

.describe(value: str) -> Self Core Configuration

  • Maps to: description

  • Set agent description (metadata for transfer routing and topology display — NOT sent to the LLM as instruction). Always set this on sub-agents so the coordinator LLM can pick the right specialist.

Example:

config = LlmAgentConfig("config").describe("...")

.history(value: Literal['default', 'none']) -> Self Core Configuration

  • Maps to: include_contents

  • Optional. LlmAgent.include_contents.

Example:

config = LlmAgentConfig("config").history("none")

.instruct(value: str) -> Self Core Configuration

  • Maps to: instruction

  • Required. LlmAgent.instruction. Dynamic instructions with placeholder support. Behavior: if static_instruction is None, goes to system_instruction; if static_instruction is set, goes to user content after static content.

Example:

config = LlmAgentConfig("config").instruct("You are a helpful assistant.")

.outputs(value: str | None) -> Self Core Configuration

  • Maps to: output_key

  • Deprecated: use .writes(key) instead. Session state key where the agent’s response text is stored.

Example:

config = LlmAgentConfig("config").outputs("result_key")

.static(value: Content | str | File | Part | list[str | File | Part] | None) -> Self Core Configuration

  • Maps to: static_instruction

  • Set cached instruction. When set, .instruct() text moves from system to user content, enabling context caching. Use for large, stable prompt sections that rarely change.

Example:

config = LlmAgentConfig("config").static("You are a helpful assistant.")

.sub_agent(value: AgentRefConfig) -> Self Core Configuration

Append to sub_agents (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").sub_agent("...")

.tool(value: ToolConfig) -> Self Core Configuration

Append to tools (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").tool(my_function)

Configuration

.after_agent_callback(value: CodeConfig) -> Self Configuration

Append to after_agent_callbacks (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").after_agent_callback(my_callback_fn)

.after_model_callback(value: CodeConfig) -> Self Configuration

Append to after_model_callbacks (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").after_model_callback(my_callback_fn)

.after_tool_callback(value: CodeConfig) -> Self Configuration

Append to after_tool_callbacks (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").after_tool_callback(my_callback_fn)

.before_agent_callback(value: CodeConfig) -> Self Configuration

Append to before_agent_callbacks (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").before_agent_callback(my_callback_fn)

.before_model_callback(value: CodeConfig) -> Self Configuration

Append to before_model_callbacks (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").before_model_callback(my_callback_fn)

.before_tool_callback(value: CodeConfig) -> Self Configuration

Append to before_tool_callbacks (lazy — built at .build() time).

Example:

config = LlmAgentConfig("config").before_tool_callback(my_callback_fn)

.include_history(value: Literal['default', 'none']) -> Self Configuration

  • Maps to: include_contents

  • Optional. LlmAgent.include_contents.

Example:

config = LlmAgentConfig("config").include_history("none")

.static_instruct(value: Content | str | File | Part | list[str | File | Part] | None) -> Self Configuration

  • Maps to: static_instruction

  • Set cached instruction. When set, .instruct() text moves from system to user content, enabling context caching. Use for large, stable prompt sections that rarely change.

Example:

config = LlmAgentConfig("config").static_instruct("...")

Control Flow & Execution

.build() -> LlmAgentConfig Control Flow & Execution

Resolve into a native ADK LlmAgentConfig.

Example:

config = LlmAgentConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.agent_class(value)

str

.sub_agents(value)

`list[AgentRefConfig]

.before_agent_callbacks(value)

`list[CodeConfig]

.after_agent_callbacks(value)

`list[CodeConfig]

.model(value)

`str

.model_code(value)

`CodeConfig

.disallow_transfer_to_parent(value)

`bool

.disallow_transfer_to_peers(value)

`bool

.input_schema(value)

`CodeConfig

.output_schema(value)

`CodeConfig

.tools(value)

`list[ToolConfig]

.before_model_callbacks(value)

`list[CodeConfig]

.after_model_callbacks(value)

`list[CodeConfig]

.before_tool_callbacks(value)

`list[CodeConfig]

.after_tool_callbacks(value)

`list[CodeConfig]

.generate_content_config(value)

`GenerateContentConfig


LoopAgentConfig

Fluent builder for google.adk.agents.loop_agent_config.LoopAgentConfig

The config for the YAML schema of a LoopAgent.

Quick start:

from adk_fluent import LoopAgentConfig

result = (
    LoopAgentConfig("name_value")
    .describe("...")
    .build()
)

Constructor

LoopAgentConfig(name: str)

Argument

Type

name

str

Core Configuration

.describe(value: str) -> Self Core Configuration

  • Maps to: description

  • Set agent description (metadata for transfer routing and topology display — NOT sent to the LLM as instruction). Always set this on sub-agents so the coordinator LLM can pick the right specialist.

Example:

config = LoopAgentConfig("config").describe("...")

.sub_agent(value: AgentRefConfig) -> Self Core Configuration

Append to sub_agents (lazy — built at .build() time).

Example:

config = LoopAgentConfig("config").sub_agent("...")

Configuration

.after_agent_callback(value: CodeConfig) -> Self Configuration

Append to after_agent_callbacks (lazy — built at .build() time).

Example:

config = LoopAgentConfig("config").after_agent_callback(my_callback_fn)

.before_agent_callback(value: CodeConfig) -> Self Configuration

Append to before_agent_callbacks (lazy — built at .build() time).

Example:

config = LoopAgentConfig("config").before_agent_callback(my_callback_fn)

Control Flow & Execution

.build() -> LoopAgentConfig Control Flow & Execution

Resolve into a native ADK LoopAgentConfig.

Example:

config = LoopAgentConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.agent_class(value)

str

.sub_agents(value)

`list[AgentRefConfig]

.before_agent_callbacks(value)

`list[CodeConfig]

.after_agent_callbacks(value)

`list[CodeConfig]

.max_iterations(value)

`int


ParallelAgentConfig

Fluent builder for google.adk.agents.parallel_agent_config.ParallelAgentConfig

The config for the YAML schema of a ParallelAgent.

Quick start:

from adk_fluent import ParallelAgentConfig

result = (
    ParallelAgentConfig("name_value")
    .describe("...")
    .build()
)

Constructor

ParallelAgentConfig(name: str)

Argument

Type

name

str

Core Configuration

.describe(value: str) -> Self Core Configuration

  • Maps to: description

  • Set agent description (metadata for transfer routing and topology display — NOT sent to the LLM as instruction). Always set this on sub-agents so the coordinator LLM can pick the right specialist.

Example:

config = ParallelAgentConfig("config").describe("...")

.sub_agent(value: AgentRefConfig) -> Self Core Configuration

Append to sub_agents (lazy — built at .build() time).

Example:

config = ParallelAgentConfig("config").sub_agent("...")

Configuration

.after_agent_callback(value: CodeConfig) -> Self Configuration

Append to after_agent_callbacks (lazy — built at .build() time).

Example:

config = ParallelAgentConfig("config").after_agent_callback(my_callback_fn)

.before_agent_callback(value: CodeConfig) -> Self Configuration

Append to before_agent_callbacks (lazy — built at .build() time).

Example:

config = ParallelAgentConfig("config").before_agent_callback(my_callback_fn)

Control Flow & Execution

.build() -> ParallelAgentConfig Control Flow & Execution

Resolve into a native ADK ParallelAgentConfig.

Example:

config = ParallelAgentConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.agent_class(value)

str

.sub_agents(value)

`list[AgentRefConfig]

.before_agent_callbacks(value)

`list[CodeConfig]

.after_agent_callbacks(value)

`list[CodeConfig]


RunConfig

Fluent builder for google.adk.agents.run_config.RunConfig

Configs for runtime behavior of agents.

Quick start:

from adk_fluent import RunConfig

result = (
    RunConfig()
    .input_audio_transcribe("...")
    .build()
)

Configuration

.input_audio_transcribe(value: AudioTranscriptionConfig | None) -> Self Configuration

  • Maps to: input_audio_transcription

  • Set the input_audio_transcription field.

Example:

config = RunConfig("config").input_audio_transcribe("...")

.output_audio_transcribe(value: AudioTranscriptionConfig | None) -> Self Configuration

  • Maps to: output_audio_transcription

  • Set the output_audio_transcription field.

Example:

config = RunConfig("config").output_audio_transcribe("...")

Control Flow & Execution

.build() -> RunConfig Control Flow & Execution

Resolve into a native ADK RunConfig.

Example:

config = RunConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.speech_config(value)

`SpeechConfig

.response_modalities(value)

`list[str]

.save_input_blobs_as_artifacts(value)

bool

.support_cfc(value)

bool

.streaming_mode(value)

StreamingMode

.realtime_input_config(value)

`RealtimeInputConfig

.enable_affective_dialog(value)

`bool

.proactivity(value)

`ProactivityConfig

.session_resumption(value)

`SessionResumptionConfig

.context_window_compression(value)

`ContextWindowCompressionConfig

.save_live_blob(value)

bool

.tool_thread_pool_config(value)

`ToolThreadPoolConfig

.save_live_audio(value)

bool

.max_llm_calls(value)

int

.custom_metadata(value)

`dict[str, Any]


ToolThreadPoolConfig

Fluent builder for google.adk.agents.run_config.ToolThreadPoolConfig

Configuration for the tool thread pool executor.

Quick start:

from adk_fluent import ToolThreadPoolConfig

result = (
    ToolThreadPoolConfig()
    .build()
)

Control Flow & Execution

.build() -> ToolThreadPoolConfig Control Flow & Execution

Resolve into a native ADK ToolThreadPoolConfig.

Example:

config = ToolThreadPoolConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.max_workers(value)

int


SequentialAgentConfig

Fluent builder for google.adk.agents.sequential_agent_config.SequentialAgentConfig

The config for the YAML schema of a SequentialAgent.

Quick start:

from adk_fluent import SequentialAgentConfig

result = (
    SequentialAgentConfig("name_value")
    .describe("...")
    .build()
)

Constructor

SequentialAgentConfig(name: str)

Argument

Type

name

str

Core Configuration

.describe(value: str) -> Self Core Configuration

  • Maps to: description

  • Set agent description (metadata for transfer routing and topology display — NOT sent to the LLM as instruction). Always set this on sub-agents so the coordinator LLM can pick the right specialist.

Example:

config = SequentialAgentConfig("config").describe("...")

.sub_agent(value: AgentRefConfig) -> Self Core Configuration

Append to sub_agents (lazy — built at .build() time).

Example:

config = SequentialAgentConfig("config").sub_agent("...")

Configuration

.after_agent_callback(value: CodeConfig) -> Self Configuration

Append to after_agent_callbacks (lazy — built at .build() time).

Example:

config = SequentialAgentConfig("config").after_agent_callback(my_callback_fn)

.before_agent_callback(value: CodeConfig) -> Self Configuration

Append to before_agent_callbacks (lazy — built at .build() time).

Example:

config = SequentialAgentConfig("config").before_agent_callback(my_callback_fn)

Control Flow & Execution

.build() -> SequentialAgentConfig Control Flow & Execution

Resolve into a native ADK SequentialAgentConfig.

Example:

config = SequentialAgentConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.agent_class(value)

str

.sub_agents(value)

`list[AgentRefConfig]

.before_agent_callbacks(value)

`list[CodeConfig]

.after_agent_callbacks(value)

`list[CodeConfig]


EventsCompactionConfig

Fluent builder for google.adk.apps.app.EventsCompactionConfig

The config of event compaction for an application.

Quick start:

from adk_fluent import EventsCompactionConfig

result = (
    EventsCompactionConfig("compaction_interval_value", "overlap_size_value")
    .build()
)

Constructor

EventsCompactionConfig(compaction_interval: int, overlap_size: int)

Argument

Type

compaction_interval

int

overlap_size

int

Control Flow & Execution

.build() -> EventsCompactionConfig Control Flow & Execution

Resolve into a native ADK EventsCompactionConfig.

Example:

config = EventsCompactionConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.summarizer(value)

`BaseEventsSummarizer

.token_threshold(value)

`int

.event_retention_size(value)

`int


ResumabilityConfig

Fluent builder for google.adk.apps.app.ResumabilityConfig

The config of the resumability for an application.

Quick start:

from adk_fluent import ResumabilityConfig

result = (
    ResumabilityConfig()
    .build()
)

Control Flow & Execution

.build() -> ResumabilityConfig Control Flow & Execution

Resolve into a native ADK ResumabilityConfig.

Example:

config = ResumabilityConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.is_resumable(value)

bool


FeatureConfig

Fluent builder for google.adk.features._feature_registry.FeatureConfig

Feature configuration.

Quick start:

from adk_fluent import FeatureConfig

result = (
    FeatureConfig("stage_value")
    .build()
)

Constructor

FeatureConfig(stage: FeatureStage)

Argument

Type

stage

FeatureStage

Control Flow & Execution

.build() -> FeatureConfig Control Flow & Execution

Resolve into a native ADK FeatureConfig.

Example:

config = FeatureConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.default_on(value)

bool


AudioCacheConfig

Fluent builder for google.adk.flows.llm_flows.audio_cache_manager.AudioCacheConfig

Configuration for audio caching behavior.

Quick start:

from adk_fluent import AudioCacheConfig

result = (
    AudioCacheConfig()
    .build()
)

Control Flow & Execution

.build() -> AudioCacheConfig Control Flow & Execution

Resolve into a native ADK AudioCacheConfig.

Example:

config = AudioCacheConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.max_cache_size_bytes(value)

int

.max_cache_duration_seconds(value)

float

.auto_flush_threshold(value)

int


SimplePromptOptimizerConfig

Fluent builder for google.adk.optimization.simple_prompt_optimizer.SimplePromptOptimizerConfig

Configuration for the IterativePromptOptimizer.

Quick start:

from adk_fluent import SimplePromptOptimizerConfig

result = (
    SimplePromptOptimizerConfig()
    .model_configure("...")
    .build()
)

Configuration

.model_configure(value: GenerateContentConfig) -> Self Configuration

  • Maps to: model_configuration

  • The configuration for the optimizer model.

Example:

config = SimplePromptOptimizerConfig("config").model_configure("...")

Control Flow & Execution

.build() -> SimplePromptOptimizerConfig Control Flow & Execution

Resolve into a native ADK SimplePromptOptimizerConfig.

Example:

config = SimplePromptOptimizerConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.optimizer_model(value)

str

.num_iterations(value)

int

.batch_size(value)

int


BigQueryLoggerConfig

Fluent builder for google.adk.plugins.bigquery_agent_analytics_plugin.BigQueryLoggerConfig

Configuration for the BigQueryAgentAnalyticsPlugin.

Quick start:

from adk_fluent import BigQueryLoggerConfig

result = (
    BigQueryLoggerConfig()
    .build()
)

Control Flow & Execution

.build() -> BigQueryLoggerConfig Control Flow & Execution

Resolve into a native ADK BigQueryLoggerConfig.

Example:

config = BigQueryLoggerConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.enabled(value)

bool

.event_allowlist(value)

`list[str]

.event_denylist(value)

`list[str]

.max_content_length(value)

int

.table_id(value)

str

.clustering_fields(value)

list[str]

.log_multi_modal_content(value)

bool

.retry_config(value)

RetryConfig

.batch_size(value)

int

.batch_flush_interval(value)

float

.shutdown_timeout(value)

float

.queue_max_size(value)

int

.content_formatter(value)

`Callable[[Any, str], Any]

.gcs_bucket_name(value)

`str

.connection_id(value)

`str

.log_session_metadata(value)

bool

.custom_tags(value)

dict[str, Any]


RetryConfig

Fluent builder for google.adk.plugins.bigquery_agent_analytics_plugin.RetryConfig

Configuration for retrying failed BigQuery write operations.

Quick start:

from adk_fluent import RetryConfig

result = (
    RetryConfig()
    .build()
)

Control Flow & Execution

.build() -> RetryConfig Control Flow & Execution

Resolve into a native ADK RetryConfig.

Example:

config = RetryConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.max_retries(value)

int

.initial_delay(value)

float

.multiplier(value)

float

.max_delay(value)

float


GetSessionConfig

Fluent builder for google.adk.sessions.base_session_service.GetSessionConfig

The configuration of getting a session.

Quick start:

from adk_fluent import GetSessionConfig

result = (
    GetSessionConfig()
    .build()
)

Control Flow & Execution

.build() -> GetSessionConfig Control Flow & Execution

Resolve into a native ADK GetSessionConfig.

Example:

config = GetSessionConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.num_recent_events(value)

`int

.after_timestamp(value)

`float


BaseGoogleCredentialsConfig

Fluent builder for google.adk.tools._google_credentials.BaseGoogleCredentialsConfig

Base Google Credentials Configuration for Google API tools (Experimental).

Quick start:

from adk_fluent import BaseGoogleCredentialsConfig

result = (
    BaseGoogleCredentialsConfig()
    .build()
)

Control Flow & Execution

.build() -> BaseGoogleCredentialsConfig Control Flow & Execution

Resolve into a native ADK BaseGoogleCredentialsConfig.

Example:

config = BaseGoogleCredentialsConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.credentials(value)

`Credentials

.external_access_token_key(value)

`str

.client_id(value)

`str

.client_secret(value)

`str

.scopes(value)

`list[str]


AgentSimulatorConfig

Fluent builder for google.adk.tools.agent_simulator.agent_simulator_config.AgentSimulatorConfig

Configuration for AgentSimulator.

Quick start:

from adk_fluent import AgentSimulatorConfig

result = (
    AgentSimulatorConfig()
    .simulation_model_configure("...")
    .build()
)

Configuration

.simulation_model_configure(value: GenerateContentConfig) -> Self Configuration

  • Maps to: simulation_model_configuration

  • Set the simulation_model_configuration field.

Example:

config = AgentSimulatorConfig("config").simulation_model_configure("...")

.tool_simulation_config(value: ToolSimulationConfig) -> Self Configuration

Append to tool_simulation_configs (lazy — built at .build() time).

Example:

config = AgentSimulatorConfig("config").tool_simulation_config("...")

Control Flow & Execution

.build() -> AgentSimulatorConfig Control Flow & Execution

Resolve into a native ADK AgentSimulatorConfig.

Example:

config = AgentSimulatorConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_simulation_configs(value)

list[ToolSimulationConfig]

.simulation_model(value)

str

.tracing_path(value)

`str

.environment_data(value)

`str


InjectionConfig

Fluent builder for google.adk.tools.agent_simulator.agent_simulator_config.InjectionConfig

Injection configuration for a tool.

Quick start:

from adk_fluent import InjectionConfig

result = (
    InjectionConfig()
    .build()
)

Control Flow & Execution

.build() -> InjectionConfig Control Flow & Execution

Resolve into a native ADK InjectionConfig.

Example:

config = InjectionConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.injection_probability(value)

float

.match_args(value)

`dict[str, Any]

.injected_latency_seconds(value)

float

.random_seed(value)

`int

.injected_error(value)

`InjectedError

.injected_response(value)

`dict[str, Any]


ToolSimulationConfig

Fluent builder for google.adk.tools.agent_simulator.agent_simulator_config.ToolSimulationConfig

Simulation configuration for a single tool.

Quick start:

from adk_fluent import ToolSimulationConfig

result = (
    ToolSimulationConfig("tool_name_value")
    .injection_config(...)
    .build()
)

Constructor

ToolSimulationConfig(tool_name: str)

Argument

Type

tool_name

str

Configuration

.injection_config(value: InjectionConfig) -> Self Configuration

Append to injection_configs (lazy — built at .build() time).

Example:

config = ToolSimulationConfig("config").injection_config("...")

Control Flow & Execution

.build() -> ToolSimulationConfig Control Flow & Execution

Resolve into a native ADK ToolSimulationConfig.

Example:

config = ToolSimulationConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.injection_configs(value)

list[InjectionConfig]

.mock_strategy_type(value)

MockStrategy


AgentToolConfig

Fluent builder for google.adk.tools.agent_tool.AgentToolConfig

The config for the AgentTool.

Quick start:

from adk_fluent import AgentToolConfig

result = (
    AgentToolConfig("agent_value")
    .skip_summarizate("...")
    .build()
)

Constructor

AgentToolConfig(agent: AgentRefConfig)

Argument

Type

agent

AgentRefConfig

Configuration

.skip_summarizate(value: bool) -> Self Configuration

  • Maps to: skip_summarization

  • Set the skip_summarization field.

Example:

config = AgentToolConfig("config").skip_summarizate("...")

Control Flow & Execution

.build() -> AgentToolConfig Control Flow & Execution

Resolve into a native ADK AgentToolConfig.

Example:

config = AgentToolConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.include_plugins(value)

bool


BigQueryCredentialsConfig

Fluent builder for google.adk.tools.bigquery.bigquery_credentials.BigQueryCredentialsConfig

BigQuery Credentials Configuration for Google API tools (Experimental).

Quick start:

from adk_fluent import BigQueryCredentialsConfig

result = (
    BigQueryCredentialsConfig()
    .build()
)

Control Flow & Execution

.build() -> BigQueryCredentialsConfig Control Flow & Execution

Resolve into a native ADK BigQueryCredentialsConfig.

Example:

config = BigQueryCredentialsConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.credentials(value)

`Credentials

.external_access_token_key(value)

`str

.client_id(value)

`str

.client_secret(value)

`str

.scopes(value)

`list[str]


BigQueryToolConfig

Fluent builder for google.adk.tools.bigquery.config.BigQueryToolConfig

Configuration for BigQuery tools.

Quick start:

from adk_fluent import BigQueryToolConfig

result = (
    BigQueryToolConfig()
    .locate("...")
    .build()
)

Configuration

.locate(value: str | None) -> Self Configuration

  • Maps to: location

  • Set the location field.

Example:

config = BigQueryToolConfig("config").locate("...")

Control Flow & Execution

.build() -> BigQueryToolConfig Control Flow & Execution

Resolve into a native ADK BigQueryToolConfig.

Example:

config = BigQueryToolConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.write_mode(value)

WriteMode

.maximum_bytes_billed(value)

`int

.max_query_result_rows(value)

int

.application_name(value)

`str

.compute_project_id(value)

`str

.job_labels(value)

`dict[str, str]


BigtableCredentialsConfig

Fluent builder for google.adk.tools.bigtable.bigtable_credentials.BigtableCredentialsConfig

Bigtable Credentials Configuration for Google API tools (Experimental).

Quick start:

from adk_fluent import BigtableCredentialsConfig

result = (
    BigtableCredentialsConfig()
    .build()
)

Control Flow & Execution

.build() -> BigtableCredentialsConfig Control Flow & Execution

Resolve into a native ADK BigtableCredentialsConfig.

Example:

config = BigtableCredentialsConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.credentials(value)

`Credentials

.external_access_token_key(value)

`str

.client_id(value)

`str

.client_secret(value)

`str

.scopes(value)

`list[str]


DataAgentToolConfig

Fluent builder for google.adk.tools.data_agent.config.DataAgentToolConfig

Configuration for Data Agent tools.

Quick start:

from adk_fluent import DataAgentToolConfig

result = (
    DataAgentToolConfig()
    .build()
)

Control Flow & Execution

.build() -> DataAgentToolConfig Control Flow & Execution

Resolve into a native ADK DataAgentToolConfig.

Example:

config = DataAgentToolConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.max_query_result_rows(value)

int


DataAgentCredentialsConfig

Fluent builder for google.adk.tools.data_agent.credentials.DataAgentCredentialsConfig

Data Agent Credentials Configuration for Google API tools.

Quick start:

from adk_fluent import DataAgentCredentialsConfig

result = (
    DataAgentCredentialsConfig()
    .build()
)

Control Flow & Execution

.build() -> DataAgentCredentialsConfig Control Flow & Execution

Resolve into a native ADK DataAgentCredentialsConfig.

Example:

config = DataAgentCredentialsConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.credentials(value)

`Credentials

.external_access_token_key(value)

`str

.client_id(value)

`str

.client_secret(value)

`str

.scopes(value)

`list[str]


ExampleToolConfig

Fluent builder for google.adk.tools.example_tool.ExampleToolConfig

Fluent builder for ExampleToolConfig.

Quick start:

from adk_fluent import ExampleToolConfig

result = (
    ExampleToolConfig("examples_value")
    .build()
)

Constructor

ExampleToolConfig(examples: list[Example] | str)

Argument

Type

examples

`list[Example]

Control Flow & Execution

.build() -> ExampleToolConfig Control Flow & Execution

Resolve into a native ADK ExampleToolConfig.

Example:

config = ExampleToolConfig("config").build("...")

McpToolsetConfig

Fluent builder for google.adk.tools.mcp_tool.mcp_toolset.McpToolsetConfig

The config for McpToolset.

Quick start:

from adk_fluent import McpToolsetConfig

result = (
    McpToolsetConfig()
    .build()
)

Control Flow & Execution

.build() -> McpToolsetConfig Control Flow & Execution

Resolve into a native ADK McpToolsetConfig.

Example:

config = McpToolsetConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.stdio_server_params(value)

`StdioServerParameters

.stdio_connection_params(value)

`StdioConnectionParams

.sse_connection_params(value)

`SseConnectionParams

.streamable_http_connection_params(value)

`StreamableHTTPConnectionParams

.tool_filter(value)

`list[str]

.tool_name_prefix(value)

`str

.auth_scheme(value)

`APIKey

.auth_credential(value)

`AuthCredential

.use_mcp_resources(value)

bool


PubSubToolConfig

Fluent builder for google.adk.tools.pubsub.config.PubSubToolConfig

Configuration for Pub/Sub tools.

Quick start:

from adk_fluent import PubSubToolConfig

result = (
    PubSubToolConfig()
    .build()
)

Control Flow & Execution

.build() -> PubSubToolConfig Control Flow & Execution

Resolve into a native ADK PubSubToolConfig.

Example:

config = PubSubToolConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.project_id(value)

`str


PubSubCredentialsConfig

Fluent builder for google.adk.tools.pubsub.pubsub_credentials.PubSubCredentialsConfig

Pub/Sub Credentials Configuration for Google API tools (Experimental).

Quick start:

from adk_fluent import PubSubCredentialsConfig

result = (
    PubSubCredentialsConfig()
    .build()
)

Control Flow & Execution

.build() -> PubSubCredentialsConfig Control Flow & Execution

Resolve into a native ADK PubSubCredentialsConfig.

Example:

config = PubSubCredentialsConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.credentials(value)

`Credentials

.external_access_token_key(value)

`str

.client_id(value)

`str

.client_secret(value)

`str

.scopes(value)

`list[str]


SpannerCredentialsConfig

Fluent builder for google.adk.tools.spanner.spanner_credentials.SpannerCredentialsConfig

Spanner Credentials Configuration for Google API tools (Experimental).

Quick start:

from adk_fluent import SpannerCredentialsConfig

result = (
    SpannerCredentialsConfig()
    .build()
)

Control Flow & Execution

.build() -> SpannerCredentialsConfig Control Flow & Execution

Resolve into a native ADK SpannerCredentialsConfig.

Example:

config = SpannerCredentialsConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.credentials(value)

`Credentials

.external_access_token_key(value)

`str

.client_id(value)

`str

.client_secret(value)

`str

.scopes(value)

`list[str]


BaseToolConfig

Fluent builder for google.adk.tools.tool_configs.BaseToolConfig

The base class for all tool configs.

Quick start:

from adk_fluent import BaseToolConfig

result = (
    BaseToolConfig()
    .build()
)

Control Flow & Execution

.build() -> BaseToolConfig Control Flow & Execution

Resolve into a native ADK BaseToolConfig.

Example:

config = BaseToolConfig("config").build("...")

ToolArgsConfig

Fluent builder for google.adk.tools.tool_configs.ToolArgsConfig

Config to host free key-value pairs for the args in ToolConfig.

Quick start:

from adk_fluent import ToolArgsConfig

result = (
    ToolArgsConfig()
    .build()
)

Control Flow & Execution

.build() -> ToolArgsConfig Control Flow & Execution

Resolve into a native ADK ToolArgsConfig.

Example:

config = ToolArgsConfig("config").build("...")

ToolConfig

Fluent builder for google.adk.tools.tool_configs.ToolConfig

The configuration for a tool.

Quick start:

from adk_fluent import ToolConfig

result = (
    ToolConfig("name_value")
    .build()
)

Constructor

ToolConfig(name: str)

Argument

Type

name

str

Control Flow & Execution

.build() -> ToolConfig Control Flow & Execution

Resolve into a native ADK ToolConfig.

Example:

config = ToolConfig("config").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.args(value)

`ToolArgsConfig