Getting Started
Get up and running with Risicare in minutes.
Welcome to Risicare! This section will help you get started with self-healing observability for your AI agents.
Quick Links
Quickstart
Start tracing in 5 minutes
Learn more
Installation
Install and configure the SDK
Learn more
Core Concepts
Understand traces, spans, and agents
Learn more
What is Risicare?
Risicare is a self-healing observability platform for AI agents. It provides:
- Automatic Instrumentation - Trace LLM calls with zero code changes
- Decision-Level Observability - Track THINK/DECIDE/ACT phases
- Error Diagnosis - Classify failures using a 154-code taxonomy
- Automatic Fixes - Generate and test fixes with statistical validation
- Safe Deployment - Deploy fixes with canary releases and A/B testing
Progressive Integration
Risicare uses a tiered approach that lets you start simple and add depth as needed:
| Tier | What You Add | What You Get |
|---|---|---|
| 0 | Environment variable | All LLM calls traced |
| 1 | import risicare | Explicit configuration |
| 2 | @agent() | Agent identity tracking |
| 3 | @session | User session grouping |
| 4 | @trace_think/decide/act | Decision phase tracking |
| 5 | @trace_message/delegate | Full multi-agent support |
How It Works
Your Agent Code
↓
SDK Instrumentation (automatic)
↓
Rust Gateway (batching, validation)
↓
ClickHouse (traces) + PostgreSQL (configs)
↓
Diagnosis Engine (4-stage LLM pipeline)
↓
Fix Generation → Hypothesis Testing → Deployment
Next Steps
Install the SDK
Run pip install risicare and set your API key.
Start Tracing
Set RISICARE_TRACING=true and run your agent.
View Dashboard
Open app.risicare.ai to see traces.
Enable Self-Healing
Configure automatic diagnosis and fix generation.