Test Results¶

Every test returns a TestResult object with score, status, and reasoning.

graph LR
    subgraph "TestResult"
        A[score] --> B[0-10]
        C[passed] --> D[True/False]
        E[reasoning] --> F[AI explanation]
    end

    classDef field fill:#6366F1,stroke:#7C90A0,color:#fff
    classDef value fill:#10B981,stroke:#7C90A0,color:#fff

    class A,C,E field
    class B,D,F value

TestResult Fields¶

Field	Type	Description
`score`	`float`	Score from 0 to 10
`passed`	`bool`	True if score ≥ threshold
`reasoning`	`str`	AI's explanation
`criteria`	`str`	Criteria used
`expected`	`str`	Expected output
`output`	`str`	Tested output
`duration`	`float`	Test duration in seconds

Usage¶

from testagent import test

result = test("Hello world", criteria="is a greeting")

# Access fields
print(f"Score: {result.score}")
print(f"Passed: {result.passed}")
print(f"Reasoning: {result.reasoning}")

# Convert to dict
data = result.to_dict()

Threshold¶

Default threshold is 7.0. Customize it:

from testagent import TestConfig, set_config

set_config(TestConfig(threshold=8.0))

Serialization¶

# To dictionary
data = result.to_dict()

# To JSON
import json
json_str = json.dumps(result.to_dict())