Documentation

Getting Started with AGEI

Integrate evidence-based AI governance into your systems in minutes. This guide walks through creating your first policy gate, evaluating an AI action, and capturing evidence receipts.

Quick Start Workflow

1

Set Up Your Organization

Sign up and create your organization. AGEI uses tenant isolation to ensure your evidence vault remains separate from other organizations.

2

Define Your First Policy

Create a policy set that defines governance rules for AI model deployments, agent actions, or data processing activities.

Example Policy Structure:

{
  "policy_name": "Model Deployment Review",
  "scope": ["model_deployment"],
  "rules": [
    {
      "condition": "model_risk_score > 0.7",
      "action": "require_human_approval"
    }
  ]
}
3

Create a Governance Gate

Link your policy to a gate that evaluates lifecycle events. Gates produce outcomes like approve, deny, escalate, or inspect.

Key Concept: Gates separate evaluation_status (pass/fail) from gate_outcome (approve/deny/escalate/inspect).

4

Send an Event for Evaluation

Use the AGEI API or Python SDK to submit lifecycle events to your gate for governance evaluation.

API Example:

POST /api/v1/gates/:gate_id/evaluate
{
  "event_type": "model_deployment_requested",
  "payload": {
    "model_id": "credit-risk-v3",
    "risk_score": 0.85
  }
}
5

Retrieve Evidence Receipts

Every evaluation creates a tamper-evident receipt. Query receipts for audit trails, compliance reporting, or incident investigation.

Example Receipt:

{
  "receipt_id": "rcpt_001",
  "outcome": "escalate",
  "reason_code": "HUMAN_REVIEW_REQUIRED",
  "content_hash": "sha256:a1b2c3...",
  "created_at": "2026-05-04T16:30:00Z"
}

What You Can Build

Model Deployment Gates

Require bias reviews, fairness tests, or human approval before deploying high-risk AI models.

Agent Tool Call Governance

Control which tools AI agents can invoke based on identity, session context, and privilege grants.

HITL Approval Workflows

Escalate risky AI decisions to human reviewers and record approval/denial receipts.

Next Steps

Explore Core Concepts

Understand AGEI terminology: Evidence Receipts, Policy Gates, HITL Governance, Lazy Capsule Materialization.

Review Example Scenarios

See complete workflows for credit decisions, healthcare AI review, agent monitoring, and audit pack export.

Ready to Get Started?

Create your organization and start building governed AI systems today.