Core Concepts

Adaptive Decision Interface

A2UI generates deterministic UI blueprints that adapt layout and components based on decision type, risk level, and user role. Every interaction is audit-logged for compliance.

How A2UI Works

Traditional dashboards show the same interface to everyone. A2UI dynamically generates UI blueprints based on context:

  • Decision Type: Pricing, inventory, risk, promotion
  • Risk Level: Low, medium, high, critical
  • User Role: Operator, manager, admin
  • Domain: Retail, fintech, lending compliance requirements

The backend Blueprint Builder service generates a JSON blueprint that the frontend renders deterministically. This ensures:

  • Consistent rendering across sessions
  • Complete audit trail of what was shown
  • Role-based component visibility
  • Compliance with regulatory requirements

Layout Modes

A2UI selects one of three layout modes based on decision characteristics:

Fast Path
Trigger: routine_low_risk

Streamlined view for routine, low-risk decisions that can be quickly approved

DecisionCard
QuickApproveBar
Example: Approving a standard price adjustment within guardrails
Guided
Trigger: standard

Step-by-step review flow with explanations and comparisons

StepIndicator
AnalysisPanel
ImpactChart
ApprovalForm
Example: Reviewing a reorder recommendation with supplier options
Escalation
Trigger: high_impact_or_exception

Full detail view with risk warnings and multi-level approval

RiskBanner
DetailTabs
ComparisonTable
EscalationChain
AuditTrail
Example: Approving a credit decision that exceeds normal limits

Blueprint Structure

The backend generates a JSON blueprint that describes the UI structure:

{
  "blueprintId": "bp_abc123",
  "decisionId": "dec_xyz789",
  "layoutMode": "guided",
  "components": [
    {
      "type": "StepIndicator",
      "props": {
        "steps": ["Review", "Impact", "Approve"],
        "currentStep": 0
      }
    },
    {
      "type": "AnalysisPanel",
      "props": {
        "factors": [...],
        "confidence": 0.94
      }
    },
    {
      "type": "ImpactChart",
      "props": {
        "metric": "margin",
        "baseline": 28,
        "projected": 34
      }
    },
    {
      "type": "ApprovalForm",
      "props": {
        "requiresComment": false,
        "actions": ["approve", "reject", "modify"]
      }
    }
  ],
  "visibility": {
    "operator": ["StepIndicator", "AnalysisPanel"],
    "manager": ["StepIndicator", "AnalysisPanel", "ImpactChart", "ApprovalForm"]
  },
  "auditContext": {
    "generatedAt": "2024-01-15T10:30:00Z",
    "userId": "usr_123",
    "sessionId": "sess_456"
  }
}

Component Whitelist

A2UI uses a fixed set of approved components. Custom components are not supported to ensure security and audit compliance.

ComponentDescription
DecisionCardSummary card with headline, agent, and confidence
QuickApproveBarOne-click approve/reject for low-risk decisions
StepIndicatorProgress indicator for guided flows
AnalysisPanelAI reasoning and factor breakdown
ImpactChartVisual representation of expected outcomes
ComparisonTableBefore/after or option comparison
RiskBannerWarning banner for high-risk decisions
EscalationChainMulti-level approval workflow display
AuditTrailChronological log of all decision actions

Role-Based Visibility

Different user roles see different components. The blueprint defines visibility rules that the frontend enforces:

RoleCan SeeCan Do
ViewerDecision summary, basic analysisView only
OperatorFull analysis, impact chartsComment, request escalation
ManagerAll components including audit trailApprove, reject, modify
AdminEverything + system metadataAll actions + configure rules

Audit Logging

Every A2UI interaction is logged for compliance and debugging:

  • Blueprint Generation: When and why a blueprint was created
  • Component Render: Which components were shown to which user
  • User Interaction: Clicks, form submissions, navigation
  • Decision Actions: Approve, reject, modify with timestamps

For Fintech and Lending domains, audit logs are retained according to regulatory requirements and can be exported for compliance reviews.

Deterministic Rendering

A2UI guarantees that the same blueprint renders identically every time. This is critical for:

  • Audit Replay: Regulators can see exactly what a user saw
  • Debugging: Reproduce issues by replaying the blueprint
  • Testing: Consistent UI for automated testing

Integration with Human-in-the-Loop

A2UI is the visual layer for Decisio'sHuman-in-the-Loop system. When a decision requires human approval:

  1. Backend flags the decision for review
  2. Blueprint Builder generates an appropriate layout
  3. A2UI renders the review interface
  4. User takes action (approve/reject/modify)
  5. Action is logged and decision is updated

Customization

While components are fixed, enterprises can customize:

  • Branding: Logo, colors, fonts via theme settings
  • Layout Rules: When to use Fast Path vs Guided vs Escalation
  • Role Mappings: Map your org roles to A2UI roles
  • Component Defaults: Default props for components

Contact your account manager for custom A2UI configuration.