// NODE_BUILDER

Aivyx Specialist Builder

Design an individual worker agent. Define its execution profile, select an archetype, and provision its core capabilities and MCP enterprise integrations.

Choose a Worker Archetype

Start with a pre-configured enterprise archetype or build a custom node.

External Integrations

Link Local Template

🗂 Workspace

Bind this node to a custom agent template defined locally within your environment.

Import from Hub

🌐 Blueprint

Download and connect a centralized community agent blueprint from Aivyx Hub.

Import config.toml

📄 Config

Load an existing ~/.aivyx/config.toml to edit visually in the wizard, then re-export.

⬆ Drag & drop config.toml here or click to browse

Execution Profile

Define the node name, cognitive constraints, and system directives for this specialized worker.

🆔
Core Identity
Lowercase letters, digits, hyphens only
0 / 50,000
Define deterministic rules, acceptable outputs, and operational constraints
🧠
Cognitive Architecture
The model Ollama will auto-pull when provisioning this agent. Users can override at runtime.
Terse Balanced Verbose
⚙️
Autonomous Operations
Controls how independently the agent executes actions on your behalf
Allow background synchronization with the ecosystem messaging bus
Context window output hard limit
Enable automatic contextual tool discovery mechanisms
Visible tools per LLM call when embedding mode is active

Attach MCP Servers

Select the tools your agent can use. MCP servers connect your agent to external services and data sources.

Add Custom MCP Server

Skills & Capabilities

Configure what your agent can do. System capabilities control access; agent skills define behavior.

⚡ System Capabilities

🤖 Agent Skills

📊 Data & Analysis

✨ Creative & Content

🛡️ Operations & Security

Add Custom Skill / Tool

Ecosystem Integration

Assign specific Factory Recipes that this specialist should be authorized to execute autonomously.

External Integrations

Link Local Recipe

🗂 Workspace

Bind this node to a custom recipe defined locally within your environment.

Import from Hub

🌐 Blueprint

Download and connect a centralized community orchestrator from Aivyx Hub.

Agent Intelligence

Configure autonomous background intelligence — heartbeat behaviour and recurring task schedules that run independently of user interaction.

💓
Heartbeat Intelligence
Autonomous background processes that run every tick
Run autonomous background processes on a timer
How often the heartbeat cycle runs
🗓
Recurring Schedules
Cron-driven prompts the agent executes autonomously on a timer
⏱
No schedules defined. Add one to give your agent recurring autonomous tasks.
Example: Daily briefing at 08:00, weekly report on Fridays

Preview & Export

Review your agent configuration and export it.

Generated TOML

Agent Summary

Name: —
Template: —
MCP Servers: —
Skills: —
Factories: —
Model: —
Heartbeat: —
Schedules: —

Next Steps

  1. Download the profile.toml
  2. Place it at ~/.aivyx/agents/<name>/profile.toml
  3. For Aivyx-PA users, ensure this agent is referenced or linked.
  4. Restart your Aivyx engine to mount the new object.