> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Builder

> Create and edit agents by describing what you want in natural language. The Agent Builder chat configures instructions, knowledge, actions, and more from your description.

## What is the Agent Builder?

The Agent Builder is a chat interface for creating and editing agents. Instead of filling out the configuration fields manually, you describe what the agent should do, and the builder configures it for you. You can refine the result by continuing the conversation or by editing the configuration fields directly at any time.

## Creating an agent with the builder

1. Navigate to **Agents** in the sidebar and click **Create agent**. The builder chat opens.

<Frame>
  <img src="https://mintcdn.com/langdock-34/MMMmmnP6mj4Cc4Ja/images/agent_builder1.png?fit=max&auto=format&n=MMMmmnP6mj4Cc4Ja&q=85&s=49ce0a57992593ad9b2be863c69f227a" alt="Sidebar navigation with the Agents entry highlighted" style={{borderRadius: '6px'}} width="1840" height="684" data-path="images/agent_builder1.png" />
</Frame>

2. Describe what the agent should do, for example "An agent that answers onboarding questions for new employees based on our handbook."

<Frame>
  <img src="https://mintcdn.com/langdock-34/MMMmmnP6mj4Cc4Ja/images/agent_builder2.png?fit=max&auto=format&n=MMMmmnP6mj4Cc4Ja&q=85&s=c52d612fdf62800eafc8b02425dd008a" alt="Build a new agent screen with an agent description entered in the prompt field" style={{borderRadius: '6px'}} width="1840" height="802" data-path="images/agent_builder2.png" />
</Frame>

3. Answer the builder's clarifying questions to help it refine the agent plan.

<Frame>
  <img src="https://mintcdn.com/langdock-34/MMMmmnP6mj4Cc4Ja/images/agent_builder3.png?fit=max&auto=format&n=MMMmmnP6mj4Cc4Ja&q=85&s=27b2578e1850ca413729f8f71f16f001" alt="Builder chat asking a clarifying question about the knowledge source with selectable answer options" style={{borderRadius: '6px'}} width="1838" height="1514" data-path="images/agent_builder3.png" />
</Frame>

4. Click **Ask for edits** to adjust the plan first, or click **Start building** to apply the plan.

<Frame>
  <img src="https://mintcdn.com/langdock-34/MMMmmnP6mj4Cc4Ja/images/agent_builder4.png?fit=max&auto=format&n=MMMmmnP6mj4Cc4Ja&q=85&s=0149a64eadf2a258c2d8f8438db5c18f" alt="Agent plan proposal with Ask for edits and Start building buttons" style={{borderRadius: '6px'}} width="1836" height="876" data-path="images/agent_builder4.png" />
</Frame>

5. The builder configures the agent and opens the configuration editor next to the chat so you can review the result.

<Frame>
  <img src="https://mintcdn.com/langdock-34/MMMmmnP6mj4Cc4Ja/images/agent_builder5.png?fit=max&auto=format&n=MMMmmnP6mj4Cc4Ja&q=85&s=5caa7d5eca4abe020c0039d146be754e" alt="Configuration editor showing the generated name, description, instructions, and input type" style={{borderRadius: '6px'}} width="1632" height="1598" data-path="images/agent_builder5.png" />
</Frame>

<Tip>
  If you prefer to configure everything yourself, click **Go to editor** to skip the chat and open the configuration editor directly. You can also start from a template.
</Tip>

## What the builder can configure

The builder can set up most of the agent configuration from your description:

* **Agent details**: name, description, emoji icon, and conversation starters
* **Instructions**: writing new instructions or refining existing ones
* **Model settings**: model, creativity, and the behavior when limits are reached
* **Capabilities**: web search and image generation
* **Knowledge**: attaching files and knowledge sources
* **Actions**: integration actions, skills, workflows, and file templates
* **Subagents**: attaching other agents for delegation
* **Labels**: assigning existing workspace labels
* **Form fields**: switching the input type to form and generating the fields

Sharing and scheduling are not handled by the builder. Use the options in the top bar to [share](/en/using-langdock/agents/configuration#sharing) or [schedule](/en/using-langdock/agents/configuration#schedule) the agent.

## Refining and manual editing

After the initial setup, the builder chat stays in a panel next to the configuration editor. You can keep chatting to refine the agent, and changes apply live to the configuration. You can also edit any field manually at any time; the chat and the editor work on the same configuration.

Use the **Build** and **Test** toggle to switch between the builder chat and a test conversation with your agent.

## Editing existing agents

The builder chat is also available when you open an existing agent in edit mode. You can use it to refine instructions, add tools, or adjust the setup, and it updates the configuration for you. Use **New chat** to start a fresh builder conversation; previous builder chats remain available in the chat history.

## FAQ

<AccordionGroup>
  <Accordion title="When should I use the builder instead of manual configuration?">
    Use the builder when you want a working first version quickly or when you are not sure which configuration options fit your use case. Use manual configuration when you already know exactly what to set up or need fine-grained control over a single field.
  </Accordion>

  <Accordion title="Does the builder publish the agent automatically?">
    No. Changes are saved as a draft, just like manual edits. The builder only publishes a version when you explicitly ask it to, and you can always publish the current draft yourself from the agent editor.
  </Accordion>
</AccordionGroup>
