Integration Patterns

Learn how to structure your sub-projects and organize data for different types of integrations with AgentisPro RAG Engine.

Overview

AgentisPro RAG Engine supports various integration patterns depending on your use case:

Pattern	Use Case	Example
Website Crawl	Static websites, landing pages	Teknic SRL
Web App + Supabase	SaaS with user-generated content	VoxAcademic
Complex App	Multi-entity apps with DB + Storage	FleetManager
Mobile App	Per-user isolated RAG contexts	Consumer apps
Multi-tenant SaaS	B2B platforms with client isolation	Enterprise tools

Key Concepts

Sub-Projects (Folders)

Organize your content into sub-projects for better organization and targeted queries:

your-org/
├── marketing/      → Website content, blog posts
├── products/       → Product documentation
├── support/        → FAQ, troubleshooting guides
└── internal/       → Internal policies, procedures

Context Inheritance

Control how queries search across sub-projects:

{
  "name": "Products",
  "org_id": "acme-products",
  "parent_id": "acme-corp",
  "inherit_context": true  // Queries also search parent
}

inherit_context: true → Query searches this + parent projects
inherit_context: false → Query searches only this project (isolated)

API Key Scoping

Each API key can be scoped to specific sub-projects:

{
  "name": "Marketing Bot API Key",
  "scopes": ["read", "query"],
  "org_id": "acme-marketing"  // Only accesses marketing content
}

Choose Your Pattern

Website Crawl

Crawl and index static websites with automatic sub-project organization

Web App + Supabase

Integrate with Supabase-backed applications via webhooks

Complex App

Multi-level hierarchies for complex business applications

Mobile App

Per-user RAG contexts for mobile applications

Multi-tenant SaaS

B2B platforms with complete client isolation

Quick Start

1. Create Your Organization

curl -X POST "https://ragengine.agentispro.com/projects" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "org_id": "acme-corp",
    "type": "organization"
  }'

2. Create Sub-Projects

curl -X POST "https://ragengine.agentispro.com/projects" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Products",
    "org_id": "acme-products",
    "parent_id": "acme-corp",
    "type": "folder",
    "inherit_context": true
  }'

3. Index Content

curl -X POST "https://ragengine.agentispro.com/documents/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@product-manual.pdf" \
  -F "org_id=acme-products"

4. Query

curl -X POST "https://ragengine.agentispro.com/query" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How do I install the product?",
    "mode": "hybrid"
  }'