CapsulAI

Activating AI features

When your prompt contains words like "AI", "chatbot", "smart", or "intelligent", Capsul detects AI intent and asks if you want to enable AI features. You can:

• • Pick a template — pre-configured patterns for chat assistants, content generators, document Q&A, etc.
• • Build without template — AI features are still active, the AI builds exactly what you described.

Once active, window.CapsulAI is injected into the app and a "✨ Capsul AI" badge is shown in the bottom-right corner.

API Reference

const summary = await window.CapsulAI.complete(
  'Summarise this text in 2 sentences: ' + articleText
);

const reply = await window.CapsulAI.chat([
  { role: 'system', content: 'You are a friendly cooking assistant.' },
  { role: 'user',   content: 'What can I make with chicken and rice?' },
]);

{
  model: 'llama-3.3-70b-versatile',  // defaults to fast Groq model
  provider: 'groq'                    // 'groq' | 'openrouter' | 'nvidia'
}

Structured output (JSON)

CapsulAI returns plain text. For structured data, ask the AI to reply in JSON inside your prompt, then parse the response:

// Recipe generator example
const raw = await window.CapsulAI.complete(
  `Generate a recipe for "${recipeName}" for ${servings} people.
   Reply ONLY with valid JSON, no markdown fences, no explanation:
   {
     "ingredients": [{ "item": "...", "quantity": "..." }],
     "instructions": ["step 1...", "step 2..."],
     "prepTime": "20 minutes",
     "calories": "450 per serving"
   }`
);

// Parse — with fallback regex for models that add extra text
let recipe;
try {
  recipe = JSON.parse(raw);
} catch {
  const match = raw.match(/\{[\s\S]*\}/);
  recipe = match ? JSON.parse(match[0]) : null;
}

if (recipe) renderRecipe(recipe);
else showError('Could not parse recipe — try again');

Best practices

• ►Always show a loading state — CapsulAI calls take 1–5 seconds. Show a spinner or skeleton so the user knows something is happening.
• ►Handle errors gracefully — Wrap in try/catch and show a friendly "AI unavailable — try again" message with a retry button.
• ►Pass user inputs directly — Never use generic placeholders. If the user typed "Spaghetti Bolognese" into a field, include that exact string in the prompt.
• ►Save results to CapsulDB — Store AI-generated results so users can revisit past generations without spending another AI call.

AI Templates

When AI intent is detected, you can choose a pre-configured template that adds detailed instructions to the system prompt: