> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaireonai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> KaireonAI is a Next-Best-Action platform that decides what to recommend, to whom, through which channel — in real time.

Every customer interaction is an opportunity. The challenge is picking the *right* offer from dozens of options, personalizing it for the individual, and delivering it through the channel most likely to convert — all in milliseconds. KaireonAI is a Next-Best-Action decisioning platform that does exactly this, combining data ingestion, offer management, ML scoring, and real-time ranking into a single decisioning system.

<Note>
  One API call returns the single best offer or message for a specific customer in the moment — ranked by your goals, filtered by your eligibility and contact rules — and it learns from every outcome. KaireonAI is a proprietary, fully hosted SaaS. Start free on the [hosted Playground](https://playground.kaireonai.com/register), then move to a paid plan when you are ready to go live.
</Note>

**Why teams pay for it:** more revenue per interaction; live in weeks, not years (it is a focused decisioning API, not a seven-figure suite); it improves itself from every outcome; and every decision is governed and explainable.

***

## The Problem KaireonAI Solves

Most companies have offers, campaigns, and messages spread across disconnected tools. Email marketing knows about promotions. The app team has banners. The call center has scripts. Nobody is coordinating *which* customer should see *which* offer *when*. The result: customers get irrelevant recommendations, miss time-sensitive offers, or get bombarded on every channel at once.

KaireonAI replaces this fragmented approach with a single decision engine that evaluates every eligible offer for each customer, scores them using ML models, and returns the best options ranked by a combination of propensity, business value, relevance, and priority.

***

## See It in Action: A Retail Rewards Program

Imagine you operate a retail rewards program. You have 10 offers — BOGOs, discounts, and informational messages — and 6 channels: web, email, mobile push, social, batch email, and manual outreach. When a customer opens the app, which offer should they see?

**Without KaireonAI:** You show the same "20% off your next order" banner to everyone, regardless of whether they prefer one product line over another, already redeemed a discount today, or typically only respond to BOGO offers.

**With KaireonAI:** The Recommend API evaluates all 10 offers for this specific customer, filters out anything they have already seen this week (contact policies), scores the rest using a trained model that considers their purchase history and income level, and returns the top 3 — personalized, ranked, and ready to display.

```bash theme={null}
curl -X POST http://localhost:3000/api/v1/recommend \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust-001",
    "channel": "Mobile",
    "attributes": { "age": 30, "income": 75000 },
    "limit": 3
  }'
```

The response includes scored, ranked offers with creative content ready for rendering:

```json theme={null}
{
  "count": 3,
  "decisions": [
    { "offerName": "BOGO Signature Beverage", "score": 0.85, "rank": 1, "channelName": "Mobile" },
    { "offerName": "25% Off Merchandise", "score": 0.72, "rank": 2, "channelName": "Mobile" },
    { "offerName": "Earn 3x Points This Week", "score": 0.68, "rank": 3, "channelName": "Mobile" }
  ],
  "meta": {
    "totalCandidates": 60,
    "afterQualification": 12,
    "afterSuppression": 10,
    "afterContactPolicy": 8,
    "degradedScoring": false
  }
}
```

<Tip>
  The sample retail dataset ships as built-in sample data. Load it in **Settings > Sample Data** and follow the [full tutorial](/get-started/walkthrough) to build this from scratch.
</Tip>

***

## Key Capabilities

<CardGroup cols={2}>
  <Card title="Real-Time Decisioning" icon="bolt">
    The Recommend API evaluates, scores, and ranks offers in under 200ms. Every request runs through enrichment, qualification, contact policies, ML scoring, and ranking — no pre-computation required.
  </Card>

  <Card title="PRIE Ranking" icon="scale-balanced">
    The multiplicative PRIE formula (Propensity x Relevance x Impact x Emphasis) produces a single score from four dimensions. A zero in any dimension eliminates the candidate — no irrelevant high-value offers sneak through.
  </Card>

  <Card title="9 Scoring Engines" icon="brain">
    From transparent scorecards (no training data needed) to neural collaborative filtering (learns latent preferences from interaction data). Start simple, upgrade without changing your Decision Flows.
  </Card>

  <Card title="Omnichannel Delivery" icon="paper-plane">
    Email, push, SMS, in-app, web, WhatsApp, webhook, and direct mail — all managed from one platform. Contact policies enforce frequency caps per channel so you never over-contact.
  </Card>

  <Card title="Visual Pipeline Editor" icon="diagram-project">
    Decision Flows are built on a drag-and-drop canvas with 16 composable node types across 3 phases: Narrow, Score & Rank, and Output. No code required.
  </Card>

  <Card title="Built-In Experimentation" icon="flask">
    Champion/challenger testing with holdout groups, deterministic traffic splitting, uplift calculation (z-test), and optional auto-promotion. Measure real impact before rolling out changes.
  </Card>

  <Card title="80+ Data Connectors" icon="database">
    Ingest customer data from S3, GCS, Azure Blob, Snowflake, BigQuery, Databricks, Postgres, Kafka, Kinesis, Pulsar, SFTP, HTTP, and more — across batch, streaming, file, and HTTP source kinds. Build visual ETL pipelines with 19 built-in transform types.
  </Card>

  <Card title="Five Monitoring Dashboards" icon="chart-line">
    Operations, Business, Data Health, Model Health, and Attribution dashboards with real-time metrics, Prometheus integration, and actionable alerts.
  </Card>

  <Card title="LLM Explanations" icon="sparkles" href="/ai-ml/explanations">
    Turn any decision trace into a written explanation in three modes — regulator, agent, or customer. PII-redacted, cached per tenant, audit-logged for regulator mode.
  </Card>

  <Card title="Governed AI Layer" icon="robot">
    A built-in assistant, Decisioning Autopilot, and Decision Sentinel work the setup for you — but under governance. Every write and every autopilot proposal is previewed and queued for approval; Sentinel can auto-pause an unhealthy flow. Nothing changes production without a human in the loop.
  </Card>
</CardGroup>

***

## Platform Architecture

```mermaid theme={null}
graph TD
    subgraph platform["KaireonAI"]
        DATA["Data Platform"] --> STUDIO["Decisioning Studio"]
        STUDIO --> ALGO["Algorithms & Models"]
        DATA --> DASH["Dashboards"]
        STUDIO --> DASH
        ALGO --> DASH
    end

    style platform fill:#1e1b4b,stroke:#6366f1,color:#e0e7ff
    style DATA fill:#0c4a6e,stroke:#38bdf8,color:#e0f2fe
    style STUDIO fill:#312e81,stroke:#818cf8,color:#c7d2fe
    style ALGO fill:#312e81,stroke:#818cf8,color:#c7d2fe
    style DASH fill:#065f46,stroke:#10b981,color:#d1fae5
```

| Module                  | What It Does                              | Key Features                                                                                                                                        |
| ----------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data Platform**       | Ingests and transforms customer data      | 4 working ingestion connectors (S3, GCS, Azure Blob, SFTP) of 80 registered types, entity schemas with real PostgreSQL tables, visual ETL pipelines |
| **Decisioning Studio**  | Configures what you can recommend and how | Offers, categories, creatives, decisioning gates, contact policies, Decision Flows                                                                  |
| **Algorithms & Models** | Scores and ranks candidates using ML      | 9 scoring engines, experiments, champion/challenger, auto-learning                                                                                  |
| **Dashboards**          | Monitors everything in real time          | Operations, business KPIs, data health, model health, attribution                                                                                   |

<Card title="Architecture Deep Dive" icon="sitemap" href="/self-host/architecture/overview">
  Decision engine internals, data pipeline design, infrastructure adapters, and security model.
</Card>

***

## Start Here

<CardGroup cols={3}>
  <Card title="Try the Playground" icon="circle-play" href="https://playground.kaireonai.com/register">
    Start a free trial and explore the platform instantly — no setup, no credit card, no commitment.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first recommendation on the free tier in five minutes.
  </Card>

  <Card title="Retail Rewards Tutorial" icon="play" href="/get-started/walkthrough">
    Build a complete decisioning pipeline step by step using a sample retail rewards dataset.
  </Card>
</CardGroup>