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

# Agent Builder

> Build, publish, and embed AI agents — then integrate them into any website or app.

## What is Agent Builder?

Agent Builder is the Thesys platform for creating and publishing AI agents. You configure your agent — model, system prompt, knowledge sources, tools, and styling — through a visual editor at [console.thesys.dev](https://console.thesys.dev), then publish it as a shareable URL.

Once published, you embed the agent into your own product using either the **Embed Widget** npm package or a direct **iframe**. Your users interact with the agent without ever leaving your site.

## Key Capabilities

<CardGroup cols={2}>
  <Card title="Embed Widget" icon="window" href="/agent-builder/embed-widget/getting-started">
    Drop a fully featured chat widget into any website with a few lines of code. Supports tray, full-screen, and chatbar layouts.
  </Card>

  <Card title="User Identity (BYOI)" icon="fingerprint" href="/agent-builder/byoi">
    Identify your own users with a signed JWT so each person gets isolated conversation history — no Thesys login required.
  </Card>

  <Card title="Programmatic Control" icon="code" href="/agent-builder/embed-widget/programmatic-control">
    Open, close, send messages, and prefill input programmatically. Trigger the agent from buttons, links, or application events.
  </Card>

  <Card title="Customization" icon="palette" href="/agent-builder/embed-widget/customization">
    Theme the chatbar to match your brand with CSS variable overrides, custom placeholders, and conversation starters.
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Build your agent">
    Go to [Agent Builder](https://console.thesys.dev) and create a new project. Configure the model, system prompt, knowledge sources, and tools.
  </Step>

  <Step title="Publish">
    Click **Share** in the editor toolbar. Your agent gets a unique URL like `https://console.thesys.dev/app/your-slug`.
  </Step>

  <Step title="Embed">
    Install the embed widget and add it to your site:

    ```javascript theme={null}
    import { embedWidget } from 'agent-embed-widget';
    import 'agent-embed-widget/dist/agent-embed-widget.css';

    embedWidget({
      url: 'https://console.thesys.dev/app/your-slug',
    });
    ```
  </Step>
</Steps>

## Next Steps

* [**Getting Started**](/agent-builder/embed-widget/getting-started) — Install the widget and embed your first agent
* [**Widget Types**](/agent-builder/embed-widget/widget-types) — Choose between tray, full-screen, and chatbar layouts
* [**User Identity (BYOI)**](/agent-builder/byoi) — Give each user their own conversation history