Fix Types

Risicare can generate 7 types of declarative fixes.

Overview

Fix Structure

A fix, as the API returns it:

{
  "fix_id": "fix-abc123",
  "project_id": "proj-123",
  "diagnosis_id": "diag-xyz789",
  "title": "Retry on tool timeout",
  "description": "Add exponential backoff retry for TOOL.EXECUTION.TIMEOUT errors",
  "fix_type": "retry",
  "status": "draft",
  "error_code": "TOOL.EXECUTION.TIMEOUT",
  "agent_id": "researcher",
  "confidence": 0.85,
  "fix_config": {
    "max_retries": 3,
    "initial_delay_ms": 1000,
    "exponential_base": 2.0
  }
}

Targeting

A fix applies by its error_code: an exact code, or a pattern ending in * that matches by prefix — for example TOOL.EXECUTION.*. A fix record can also carry an agent_id, but the SDK does not receive it, so it does not limit where the fix applies. There is no way to target tools, models or environments.

Rollback

A fix has no rollback-strategy setting. Rolling back belongs to the deployment pipeline, which is gated off in this release — see Rollback.

Fix Precedence

The SDK Fix Runtime receives at most one active fix per error_code value: when several fixes share one, the most recently updated is served. When the runtime looks up an error, an exact code match wins over a * pattern.

SDK Integration

from risicare import init_runtime, FixRuntimeConfig
 
# init() does not start the runtime: fix_runtime defaults to False since 0.4.0.
# This call starts a runtime with a custom configuration. During the beta it
# logs a warning and loads no fix.
runtime = init_runtime(config=FixRuntimeConfig(
    api_endpoint="https://api.risicare.ai",
    api_key="rsk-...",
))

Managing Fixes

Fixes are normally created by the diagnosis pipeline, which is held for the beta — so it generates no new fixes today. There is no way to create, change or read a fix with an API key during the beta: the Management API is not available with an API key.

Via Dashboard

While diagnosis is held for the beta, Self-Healing is removed from the dashboard's navigation: its page shows only a notice that diagnosis is not part of this release, and a fix's detail page is not found.

Via API

Not available with an API key during the beta.

Next Steps

Select a fix type to learn more: