Core Concepts

qRaptor organizes your work into a clear hierarchy. Understanding these concepts helps you navigate the Studio confidently.

Subscription

A subscription is your billing and isolation boundary. Every resource you create belongs to exactly one subscription. Your data is completely isolated — never visible to other subscribers.

Each subscription is tied to a plan (Free, App Lite, Starter, Pro, Team, or Enterprise) that determines features, credits, and team size.

Project

A project groups related agents, apps, data, tools, and deployments. Think of it as a container for a single product or initiative. You can have multiple projects per subscription (the number depends on your plan).

Inside a project, you find:

Section	What it contains
Agentic Workspace	Agents, MAS Systems, Agent Personas, Agent Tools
Apps	Generated web apps, mobile apps, and copilots
Data Vault	Tables, documents, content stores, memory
Deployments	Preview and production environments
Configuration	LLM policies, settings, integrations
Teams	Project members and role assignments
Security	RBAC and custom roles

Agents

An agent is an AI-powered execution unit. You build agents visually on a drag-and-drop canvas. qRaptor supports two agent types:

Task Agent

A Task Agent executes a defined workflow as a graph of steps. You connect nodes (start → tools → logic → output) to build deterministic pipelines. Ideal for structured processes: data extraction, form processing, scheduled jobs, and multi-step automations.

AI Agent

An AI Agent is conversational and autonomous. It reasons about requests, uses tools, accesses memory, and responds in natural language. You configure its persona, tool access, and knowledge — then it handles conversations intelligently. Ideal for customer support, sales assistants, and interactive copilots.

Multi-Agent Systems (MAS)

A MAS coordinates multiple agents working together. You choose an orchestration pattern:

Pattern	How it works
Router-Specialists	A router classifies intent and delegates to specialist agents
Planner-Executor-Verifier	Plan a strategy, execute it, then verify results
Hierarchical	A supervisor delegates to workers with authority levels
Debate-Judge	Multiple agents debate; a judge synthesizes the answer
Map-Reduce	Distribute work across agents, then merge results
ReAct	Reason and act iteratively until the goal is met

Apps (Application Dev Engine)

Apps are full-stack applications generated from natural language descriptions. The platform pipeline works in visible stages:

Prompt → Requirements → App Graph → Code → Auto-Fix → Iterate

You can generate:

Web apps — React full-stack applications
Mobile apps — React Native / Expo applications
Copilots — Embeddable AI chat widgets powered by your agents

Each app has its own workspace with code editor, live preview, build status, and App Context Graph.

Data Vault

The Data Vault is your secure data layer:

Tables — Structured data with schema design, ER diagrams, and a query explorer.
Documents — File storage for uploads, exports, and attachments.
Content Stores — Vector stores for RAG (retrieval-augmented generation). Your agents search these for relevant knowledge.
Memory — Three tiers of agent memory:
- Profile — Remembers user preferences across conversations.
- Episodic — Recalls what happened in past sessions.
- Semantic — Self-learned knowledge the agent discovers over time.

Nodes

A node is a single step in an agent’s graph. qRaptor provides 30+ node types across categories:

Flow Control — Start, End, Condition, Switch, Loop, Parallel, Merge
AI / LLM — LLM Task, Quick Prompt, Planner, Router, Reflector, Evaluator
Data — Query Table, Insert Row, Update Row, Delete Row
Tools — Tool Call, HTTP API, Code (Python), MCP Connector
Memory — Memory Read, Memory Write
RAG — Search Content Store, Reindex Content Store
Human-in-the-Loop — Human Gate (sync or async approval)
Communication — Email, SMS, WhatsApp

Channels

A channel is where end-users interact with your deployed agents:

Channel	Description
Web	Chat widget embedded in your app or site
WhatsApp	Business API integration
Voice	Phone calls with speech-to-text and text-to-speech
Teams	Microsoft Teams integration
Slack	Slack workspace integration
API	Programmatic REST access
A2A	Agent-to-Agent protocol (agents calling other agents)

Deployments

A deployment publishes your agents or apps so they can serve live traffic.

Preview — A safe sandbox for testing. Only your team can access it.
Production — The live environment at yourapp.qraptor.app serving real users.

The deployment wizard lets you select agents, pin versions, configure schedules, and review credit costs before going live.

Tools & Integrations

Tools extend what your agents can do. qRaptor provides 40+ built-in tools (web search, database queries, document processing, vision, audio, and more) plus:

MCP Servers — Connect to any Model Context Protocol server for additional tool access.
Custom HTTP tools — Define your own API integrations per project.
Agent-as-Tool — Call any Task Agent as a tool from within an AI Agent.

Versions

Every agent change creates a new version — an immutable snapshot of the graph, configuration, and tools. You choose which version to deploy and can roll back at any time.

💡

Versioning is automatic. Save your changes, and a new version is created. You always control which version is live.

How it all fits together


Subscription (billing + isolation)
└── Project (product boundary)
    ├── Agentic Workspace
    │   ├── AI Agents (conversational, autonomous)
    │   ├── Task Agents (workflow graphs)
    │   ├── MAS Systems (multi-agent coordination)
    │   └── Agent Personas & Tools
    ├── Apps (generated web/mobile/copilot apps)
    ├── Data Vault (tables, docs, content stores, memory)
    ├── Deployments (preview / production)
    ├── Configuration (LLM policies, settings)
    └── Integrations & Channels

Next steps

Platform Overview — See the full platform at a glance.
Create your account — Start building.