Firestore for Team

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

Usage

You need to provide a project_id parameter to the FirestoreDb class. Firestore will connect automatically using your Google Cloud credentials.

firestore_for_team.py

"""
Run: `uv pip install openai newspaper4k lxml_html_clean agno` to install the dependencies
"""

from typing import List

from agno.agent import Agent
from agno.db.firestore import FirestoreDb
from agno.models.openai import OpenAIResponses
from agno.team import Team
from agno.tools.hackernews import HackerNewsTools
from agno.tools.hackernews import HackerNewsTools
from pydantic import BaseModel

# Setup the Firestore database
PROJECT_ID = "agno-os-test"  # Use your project ID here
db = FirestoreDb(project_id=PROJECT_ID)

class Article(BaseModel):
    title: str
    summary: str
    reference_links: List[str]

hn_researcher = Agent(
    name="HackerNews Researcher",
    model=OpenAIResponses(id="gpt-5.2"),
    role="Gets top stories from hackernews.",
    tools=[HackerNewsTools()],
)

web_searcher = Agent(
    name="Web Searcher",
    model=OpenAIResponses(id="gpt-5.2"),
    role="Searches the web for information on a topic",
    tools=[HackerNewsTools()],
    add_datetime_to_context=True,
)

hn_team = Team(
    name="HackerNews Team",
    model=OpenAIResponses(id="gpt-5.2"),
    members=[hn_researcher, web_searcher],
    db=db,
    instructions=[
        "First, search hackernews for what the user is asking about.",
        "Then, ask the web searcher to search for each story to get more information.",
        "Finally, provide a thoughtful and engaging summary.",
    ],
    output_schema=Article,
    markdown=True,
    show_members_responses=True,
)

hn_team.print_response("Write an article about the top 2 stories on hackernews")

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.
traces_collection	Optional[str]	-	Name of the collection to store traces.
spans_collection	Optional[str]	-	Name of the collection to store spans.