Arize

Integrate Agno with Arize Phoenix to send traces and gain insights into your agent’s performance.

Integrating Agno with Arize Phoenix

Arize Phoenix is a platform for monitoring and analyzing AI models. By integrating Agno with Arize Phoenix, you can use OpenInference to send traces and gain insights into your agent’s performance.

Prerequisites

1. Install Dependencies

   Ensure you have the necessary packages installed:

   uv pip install agno arize-phoenix openai openinference-instrumentation-agno opentelemetry-sdk opentelemetry-exporter-otlp yfinance
   

2. Setup Arize Phoenix Account

   • Create an account at Arize Phoenix.
   • Obtain your API key from the Arize Phoenix dashboard.

3. Set Environment Variables

   Configure your environment with the Arize Phoenix API key:

   export PHOENIX_API_KEY=<your-key>
   

Sending Traces to Arize Phoenix

• Example: Using Arize Phoenix with OpenInference

Instrument your Agno agent with OpenInference and send traces to Arize Phoenix.

import os

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.yfinance import YFinanceTools
from phoenix.otel import register

# Set environment variables for Arize Phoenix
os.environ["PHOENIX_API_KEY"] = os.getenv("PHOENIX_API_KEY")
os.environ["PHOENIX_COLLECTOR_ENDPOINT"] = "https://app.phoenix.arize.com"

# Configure the Phoenix tracer
tracer_provider = register(
    project_name="agno-stock-price-agent",  # Default is 'default'
    auto_instrument=True,  # Automatically use the installed OpenInference instrumentation
)

# Create and configure the agent
agent = Agent(
    name="Stock Price Agent",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[YFinanceTools()],
    instructions="You are a stock price agent. Answer questions in the style of a stock analyst.",
    debug_mode=True,
)

# Use the agent
agent.print_response("What is the current price of Tesla?")

Now go to the phoenix cloud and view the traces created by your agent. You can visualize the execution flow, monitor performance, and debug issues directly from the Arize Phoenix dashboard.

• Example: Local Collector Setup

For local development, you can run a local collector using

phoenix serve

import os

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.yfinance import YFinanceTools
from phoenix.otel import register

# Set the local collector endpoint
os.environ["PHOENIX_COLLECTOR_ENDPOINT"] = "http://localhost:6006"

# Configure the Phoenix tracer
tracer_provider = register(
    project_name="agno-stock-price-agent",  # Default is 'default'
    auto_instrument=True,  # Automatically use the installed OpenInference instrumentation
)

# Create and configure the agent
agent = Agent(
    name="Stock Price Agent",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[YFinanceTools()],
    instructions="You are a stock price agent. Answer questions in the style of a stock analyst.",
    debug_mode=True,
)

# Use the agent
agent.print_response("What is the current price of Tesla?")

Notes

• Environment Variables: Ensure your environment variables are correctly set for the API key and collector endpoint.
• Local Development: Use phoenix serve to start a local collector for development purposes.

By following these steps, you can effectively integrate Agno with Arize Phoenix, enabling comprehensive observability and monitoring of your AI agents.