Module: plugin

Builders in this module

Builder	Description
RecordingsPlugin	Plugin for recording ADK agent interactions.
ReplayPlugin	Plugin for replaying ADK agent interactions from recordings.
BasePlugin	Base class for creating plugins.
BigQueryAgentAnalyticsPlugin	BigQuery Agent Analytics Plugin (v2.
ContextFilterPlugin	A plugin that filters the LLM context to reduce its size.
DebugLoggingPlugin	A plugin that captures complete debug information to a file.
GlobalInstructionPlugin	Plugin that provides global instructions functionality at the App level.
LoggingPlugin	A plugin that logs important information at each callback point.
MultimodalToolResultsPlugin	A plugin that modifies function tool responses to support returning list of parts directly.
ReflectAndRetryToolPlugin	Provides self-healing, concurrent-safe error recovery for tool failures.
SaveFilesAsArtifactsPlugin	A plugin that saves files embedded in user messages as artifacts.
AgentSimulatorPlugin	ADK Plugin for AgentSimulator.

RecordingsPlugin

Fluent builder for google.adk.cli.plugins.recordings_plugin.RecordingsPlugin

Plugin for recording ADK agent interactions.

Quick start:

from adk_fluent import RecordingsPlugin

result = (
    RecordingsPlugin()
    .build()
)

Control Flow & Execution

.build() -> RecordingsPlugin Control Flow & Execution

Resolve into a native ADK RecordingsPlugin.

Example:

recordingsplugin = RecordingsPlugin("recordingsplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.name(value)	str

---

ReplayPlugin

Fluent builder for google.adk.cli.plugins.replay_plugin.ReplayPlugin

Plugin for replaying ADK agent interactions from recordings.

Quick start:

from adk_fluent import ReplayPlugin

result = (
    ReplayPlugin()
    .build()
)

Control Flow & Execution

.build() -> ReplayPlugin Control Flow & Execution

Resolve into a native ADK ReplayPlugin.

Example:

replayplugin = ReplayPlugin("replayplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.name(value)	str

---

BasePlugin

Fluent builder for google.adk.plugins.base_plugin.BasePlugin

Base class for creating plugins.

Quick start:

from adk_fluent import BasePlugin

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

Constructor

BasePlugin(name: str)

Argument	Type
name	str

Control Flow & Execution

.build() -> BasePlugin Control Flow & Execution

Resolve into a native ADK BasePlugin.

Example:

baseplugin = BasePlugin("baseplugin").build("...")

---

BigQueryAgentAnalyticsPlugin

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

BigQuery Agent Analytics Plugin (v2.0 using Write API).

Quick start:

from adk_fluent import BigQueryAgentAnalyticsPlugin

result = (
    BigQueryAgentAnalyticsPlugin("project_id_value", "dataset_id_value", "kwargs_value")
    .build()
)

Constructor

BigQueryAgentAnalyticsPlugin(project_id: str, dataset_id: str, kwargs: Any)

Argument	Type
project_id	str
dataset_id	str
kwargs	Any

Control Flow & Execution

.build() -> BigQueryAgentAnalyticsPlugin Control Flow & Execution

Resolve into a native ADK BigQueryAgentAnalyticsPlugin.

Example:

bigqueryagentanalyticsplugin = BigQueryAgentAnalyticsPlugin("bigqueryagentanalyticsplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.table_id(value)	`str
.config(value)	`BigQueryLoggerConfig
.location(value)	str

---

ContextFilterPlugin

Fluent builder for google.adk.plugins.context_filter_plugin.ContextFilterPlugin

A plugin that filters the LLM context to reduce its size.

Quick start:

from adk_fluent import ContextFilterPlugin

result = (
    ContextFilterPlugin()
    .build()
)

Control Flow & Execution

.build() -> ContextFilterPlugin Control Flow & Execution

Resolve into a native ADK ContextFilterPlugin.

Example:

contextfilterplugin = ContextFilterPlugin("contextfilterplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.num_invocations_to_keep(value)	`int
.custom_filter(value)	`Callable[[list[types.Content]], list[types.Content]]
.name(value)	str

---

DebugLoggingPlugin

Fluent builder for google.adk.plugins.debug_logging_plugin.DebugLoggingPlugin

A plugin that captures complete debug information to a file.

Quick start:

from adk_fluent import DebugLoggingPlugin

result = (
    DebugLoggingPlugin()
    .build()
)

Control Flow & Execution

.build() -> DebugLoggingPlugin Control Flow & Execution

Resolve into a native ADK DebugLoggingPlugin.

Example:

debugloggingplugin = DebugLoggingPlugin("debugloggingplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.name(value)	str
.output_path(value)	str
.include_session_state(value)	bool
.include_system_instruction(value)	bool

---

GlobalInstructionPlugin

Fluent builder for google.adk.plugins.global_instruction_plugin.GlobalInstructionPlugin

Plugin that provides global instructions functionality at the App level.

Quick start:

from adk_fluent import GlobalInstructionPlugin

result = (
    GlobalInstructionPlugin()
    .build()
)

Control Flow & Execution

.build() -> GlobalInstructionPlugin Control Flow & Execution

Resolve into a native ADK GlobalInstructionPlugin.

Example:

globalinstructionplugin = GlobalInstructionPlugin("globalinstructionplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.global_instruction(value)	`str
.name(value)	str

---

LoggingPlugin

Fluent builder for google.adk.plugins.logging_plugin.LoggingPlugin

A plugin that logs important information at each callback point.

Quick start:

from adk_fluent import LoggingPlugin

result = (
    LoggingPlugin()
    .build()
)

Control Flow & Execution

.build() -> LoggingPlugin Control Flow & Execution

Resolve into a native ADK LoggingPlugin.

Example:

loggingplugin = LoggingPlugin("loggingplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.name(value)	str

---

MultimodalToolResultsPlugin

Fluent builder for google.adk.plugins.multimodal_tool_results_plugin.MultimodalToolResultsPlugin

A plugin that modifies function tool responses to support returning list of parts directly.

Quick start:

from adk_fluent import MultimodalToolResultsPlugin

result = (
    MultimodalToolResultsPlugin()
    .build()
)

Control Flow & Execution

.build() -> MultimodalToolResultsPlugin Control Flow & Execution

Resolve into a native ADK MultimodalToolResultsPlugin.

Example:

multimodaltoolresultsplugin = MultimodalToolResultsPlugin("multimodaltoolresultsplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.name(value)	str

---

ReflectAndRetryToolPlugin

Fluent builder for google.adk.plugins.reflect_retry_tool_plugin.ReflectAndRetryToolPlugin

Provides self-healing, concurrent-safe error recovery for tool failures.

Quick start:

from adk_fluent import ReflectAndRetryToolPlugin

result = (
    ReflectAndRetryToolPlugin()
    .build()
)

Control Flow & Execution

.build() -> ReflectAndRetryToolPlugin Control Flow & Execution

Resolve into a native ADK ReflectAndRetryToolPlugin.

Example:

reflectandretrytoolplugin = ReflectAndRetryToolPlugin("reflectandretrytoolplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.name(value)	str
.max_retries(value)	int
.throw_exception_if_retry_exceeded(value)	bool
.tracking_scope(value)	TrackingScope

---

SaveFilesAsArtifactsPlugin

Fluent builder for google.adk.plugins.save_files_as_artifacts_plugin.SaveFilesAsArtifactsPlugin

A plugin that saves files embedded in user messages as artifacts.

Quick start:

from adk_fluent import SaveFilesAsArtifactsPlugin

result = (
    SaveFilesAsArtifactsPlugin()
    .build()
)

Control Flow & Execution

.build() -> SaveFilesAsArtifactsPlugin Control Flow & Execution

Resolve into a native ADK SaveFilesAsArtifactsPlugin.

Example:

savefilesasartifactsplugin = SaveFilesAsArtifactsPlugin("savefilesasartifactsplugin").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.name(value)	str

---

AgentSimulatorPlugin

Fluent builder for google.adk.tools.agent_simulator.agent_simulator_plugin.AgentSimulatorPlugin

ADK Plugin for AgentSimulator.

Quick start:

from adk_fluent import AgentSimulatorPlugin

result = (
    AgentSimulatorPlugin("simulator_engine_value")
    .build()
)

Constructor

AgentSimulatorPlugin(simulator_engine: AgentSimulatorEngine)

Argument	Type
simulator_engine	AgentSimulatorEngine

Control Flow & Execution

.build() -> AgentSimulatorPlugin Control Flow & Execution

Resolve into a native ADK AgentSimulatorPlugin.

Example:

agentsimulatorplugin = AgentSimulatorPlugin("agentsimulatorplugin").build("...")