Firestore for Agent

Agno supports using Firestore as a storage backend for Agents using the FirestoreDb class.

Usage

You need to provide either project_id or db_client to the FirestoreDb class. Firestore will connect automatically using your Google Cloud credentials.

firestore_for_agent.py

from agno.agent import Agent
from agno.db.firestore import FirestoreDb
from agno.tools.websearch import WebSearchTools

PROJECT_ID = "agno-os-test"  # Use your project ID here

# Setup the Firestore database
db = FirestoreDb(project_id=PROJECT_ID)

agent = Agent(
    db=db,
    tools=[WebSearchTools()],
    add_history_to_context=True,
)

agent.print_response("How many people live in Canada?")
agent.print_response("What is their national anthem called?")

Prerequisites

Ensure your gcloud project is enabled with Firestore. See the Firestore documentation
Install dependencies: uv pip install openai google-cloud-firestore ddgs agno
Make sure your gcloud project is set up and you have the necessary permissions to access Firestore

Params

Parameter	Type	Default	Description
`id`	`Optional[str]`	-	The ID of the database instance. UUID by default.
`db_client`	`Optional[Client]`	-	The Firestore client to use.
`project_id`	`Optional[str]`	-	The GCP project ID for Firestore.
`session_collection`	`Optional[str]`	-	Name of the collection to store sessions.
`memory_collection`	`Optional[str]`	-	Name of the collection to store memories.
`metrics_collection`	`Optional[str]`	-	Name of the collection to store metrics.
`eval_collection`	`Optional[str]`	-	Name of the collection to store evaluation runs.
`knowledge_collection`	`Optional[str]`	-	Name of the collection to store knowledge documents.
`culture_collection`	`Optional[str]`	-	Name of the collection to store cultural knowledge.
`traces_collection`	`Optional[str]`	-	Name of the collection to store traces.
`spans_collection`	`Optional[str]`	-	Name of the collection to store spans.

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Firestore for Agent

Usage

Prerequisites

Params

​Usage

​Prerequisites

​Params

Usage

Prerequisites

Params