GcsJsonDb

GcsJsonDb is a class that implements the Db interface using Google Cloud Storage as a database using JSON files. It provides high-performance, distributed storage for agent sessions with support for JSON data types and schema versioning.

Parameter	Type	Default	Description
bucket_name	str	-	Name of the GCS bucket where JSON files will be stored.
prefix	Optional[str]	-	Path prefix for organizing files in the bucket. Defaults to "agno/".
session_table	Optional[str]	-	Name of the JSON file to store sessions (without .json extension).
memory_table	Optional[str]	-	Name of the JSON file to store user memories.
metrics_table	Optional[str]	-	Name of the JSON file to store metrics.
eval_table	Optional[str]	-	Name of the JSON file to store evaluation runs.
knowledge_table	Optional[str]	-	Name of the JSON file to store knowledge content.
project	Optional[str]	-	GCP project ID. If None, uses default project.
credentials	Optional[Any]	-	GCP credentials. If None, uses default credentials.

Methods

upsert_sessions

Bulk upsert multiple sessions for improved performance on large datasets.

Parameters:

• sessions (List[Session]): List of sessions to upsert
• deserialize (Optional[bool]): Whether to deserialize the sessions. Defaults to True

Returns: List[Union[Session, Dict[str, Any]]]

upsert_memories

Bulk upsert multiple memories for improved performance on large datasets.

Parameters:

• memories (List[UserMemory]): List of memories to upsert
• deserialize (Optional[bool]): Whether to deserialize the memories. Defaults to True

Returns: List[Union[UserMemory, Dict[str, Any]]]