Blog / How-to guides

Learn Truvyx by doing.

You should not need to understand evaluation theory before you can use the platform. These guides walk through the practical path: what to click, what to write, what the result means, and what to do next.

Products & Connections · Beginner tutorial01

How to set up Products & Connections in Truvyx

Create a product profile, separate development, staging, and production, choose a connection method, and verify the first safe request.

Read guide
Ground truth · Methodology02

How to create ground truth for complex AI workflows

Turn decisions, constraints, handoffs, and acceptable variations into evidence an AI evaluation can check.

Read guide
AI metrics · Framework03

Feasibility, completeness and optimality: a better AI scorecard

Learn why three complementary dimensions reveal more than one accuracy number when you evaluate an AI agent.

Read guide
Verifier scripts · Technical tutorial04

How to build verifier scripts for LLM and agent outputs

Write small, clear, repeatable checks for fields, constraints, tool calls, traces, and evidence.

Read guide
Root cause analysis · Pillar guide05

Root cause analysis for AI agents: architecture and workflow

Move from a failed run to an evidence-backed cause across prompts, tools, handoffs, constraints, and traces.

Read guide
Diagnosis · Technical guide06

Counterfactual diagnosis: finding the smallest fix for an AI failure

Change one variable at a time, compare the evidence, and promote the smallest verified repair into a regression test.

Read guide
MCP · Beginner tutorial07

How to use Truvyx from Claude Code, Cursor, or another MCP client

Create a scoped key, connect the Truvyx MCP server, inspect its manifest, investigate runs, and trigger safe test workflows from your editor.

Read guide
SDK Docs · Beginner tutorial08

How to add Truvyx evaluation to an AI agent

Install the TypeScript or Python SDK, run an evaluation, read EvalResult, add CI gates, capture traces, and protect multi-agent contracts.

Read guide
Cost Benchmarks · Beginner tutorial09

How to measure AI cost and efficiency in Truvyx

Understand model pricing, token usage, redundant calls, cost per correct decision, and efficiency benchmarks.

Read guide
HITL Analytics · Beginner tutorial010

How to use Truvyx HITL Analytics to improve human-agent workflows

Measure human-agent friction, find correction patterns, and improve escalation workflows with evidence.

Read guide
Chaos Studio · Beginner tutorial011

How to test AI resiliency with Truvyx Chaos Studio

Create controlled MCP fault-injection experiments, score agent recovery, and export resiliency evidence.

Read guide
Investigate · Beginner tutorial012

How to investigate AI behavior with Truvyx Investigate

Ask grounded questions about runs and RCA findings, then track recurring failures automatically.

Read guide
RCA Engine · Beginner tutorial013

How to investigate an AI failure with Truvyx RCA Engine

Trace a failed run to its root cause, test counterfactual fixes, and create a verified remediation plan.

Read guide
Registry · Beginner tutorial014

How to use the Truvyx Registry: a beginner's guide

Find, inspect, download, cite, reuse, and contribute validated AI evaluation scenarios.

Read guide
Decomposition Designer015

How to use Truvyx Decomposition Designer to map multi-agent systems

Design agent nodes, dependencies, information boundaries, contracts, anti-pattern checks, and framework exports from one visual canvas.

Read guide
Verifier Factory016

How to use Truvyx Verifier Factory to test AI outputs

Generate, inspect, test, download, and run versioned verifier scripts, then connect evidence to Evaluation Runs and CI/CD.

Read guide
Constraint Engine017

How to use Truvyx Constraint Engine for safer AI evaluations

Define hard and soft constraints, check feasibility, configure escalation, protect sensitive fields, and connect rules to verification and diagnosis.

Read guide
Scenario Studio018

How to use Truvyx Scenario Studio for your first AI evaluation

A beginner-first walkthrough of the real Scenario Studio workflow: domains, templates, Natural Language generation, constraints, saving, and the next module to open.

Read guide
Start here019

How to run your first AI evaluation in Truvyx

Create a scenario, submit an agent output, and understand what PASSED, FAILED, and PARTIAL mean.

Read guide
Scenario design020

How to write a useful evaluation scenario

Turn a vague expectation into constraints, ground truth, and checks that can produce a useful diagnosis.

Read guide
API setup021

How to connect your agent with the Truvyx API

Use an API key, submit camelCase evaluation fields, poll the result, and handle failures safely.

Read guide
Results022

How to read an evaluation result

Learn the difference between a score, a violation, a completeness gap, and a root-cause signal.

Read guide
Scaling up023

How to move from one test to continuous evaluation

Build a small regression suite and add evaluation to the development workflow without creating noise.

Read guide

The simplest Truvyx mental model

1. Scenario: describe what good behaviour looks like.

2. Run: submit what your agent actually did.

3. Diagnose: fix the smallest cause the evidence points to.