Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

2.3 KB
Raw Blame
---
title: "Agent modes"
description: "Choose from four agent modes: fixed agent, agent library, agent composer, or library + composer."
---

This can be configured by using the `agentConfig` object.

```ts
type AgentConfig =
  | { mode: "SingleAgent"; name: string } //name is agent name
  | { mode: "AgentLibrary" }
  | { mode: "AgentComposer" } //Composer is agent creation flow
  | { mode: "AgentLibraryWithComposer" }; //Default mode
```

| Mode | Library | Composer | New chat |
| --- | --- | --- | --- |
| `SingleAgent` | — | — | Yes |
| `AgentLibrary` | Yes | — | No |
| `AgentComposer` | — | Yes | Yes |
| `AgentLibraryWithComposer (Default)` | Yes | Yes | Yes |

## Single Agent

All conversations use a single named agent configured through the name parameter. Agent selection controls are hidden, so users cannot switch agents or open the agent composer.

<Frame>
  ![Single Agent 1](/images/single-agent-1.png "Single Agent 1")
</Frame>

## AgentComposer

Users can create a new agent by selecting a model, skills, and MCP servers, then save the configured agent to the library for future use. The composer Tools menu stays focused on connectors and skills. Agent Config opens the full draft editor for model parameters, instructions, runtime behavior, MCP tool selection, and skills.

Agent Config changes apply to the active draft immediately. The Save Agent dialog keeps an independent working copy of the same fields and reuses the same model, MCP, and skill pickers; cancelling that dialog discards only its local changes. Model limits and pricing are shown when the configured server provides them.

<Frame>
  ![Agent Composer 1](/images/agent-composer-1.png "Agent Composer 1")
</Frame>

## AgentLibrary

Users can chat with agents already saved in the library but cannot create new agents. The “New Chat” option is disabled in this mode, making it ideal for restricting agent creation while still allowing users to use existing agents.

<Frame>
  ![Agent Library 1](/images/agent-library-1.png "Agent Library 1")
</Frame>

## AgentLibraryWithComposer

Users can choose an existing agent from the library or create a new agent using the composer.

<Frame>
  ![Agent Library With Composer 1](/images/agent-library-with-composer-1.png "Agent Library With Composer 1")
</Frame>