Team Session Metrics
Demonstrates session-level metrics for teams with PostgreSQL persistence.
Demonstrates session-level metrics for teams with PostgreSQL persistence. Metrics accumulate across multiple team runs within the same session.
"""
Team Session Metrics
=============================
Demonstrates session-level metrics for teams with PostgreSQL persistence.
Metrics accumulate across multiple team runs within the same session.
Run: ./cookbook/scripts/run_pgvector.sh
"""
from agno.agent import Agent
from agno.db.postgres import PostgresDb
from agno.models.openai import OpenAIChat
from agno.team import Team
from rich.pretty import pprint
# ---------------------------------------------------------------------------
# Setup
# ---------------------------------------------------------------------------
db_url = "postgresql+psycopg://ai:ai@localhost:5532/ai"
db = PostgresDb(db_url=db_url, session_table="team_metrics_sessions")
# ---------------------------------------------------------------------------
# Create Members
# ---------------------------------------------------------------------------
assistant = Agent(
name="Assistant",
model=OpenAIChat(id="gpt-5.6-luna"),
role="Helpful assistant that answers questions.",
)
# ---------------------------------------------------------------------------
# Create Team
# ---------------------------------------------------------------------------
team = Team(
name="Research Team",
model=OpenAIChat(id="gpt-5.6-luna"),
members=[assistant],
db=db,
session_id="team_session_metrics_demo",
markdown=True,
)
# ---------------------------------------------------------------------------
# Run Team
# ---------------------------------------------------------------------------
if __name__ == "__main__":
# First run
run_output_1 = team.run("What is the capital of Japan?")
print("=" * 50)
print("RUN 1 METRICS")
print("=" * 50)
pprint(run_output_1.metrics)
# Second run on the same session
run_output_2 = team.run("What about South Korea?")
print("=" * 50)
print("RUN 2 METRICS")
print("=" * 50)
pprint(run_output_2.metrics)
# Session metrics aggregate both runs
print("=" * 50)
print("SESSION METRICS (accumulated)")
print("=" * 50)
session_metrics = team.get_session_metrics()
pprint(session_metrics)Example behavior
Add add_history_to_context=True to Team(...) so “What about South Korea?” includes the prior question in model context. A stored session and accumulating metrics alone do not enable conversational history. Session totals include leader and member metrics across runs, and the fixed session ID can include earlier script invocations.
Run the Example
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activateInstall dependencies
uv pip install -U agno "psycopg[binary]" openai sqlalchemyExport your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"Run PgVector
docker run -d \
-e POSTGRES_DB=ai \
-e POSTGRES_USER=ai \
-e POSTGRES_PASSWORD=ai \
-e PGDATA=/var/lib/postgresql \
-v pgvolume:/var/lib/postgresql \
-p 5532:5432 \
--name pgvector \
agnohq/pgvector:18Run the example
Save the code above as team_session_metrics.py, then run:
python team_session_metrics.pyFull source: cookbook/03_teams/22_metrics/03_team_session_metrics.py