Skip to main content

Documentation Index

Fetch the complete documentation index at: https://traceroot.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Automatically capture agent runs, tool calls, and reasoning steps within the Agno framework.

​
Setup

import traceroot
from traceroot import Integration

traceroot.initialize(integrations=[Integration.AGNO])

​
Usage

Once initialized, all Agno agent runs and tool invocations are captured automatically: 
import traceroot
from traceroot import Integration
from agno.agent import Agent
from agno.models.anthropic import Claude
from agno.tools.duckduckgo import DuckDuckGoTools
from agno.tools.yfinance import YFinanceTools

traceroot.initialize(integrations=[Integration.AGNO])

agent = Agent(
    model=Claude(id="claude-sonnet-4-20250514"),
    tools=[
        YFinanceTools(),
        DuckDuckGoTools(),
    ],
    instructions=[
        "Use YFinance for stock prices and fundamentals.",
        "Use DuckDuckGo for general web searches.",
        "Always cite your sources.",
    ],
    markdown=True,
)

# The entire agent run, including every tool call, is traced
agent.print_response(
    "What is the current stock price of NVDA and what are its fundamentals?",
    stream=False,
)

traceroot.flush()

​
What Gets Captured

AttributeDescription
Agent runsEach agent.run() / agent.print_response() invocation
Reasoning stepsIndividual ReAct-style steps within the agent loop
Tool callsEach tool invocation with input arguments and results
LLM callsRaw completion requests to the underlying provider
Tokens & CostAggregated token usage and pricing
LatencyDuration per agent run and per span

​
Run the example

Clone the repo and run a complete agent end-to-end.

Python

Run the Python example