Module: service

Builders in this module

Builder	Description
BaseArtifactService	Abstract base class for artifact services.
FileArtifactService	Stores filesystem-backed artifacts beneath a configurable root directory.
GcsArtifactService	An artifact service implementation using Google Cloud Storage (GCS).
InMemoryArtifactService	An in-memory implementation of the artifact service.
PerAgentDatabaseSessionService	Routes session storage to per-agent `.
BaseMemoryService	Base class for memory services.
InMemoryMemoryService	An in-memory memory service for prototyping purpose only.
VertexAiMemoryBankService	Implementation of the BaseMemoryService using Vertex AI Memory Bank.
VertexAiRagMemoryService	A memory service that uses Vertex AI RAG for storage and retrieval.
BaseSessionService	Base class for session services.
DatabaseSessionService	A session service that uses a database for storage.
InMemorySessionService	An in-memory implementation of the session service.
SqliteSessionService	A session service that uses an SQLite database for storage via aiosqlite.
VertexAiSessionService	Connects to the Vertex AI Agent Engine Session Service using Agent Engine SDK.
ForwardingArtifactService	Artifact service that forwards to the parent tool context.

BaseArtifactService

Fluent builder for google.adk.artifacts.base_artifact_service.BaseArtifactService

Abstract base class for artifact services.

Quick start:

from adk_fluent import BaseArtifactService

result = (
    BaseArtifactService("args_value", "kwargs_value")
    .build()
)

Constructor

BaseArtifactService(args: Any, kwargs: Any)

Argument	Type
args	Any
kwargs	Any

Control Flow & Execution

.build() -> BaseArtifactService Control Flow & Execution

Resolve into a native ADK BaseArtifactService.

Example:

baseartifactservice = BaseArtifactService("baseartifactservice").build("...")

---

FileArtifactService

Fluent builder for google.adk.artifacts.file_artifact_service.FileArtifactService

Stores filesystem-backed artifacts beneath a configurable root directory.

Quick start:

from adk_fluent import FileArtifactService

result = (
    FileArtifactService("root_dir_value")
    .build()
)

Constructor

FileArtifactService(root_dir: Path | str)

Argument	Type
root_dir	`Path

Control Flow & Execution

.build() -> FileArtifactService Control Flow & Execution

Resolve into a native ADK FileArtifactService.

Example:

fileartifactservice = FileArtifactService("fileartifactservice").build("...")

---

GcsArtifactService

Fluent builder for google.adk.artifacts.gcs_artifact_service.GcsArtifactService

An artifact service implementation using Google Cloud Storage (GCS).

Quick start:

from adk_fluent import GcsArtifactService

result = (
    GcsArtifactService("bucket_name_value", "kwargs_value")
    .build()
)

Constructor

GcsArtifactService(bucket_name: str, kwargs: Any)

Argument	Type
bucket_name	str
kwargs	Any

Control Flow & Execution

.build() -> GcsArtifactService Control Flow & Execution

Resolve into a native ADK GcsArtifactService.

Example:

gcsartifactservice = GcsArtifactService("gcsartifactservice").build("...")

---

InMemoryArtifactService

Fluent builder for google.adk.artifacts.in_memory_artifact_service.InMemoryArtifactService

An in-memory implementation of the artifact service.

Quick start:

from adk_fluent import InMemoryArtifactService

result = (
    InMemoryArtifactService()
    .build()
)

Control Flow & Execution

.build() -> InMemoryArtifactService Control Flow & Execution

Resolve into a native ADK InMemoryArtifactService.

Example:

inmemoryartifactservice = InMemoryArtifactService("inmemoryartifactservice").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.artifacts(value)	dict[str, list[_ArtifactEntry]]

---

PerAgentDatabaseSessionService

Fluent builder for google.adk.cli.utils.local_storage.PerAgentDatabaseSessionService

Routes session storage to per-agent .adk/session.db files.

Quick start:

from adk_fluent import PerAgentDatabaseSessionService

result = (
    PerAgentDatabaseSessionService("agents_root_value")
    .build()
)

Constructor

PerAgentDatabaseSessionService(agents_root: Path | str)

Argument	Type
agents_root	`Path

Control Flow & Execution

.build() -> PerAgentDatabaseSessionService Control Flow & Execution

Resolve into a native ADK PerAgentDatabaseSessionService.

Example:

peragentdatabasesessionservice = PerAgentDatabaseSessionService("peragentdatabasesessionservice").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.app_name_to_dir(value)	`Mapping[str, str]

---

BaseMemoryService

Fluent builder for google.adk.memory.base_memory_service.BaseMemoryService

Base class for memory services.

Quick start:

from adk_fluent import BaseMemoryService

result = (
    BaseMemoryService("args_value", "kwargs_value")
    .build()
)

Constructor

BaseMemoryService(args: Any, kwargs: Any)

Argument	Type
args	Any
kwargs	Any

Control Flow & Execution

.build() -> BaseMemoryService Control Flow & Execution

Resolve into a native ADK BaseMemoryService.

Example:

basememoryservice = BaseMemoryService("basememoryservice").build("...")

---

InMemoryMemoryService

Fluent builder for google.adk.memory.in_memory_memory_service.InMemoryMemoryService

An in-memory memory service for prototyping purpose only.

Quick start:

from adk_fluent import InMemoryMemoryService

result = (
    InMemoryMemoryService()
    .build()
)

Control Flow & Execution

.build() -> InMemoryMemoryService Control Flow & Execution

Resolve into a native ADK InMemoryMemoryService.

Example:

inmemorymemoryservice = InMemoryMemoryService("inmemorymemoryservice").build("...")

---

VertexAiMemoryBankService

Fluent builder for google.adk.memory.vertex_ai_memory_bank_service.VertexAiMemoryBankService

Implementation of the BaseMemoryService using Vertex AI Memory Bank.

Quick start:

from adk_fluent import VertexAiMemoryBankService

result = (
    VertexAiMemoryBankService()
    .build()
)

Control Flow & Execution

.build() -> VertexAiMemoryBankService Control Flow & Execution

Resolve into a native ADK VertexAiMemoryBankService.

Example:

vertexaimemorybankservice = VertexAiMemoryBankService("vertexaimemorybankservice").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.project(value)	`str
.location(value)	`str
.agent_engine_id(value)	`str
.express_mode_api_key(value)	`str

---

VertexAiRagMemoryService

Fluent builder for google.adk.memory.vertex_ai_rag_memory_service.VertexAiRagMemoryService

A memory service that uses Vertex AI RAG for storage and retrieval.

Quick start:

from adk_fluent import VertexAiRagMemoryService

result = (
    VertexAiRagMemoryService()
    .build()
)

Control Flow & Execution

.build() -> VertexAiRagMemoryService Control Flow & Execution

Resolve into a native ADK VertexAiRagMemoryService.

Example:

vertexairagmemoryservice = VertexAiRagMemoryService("vertexairagmemoryservice").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.rag_corpus(value)	`str
.similarity_top_k(value)	`int
.vector_distance_threshold(value)	float

---

BaseSessionService

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

Base class for session services.

Quick start:

from adk_fluent import BaseSessionService

result = (
    BaseSessionService("args_value", "kwargs_value")
    .build()
)

Constructor

BaseSessionService(args: Any, kwargs: Any)

Argument	Type
args	Any
kwargs	Any

Control Flow & Execution

.build() -> BaseSessionService Control Flow & Execution

Resolve into a native ADK BaseSessionService.

Example:

basesessionservice = BaseSessionService("basesessionservice").build("...")

---

DatabaseSessionService

Fluent builder for google.adk.sessions.database_session_service.DatabaseSessionService

A session service that uses a database for storage.

Quick start:

from adk_fluent import DatabaseSessionService

result = (
    DatabaseSessionService("db_url_value", "kwargs_value")
    .build()
)

Constructor

DatabaseSessionService(db_url: str, kwargs: Any)

Argument	Type
db_url	str
kwargs	Any

Control Flow & Execution

.build() -> DatabaseSessionService Control Flow & Execution

Resolve into a native ADK DatabaseSessionService.

Example:

databasesessionservice = DatabaseSessionService("databasesessionservice").build("...")

---

InMemorySessionService

Fluent builder for google.adk.sessions.in_memory_session_service.InMemorySessionService

An in-memory implementation of the session service.

Quick start:

from adk_fluent import InMemorySessionService

result = (
    InMemorySessionService()
    .build()
)

Control Flow & Execution

.build() -> InMemorySessionService Control Flow & Execution

Resolve into a native ADK InMemorySessionService.

Example:

inmemorysessionservice = InMemorySessionService("inmemorysessionservice").build("...")

---

SqliteSessionService

Fluent builder for google.adk.sessions.sqlite_session_service.SqliteSessionService

A session service that uses an SQLite database for storage via aiosqlite.

Quick start:

from adk_fluent import SqliteSessionService

result = (
    SqliteSessionService("db_path_value")
    .build()
)

Constructor

SqliteSessionService(db_path: str)

Argument	Type
db_path	str

Control Flow & Execution

.build() -> SqliteSessionService Control Flow & Execution

Resolve into a native ADK SqliteSessionService.

Example:

sqlitesessionservice = SqliteSessionService("sqlitesessionservice").build("...")

---

VertexAiSessionService

Fluent builder for google.adk.sessions.vertex_ai_session_service.VertexAiSessionService

Connects to the Vertex AI Agent Engine Session Service using Agent Engine SDK.

Quick start:

from adk_fluent import VertexAiSessionService

result = (
    VertexAiSessionService()
    .build()
)

Control Flow & Execution

.build() -> VertexAiSessionService Control Flow & Execution

Resolve into a native ADK VertexAiSessionService.

Example:

vertexaisessionservice = VertexAiSessionService("vertexaisessionservice").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field	Type
.project(value)	`str
.location(value)	`str
.agent_engine_id(value)	`str
.express_mode_api_key(value)	`str

---

ForwardingArtifactService

Fluent builder for google.adk.tools._forwarding_artifact_service.ForwardingArtifactService

Artifact service that forwards to the parent tool context.

Quick start:

from adk_fluent import ForwardingArtifactService

result = (
    ForwardingArtifactService("tool_context_value")
    .build()
)

Constructor

ForwardingArtifactService(tool_context: ToolContext)

Argument	Type
tool_context	ToolContext

Control Flow & Execution

.build() -> ForwardingArtifactService Control Flow & Execution

Resolve into a native ADK ForwardingArtifactService.

Example:

forwardingartifactservice = ForwardingArtifactService("forwardingartifactservice").build("...")