Skip to main content

get_readiness_score()

Get the EU AI Act readiness score for your tenant.
score = client.get_readiness_score()
Returns: Score object with total, per-component breakdown, and recommendations. See Readiness Score for component details.
{
  "total_score": 85,
  "max_score": 120,
  "rating": "good",
  "components": [
    {"name": "agent_registry", "score": 20, "max_score": 20, "status": "complete"},
    {"name": "risk_classification", "score": 15, "max_score": 20, "status": "partial"},
    {"name": "governance_policies", "score": 15, "max_score": 15, "status": "complete"},
    {"name": "human_oversight", "score": 15, "max_score": 20, "status": "partial"},
    {"name": "audit_trail", "score": 15, "max_score": 15, "status": "complete"},
    {"name": "fria_completion", "score": 5, "max_score": 20, "status": "partial"},
    {"name": "incident_readiness", "score": 0, "max_score": 10, "status": "missing"}
  ],
  "recommendations": [
    "Classify the remaining 2 agents with a risk level",
    "Complete FRIA for agents: hr-screener, loan-evaluator"
  ]
}

get_fria()

Get the Fundamental Rights Impact Assessment for an agent.
fria = client.get_fria("agt_abc123")
agent_id
string
required
Agent ID
Returns: FRIA object with all six assessment fields, version, and status. See FRIA for details.
{
  "id": "fria_abc123",
  "agent_id": "agt_abc123",
  "version": 1,
  "status": "submitted",
  "processes": "...",
  "frequency_and_scope": "...",
  "categories_of_persons": "...",
  "specific_risks": "...",
  "human_oversight_measures": "...",
  "risk_mitigation_measures": "..."
}

get_transparency_card()

Get the auto-generated transparency card for an agent. Transparency cards document the agent’s purpose, capabilities, limitations, and risk classification — required by EU AI Act Articles 13 and 50.
card = client.get_transparency_card("agt_abc123")
agent_id
string
required
Agent ID
Returns:
{
  "agent_id": "agt_abc123",
  "agent_name": "production-summarizer",
  "purpose": "Summarizes customer support tickets for the support team",
  "framework": "crewai",
  "model_provider": "openai",
  "model_name": "gpt-4o",
  "risk_level": "limited",
  "capabilities": [
    "Text summarization",
    "Ticket categorization"
  ],
  "limitations": [
    "May miss context in multi-language tickets",
    "Does not handle image attachments"
  ],
  "human_oversight": "Output reviewed by support team leads before customer communication",
  "data_sources": "Customer support ticket text (no PII stored)",
  "generated_at": "2026-03-17T10:00:00Z"
}

create_incident()

Report a serious incident per EU AI Act Article 73.
incident = client.create_incident(
    agent_id="agt_abc123",
    title="Discriminatory output in hiring agent",
    severity="serious",
    description="The HR screening agent systematically ranked female candidates lower...",
    impact="Approximately 120 job applicants may have been affected.",
    immediate_actions="Agent suspended immediately.",
    root_cause="Training data contained historical hiring bias.",
    affected_persons_count=120,
    involves_health_or_death=False,
)
agent_id
string
required
Agent ID
title
string
required
Short title describing the incident
severity
string
required
serious or critical (critical if death or serious health damage)
description
string
required
Detailed description of what happened
impact
string
required
Description of the impact
immediate_actions
string
required
Actions taken immediately after discovery
root_cause
string
Root cause analysis (can be updated later)
affected_persons_count
integer
Estimated number of affected persons
involves_health_or_death
boolean
default:"false"
If true, the reporting deadline is 2 days instead of 15
See Incident Reporting for the full workflow including authority notification.