Resources

Agent Status / Field Notes

Agent SLA Handbook

A comprehensive guide to defining, measuring, and enforcing service level agreements for AI agents.


01Section

Why Agent SLAs Are Different

Traditional SLAs measure uptime: "Is the service responding?" Agent SLAs must also measure correctness: "Is the agent responding correctly?"

An agent can achieve 99.99% uptime while being semantically broken - returning HTTP 200 with useless or wrong responses. Traditional SLAs miss this entirely.


02Section

SLA Components

1. Availability

Definition: Percentage of time the agent endpoint is reachable and responding.

TierTargetAllowed Downtime/Month
Basic99%7.2 hours
Standard99.5%3.6 hours
Premium99.9%43 minutes
Critical99.95%22 minutes

2. Semantic Correctness

Definition: Percentage of responses that are actually correct and useful.

TierEval Pass Rate
Basic90%
Standard95%
Premium98%

An agent returning "I cannot help" to every query has 100% availability but 0% correctness.

3. Performance

MetricBasicStandardPremium
TTFB P50<5s<3s<2s
TTFB P95<10s<6s<4s
Total P50<30s<15s<10s

4. Geographic Consistency

MetricTarget
All regions availability>95%
Latency variance<2x baseline
Regional outage detection<15 minutes

03Section

Defining Your SLA

Step 1: Understand Your Users

  • Where are they located?
  • What latency is acceptable for your use case?
  • How critical is the agent to their workflow?
  • What's the business impact of failures?

Step 2: Establish Baselines

Before committing to targets, measure current availability, eval pass rate, latency percentiles, and regional performance. Set targets you can actually achieve, then improve.

Step 3: Choose Components

Use CaseAvailabilityCorrectnessLatencyGeographic
Internal tool--
Customer-facing
Enterprise B2B
API product

Step 4: Define Measurement

For each component, specify the metric, method, frequency, and exclusions (maintenance windows, etc.).

Step 5: Set Consequences

SLAs without teeth are just targets. Consider service credits, termination rights, and reporting requirements.


04Section

Measurement Best Practices

  • Use third-party monitoring: Provider-reported metrics have inherent conflicts of interest.
  • Measure continuously: Spot checks miss issues.
  • Include semantic checks: HTTP health checks are necessary but insufficient.
  • Track percentiles: Averages hide tail latency.
  • Distinguish error types: Separate agent failures from infrastructure failures.

05Section

Credit Calculations

Tiered Credits

Actual AvailabilityCredit
99.0% - 99.9%10%
98.0% - 99.0%25%
95.0% - 98.0%50%
<95.0%100%

Always cap maximum credits (per month: 50-100% of monthly fee). Uncapped credits create unbounded liability.


06Section

Common Pitfalls

Uptime-Only SLAs: Measuring only HTTP availability misses semantic failures. Include eval pass rate.

Average-Only Latency: Averages hide P99 latency spikes. Use percentiles.

Single-Location Measurement: Checking from one location misses regional failures. Require geographic distribution.

No Baseline: Setting targets without historical data leads to unachievable or meaningless SLAs.

Unclear Exclusions: Vague exclusion language creates disputes. Enumerate specific exclusions precisely.


07Section

Example SLA

snippet
SERVICE LEVEL AGREEMENT
AI Customer Support Agent

1. AVAILABILITY
   Target: 99.9%
   Measurement: HTTP 2xx responses
   Period: Monthly

2. SEMANTIC CORRECTNESS
   Target: 95% gold prompt pass rate
   Evaluation prompts: Health and contract tier

3. PERFORMANCE
   TTFB P50: <2 seconds
   TTFB P95: <5 seconds
   Measurement: Third-party monitoring (Agent Status)

4. GEOGRAPHIC COVERAGE
   Regions: US, EU, APAC
   Per-region availability: >95%

5. CREDITS
   Availability miss: 10% per 0.1% below target
   Correctness miss: 10% per 1% below target
   Maximum: 50% of monthly fee

08Section

Implementation

Setting Up Monitoring

  1. Configure agent in monitoring system
  2. Enable all relevant regions
  3. Set check frequency matching SLA period
  4. Configure gold prompt validation
  5. Enable alerting for SLA violations

Handling Violations

  1. Detect violation via monitoring
  2. Document incident details
  3. Calculate credit owed
  4. Communicate with customer
  5. Conduct post-incident review

Independent monitoring

See your agent the way the world sees it.

Outside-in validations from real residential nodes, evaluation prompts that catch silent-200 failures.