Blueprints

A Blueprint is a reusable AI solution that groups related resources - bots, datasets, skillsets, and integrations - into a single named package. Blueprints make it easy to organize complex AI systems, share them across your account, and build multi-agent workflows where different agents collaborate to achieve a goal.

What a Blueprint Contains

A blueprint can include any combination of:

• Bots - AI agents with backstories, model settings, and behaviors
• Datasets - Knowledge bases that provide context for your bots
• Skillsets - Collections of abilities and actions your bots can perform
• Integrations - Channels and services your bots connect to, including web widgets, Slack, Discord, Microsoft Teams, Google Chat, WhatsApp, Messenger, Instagram, Telegram, email, triggers, sitemaps, Notion, and MCP servers
• Files and Secrets - Supporting resources attached to the blueprint

Resources inside a blueprint are connected visually. For example, a bot connects to a dataset for knowledge retrieval, and to a skillset for abilities. These connections are reflected in the Blueprint Designer as edges between nodes.

The Blueprint Designer

Each blueprint has a visual designer you can open by clicking Design on the blueprint page. The designer is a drag-and-drop canvas where you build and configure your blueprint by placing resource nodes and drawing connections between them.

Adding Resources

The designer's left-side panels give you access to everything you can add:

• Resources - Core resource types (bots, datasets, skillsets, files, secrets) and all integration types, plus annotation frames and tools
• Abilities - Reusable actions grouped by provider that extend what your bots can do
• Packs - Bundled groups of abilities you can add together in one step
• MCP - Model Context Protocol resources and server connectors
• Examples - A gallery of curated blueprint examples you can use as a starting point
• Orphans - Resources linked to the blueprint in the database but not yet placed on the canvas
• Secrets - Template secrets and starter values you can reference inside the blueprint
• Events - A live view of recent blueprint activity without leaving the designer
• Assistant - An AI-powered assistant that can inspect, edit, and validate your blueprint for you

Organizing the Canvas

You can drag resource nodes around the canvas to lay them out clearly. Use Frames to create labeled visual groups that keep related nodes together. Frames stay behind other nodes and can be resized to fit your layout.

Blueprint YAML

Every blueprint has an underlying YAML representation. You can download the blueprint as a YAML file from the designer toolbar, which is useful for backup, version control, or sharing. The YAML format lists all resource nodes, their types, configuration properties, and the connections between them.

Configuration Options

When you create or edit a blueprint, you can set:

• Name - A human-readable label for the blueprint
• Description - Notes on what the blueprint does and how to use it
• Alias - An optional short identifier (lowercase letters, numbers, hyphens, underscores) that lets you reference the blueprint using @alias syntax elsewhere in your workflows
• Visibility - Controls who can access the blueprint:
  • Private - accessible only to you
  • Protected - accessible to you and all sub-accounts under your account

Cloning Blueprints

Click Clone on a blueprint to create an independent copy. Cloning is useful for experimenting with variations of a working setup or repurposing an existing blueprint for a new project without affecting the original.

Getting Started

1. Go to Blueprints in your dashboard and click Create Blueprint
2. Give the blueprint a name and description
3. Click Create, then open the Design view
4. Use the left panel to drag bots, datasets, skillsets, and integrations onto the canvas
5. Draw connections between nodes to reflect how resources work together
6. Configure each node by selecting it and filling in the settings panel

If you want to start from a working example, open the Examples panel inside the designer and insert a curated blueprint to see a complete setup you can customize.