Single Tool Call Reliability Evaluation

Assert a single expected tool call and validate its arguments with expected_tool_call_arguments.

Demonstrates reliability checks for one expected tool call, including argument validation.

calculator.py
"""
Single Tool Call Reliability Evaluation
=======================================

Demonstrates reliability checks for one expected tool call,
including argument validation.
"""

from typing import Optional

from agno.agent import Agent
from agno.eval.reliability import ReliabilityEval, ReliabilityResult
from agno.models.openai import OpenAIChat
from agno.run.agent import RunOutput
from agno.tools.calculator import CalculatorTools


# ---------------------------------------------------------------------------
# Create Evaluation Functions
# ---------------------------------------------------------------------------
def factorial():
    agent = Agent(
        model=OpenAIChat(id="gpt-5.2"),
        tools=[CalculatorTools()],
    )
    response: RunOutput = agent.run("What is 10! (ten factorial)?")
    evaluation = ReliabilityEval(
        name="Tool Call Reliability",
        agent_response=response,
        expected_tool_calls=["factorial"],
    )
    result: Optional[ReliabilityResult] = evaluation.run(print_results=True)
    if result:
        result.assert_passed()


def multiply_with_argument_check():
    """Verify that the tool was called with the correct arguments."""
    agent = Agent(
        model=OpenAIChat(id="gpt-5.2"),
        tools=[CalculatorTools()],
    )
    response: RunOutput = agent.run("What is 10 * 5?")
    evaluation = ReliabilityEval(
        name="Tool Call Argument Validation",
        agent_response=response,
        expected_tool_calls=["multiply"],
        expected_tool_call_arguments={
            "multiply": {"a": 10, "b": 5},
        },
    )
    result: Optional[ReliabilityResult] = evaluation.run(print_results=True)
    if result:
        result.assert_passed()


# ---------------------------------------------------------------------------
# Run Evaluation
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    factorial()
    multiply_with_argument_check()

Run the Example

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

Install dependencies

uv pip install -U agno openai

Export your OpenAI API key

export OPENAI_API_KEY="your_openai_api_key_here"

Run the example

Save the code above as calculator.py, then run:

python calculator.py

Full source: cookbook/09_evals/reliability/single_tool_calls/calculator.py