Engines

Engines are the LLMs that power your agents. Each agent uses two engines, a main engine and a secondary engine, selected during agent creation. You can modify engine assignments anytime as your needs change.

​

Main Engine

The main engine handles direct task execution on your systems: navigating filesystems, reading and modifying files, interacting with services via CLI or MCP, executing commands, and managing configurations. This engine does the computational heavy-lifting and requires large context handling, high accuracy, and precise function calling. It typically consumes the most tokens due to the substantial context needed for reliable execution.

​

Secondary Engine

The secondary engine handles orchestration and oversight to improve main engine accuracy.

​

Available Models

The engines available to your agents come from your tenant’s model catalog, managed in Command Center under Settings > Models. Each model in the catalog carries its own context length, pricing, and capabilities. See Models & Providers for how to add providers, enable models, and set the tenant defaults.

​

Context Length

Different LLMs handle varying context sizes with different reliability levels. Larger context windows reduce hallucinations when processing extensive data but cost more tokens. Each model’s context length is shown in the catalog under Settings > Models, and you should match the model to your workload: larger windows suit large files, extensive codebases, and complex multi-step operations, while smaller windows are fine for simple tasks but call for more frequent task archiving.

​

Task Archiving

Archiving removes task history from an agent’s context window, preventing overflow without reinitializing the agent. Archive all tasks: Select your agent → Archive all tasks Archive individual tasks: Open the task → Archive Task View history: Default view shows current tasks. Toggle Show archived tasks to review cleared history. When approaching context limits but needing to preserve specific context, archive only unrelated tasks while keeping relevant history intact.

​

Modifying Engines

You can change engines without completely reinitializing your agent:

1. Right-click the agent → Edit Agent
2. Choose new engines for main and secondary roles
3. Optionally clear task history, update the agent’s specialty, or modify credentials

Full resets: If you notice performance issues, consider changing engines and clearing context simultaneously for a fresh start. Some inference providers or LLM families excel at specific task types.

​

Engine Availability

The model catalog is managed at the tenant level and available across all organizations. Any agent in any organization can use any enabled model in the catalog. To add, enable, or disable the models your agents can pick, see Models & Providers.

​

Best Practices

Match engines to your workload, using higher-context models for complex, file-heavy operations. Monitor token usage to optimize cost versus performance, and test different main/secondary pairings for specific use cases. Archive proactively rather than waiting for context limits. Clear irrelevant history regularly. Document which engine combinations work best for different task types, and balance model power against operational expenses based on task criticality.

​

Choosing Engines

Consider these factors: Task complexity: More complex operations benefit from higher-capability main engines. File sizes: Large codebases or config files need substantial context windows. Accuracy requirements: Critical operations warrant premium models despite higher costs. Provider ecosystem: Some tasks benefit from specific provider capabilities like function calling implementations.