1. Prerequisites
Before setting up evaluations, ensure you have:- Netra SDK installed and initialized
- At least one traced LLM call in your dashboard
- Your API key configured
2. Create an Evaluation
Evaluations are collections of test cases that define inputs and expected outputs for your AI system.Option A: Create from Traces (Recommended)
Convert real-world interactions into test cases:1
Navigate to Traces
Go to Observability → Traces and find a trace you want to use as a test case.
2
Add to Evaluation
Click the Add to Evaluation button on the trace.
3
Configure the Test Case
- Enter an evaluation name (e.g., “Customer Support QA”) - Add optional tags for organization - Review the input prompt - Provide the expected output - Click Next
4
Select Evaluators
Choose evaluators to score your AI’s performance (see Step 3).
Option B: Create Manually
1
Open Evaluations Dashboard
Navigate to Evaluation → Evaluations and click Create Evaluation.
2
Configure Evaluation
- Enter an evaluation name - Select Single Turn for request/response pairs - Choose Add manually
3
Add Test Cases
For each test case, provide:
- Input: The prompt or question
- Expected Output: The ideal response
- Metadata (optional): Additional context
3. Configure Evaluators
Evaluators score your AI’s outputs against defined criteria. Netra offers two types:LLM as Judge
Best for subjective quality assessment:- Answer Correctness: Does the response match the expected answer?
- Relevance: Is the response relevant to the question?
- Hallucination Detection: Does the response contain fabricated information?
- Toxicity: Is the content safe and appropriate?
Code Evaluators
Best for deterministic checks:- JSON Validation: Verify JSON structure and schema
- Regex Matching: Pattern-based validation
- Custom Logic: Write JavaScript or Python for specific rules
1
Add Evaluators
When creating your evaluation, click Next to reach the evaluator selection screen.
2
Select from Library
Browse pre-built evaluators in categories: -
Quality - Performance - Agentic - Guardrails
3
Map Variables
Configure how evaluator variables map to your data:
- Test case field: Use values from your test cases
- Agent response: Use the actual LLM output
- Execution data: Use trace metadata
4. Run an Evaluation
Once your evaluation is configured with evaluators:1
Get Evaluation ID
Open your evaluation and copy the Evaluation ID displayed at the top.
2
Trigger Evaluation
Run your AI system with the evaluation inputs. Evaluations execute automatically
when traces are created.
3
View Results
Navigate to Evaluation → Test Runs to see your evaluation results.
5. Analyze Test Run Results
Click on a test run to view detailed results:Summary Metrics
- Total Cost: Aggregate cost of all LLM calls
- Average Latency: Response time across test cases
- Pass/Fail Rate: Overall success rate
Per-Test-Case Results
Each test case shows:Troubleshooting
Next Steps
Evaluations
Learn advanced evaluation management
Evaluators
Create custom evaluation logic
Test Runs
Deep dive into test run analysis
Evaluation Overview
Understand the full evaluation framework