Core Concepts
Start with the conceptual pillars, then jump into Operate or Build apps for how-to steps.
Assistants & tenancy
| Concept | Summary | Read more |
|---|---|---|
| AI Workspace | Isolation unit for knowledge, tools, conversations | What is an AI Workspace? |
| Customer AI vs Employee AI | External channels vs Internal Portal | Customer vs Employee |
| Knowledge / Hybrid RAG | Grounded answers with citations | Hybrid RAG |
| RBAC | Owner / Admin / Member + teams | RBAC |
Two different “SDK” stories
Do not confuse these:
| Concept | What it is | Read more |
|---|---|---|
| SDK Connection (Business Tools) | Signed webhook to your backend; tools registered as Business Tools | Backend SDK |
| SDK app (installable) | Managed /qefro package from Marketplace; the process is the app | Managed apps · Build your first app |
Canonical entry for shipping apps: Build your first app
(warehouse-pro is the scaffold id; vertical examples like restaurant-pro
are reference packages).
Platform capabilities used by apps
| Concept | Summary | Read more |
|---|---|---|
| Customer Hub / People | Shared people identity; portal nav People; ctx.customer | People · Customer Hub |
| Marketing | Apps register audiences/variables; platform owns send | Marketing |
| Organization workflows | Opaque capabilities + Internal Inbox tasks | Organization workflows |
| Managed storage | ctx.storage → storage-service / Mongo | Managed storage |
| Marketplace | Publish signed packages; tenants install/upgrade | Marketplace |
Actions & runtime
| Concept | Summary | Read more |
|---|---|---|
| Business Tool / Action | Secure call into your systems | Business Actions |
| Business Flow | Declarative multi-step orchestration | Define flows |
| Runtime / FlowRunner | Single execution engine | Runtime |
| Orchestration event | Namespaced bus envelope | Events |
| Session | Channel + conversation context | Sessions |
| vs n8n / LangGraph | Product boundaries | n8n · LangGraph |
Full term list: Glossary.