Introduction
Ilana AI is an AI Distribution Platform — a B2B SaaS that lets organizations safely distribute AI-powered experiences to external partners and customers. Partners can build any kind of frontend — chat, search bars, form assistants, command palettes — while Ilana's governance engine enforces what the AI can and cannot do.
Core Abstractions
Capability Profiles
Define what an AI can access — intents, data sources, schemas, and disclaimers. Capability Profiles set the ceiling for what the AI is allowed to do.
Personas
Define how an AI responds — tone, constraints, escalation triggers. Personas shape the AI's behavior within the limits set by the Capability Profile.
Mental model: Capability Profiles define the ceiling. Personas define the shape.
Integration Paths
| Method | Best For | Package |
|---|---|---|
| TypeScript SDK | BYOFE — build any custom UI | @ilana/sdk |
| React SDK | BYOFE for React/Next.js apps | @ilana/react |
| Embed Widget | Drop-in chat widget, zero custom code | <script> tag |
Bring Your Own Frontend (BYOFE)
The SDK and React packages are designed for partners who want full control over their UI. You build the interface — chat, search, forms, tooltips, whatever fits your product — and Ilana handles governance, intent classification, and response generation behind the scenes.
Every response includes governance metadata (whether the query was allowed, enforcement reasons, schema validation results) so you can build UIs that are aware of the governance layer.
Embed Widget
The embed widget is the zero-code path. Drop a <script> tag on any page and get a fully functional chat interface with theming, conversation management, and governance built in. No custom frontend required.
How It Works
- An admin configures an agent with a persona and Capability Profile in the admin portal
- The admin adds partner domains that are allowed to use the agent
- Partners integrate via SDK (BYOFE) or embed widget with a domain-scoped embed token
- When a user interacts, the runtime validates the token, classifies the intent, fetches data from the Capability Profile's data sources, and generates a governed response
- The response includes governance metadata that BYOFE partners can use to build context-aware UIs
Next Steps
- Quickstart — Build a governed search UI in under 5 minutes
- SDK Reference — Full TypeScript SDK documentation (BYOFE)
- React Reference — React hooks and provider (BYOFE)
- Embed Widget — Drop-in chat widget
- API Reference — Raw HTTP API documentation