Validation History

The validation history feature provides comprehensive tracking and analysis of all your agent card validations. Keep track of your validation journey and identify improvement patterns.

Overview

Validation history helps you:

Track Progress - Monitor validation trends over time
Identify Patterns - Spot recurring issues and improvements
Audit Compliance - Maintain records for compliance requirements
Collaborate - Share validation results with team members

Accessing Your History

Dashboard View

From the main dashboard, access your validation history through:

Recent Activity - Last 10 validations on the homepage
History Tab - Complete validation history
Quick Filters - Common filter presets

List View - Tabular display with sortable columns
Timeline View - Chronological visualization
Card View - Detailed card layout with previews

Validation Records

Each validation record includes:

{
  "validation_id": "val_123456789",
  "timestamp": "2024-01-15T10:30:00Z",
  "agent_id": "my-agent",
  "version": "1.2.0",
  "status": "passed",
  "quality_score": 85,
  "errors": [],
  "warnings": [
    {
      "path": "$.description",
      "message": "Could be more descriptive"
    }
  ]
}

Status Types

✅ Passed - Validation successful with no errors
⚠️ Passed with Warnings - Valid but with improvement suggestions
❌ Failed - Validation failed with errors
🔄 Processing - Validation in progress

Filtering and Search

Basic Filters

Filter your history by:

Date Range - Last day, week, month, or custom range
Status - Success, failure, or warning states
Agent ID - Specific agent identifiers
Version - Semantic version numbers

Search Examples

# Search by agent ID
agent_id:my-agent

# Search by date range
created:2025-01-01..2025-01-31

# Search by status
status:failed

# Combine multiple filters
agent_id:my-agent status:passed quality_score:>90

Quality Analysis

Quality Score Breakdown

Quality scores range from 0-100 based on:

Completeness (25%) - Required and recommended fields
Clarity (25%) - Description quality and documentation
Standards (25%) - Best practice adherence
Security (25%) - Security consideration compliance

Trend Analysis

Success Rate Over Time - Track improvement trends
Common Error Patterns - Identify recurring issues
Quality Score Evolution - Monitor quality improvements

Exporting Data

Export Formats

CSV - For spreadsheet analysis
JSON - For programmatic processing
PDF Report - Human-readable summary with charts

Automated Reports

Set up scheduled exports:

Daily - End-of-day validation summaries
Weekly - Comprehensive weekly reports
Monthly - Long-term trend analysis

Team Collaboration

Shared History

In team environments:

Organization History - All team validations
Project Filtering - Filter by specific projects
User Attribution - See who performed validations

Notifications

Stay informed about validation activity:

Failed Validation Alerts - Immediate notification of failures
Quality Score Drops - Alert when scores decrease significantly
Team Activity - Updates on team member validations

API Access

Access validation history programmatically:

# Access validation history programmatically
# Note: History access requires authentication
curl -X GET "https://api.valgent.io/v1/validations?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"