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

# Quick Start: Build Your First AI Agent with BotSmith

> Create your first BotSmith AI agent, train it on your documents or website, and embed it on your site — all in under five minutes, no coding needed.

BotSmith lets you build an AI chat agent trained on your own documents, website, or plain text — and put it in front of your users in minutes. No code, no configuration files, no technical setup required. Just connect your content and go.

<Steps>
  <Step title="Create an account">
    Head to [botsmith.](https://botsmith.ai)pro and click **Sign up**. BotSmith uses Google for secure, one-click authentication — select **Continue with Google**, choose your Google account, and you're in. No passwords to set or verify.
  </Step>

  <Step title="Create your first agent">
    Once you land on your dashboard, click **Create New Agent**. BotSmith instantly creates a new agent and opens the agent builder, where you can:

    * **Name your agent** — give it a clear, recognisable name (you can change this at any time).
    * **Choose an AI model** — pick the model that best fits your use case from the **Settings** tab:

    | Model                | Best for                                 |
    | -------------------- | ---------------------------------------- |
    | **GPT-4o**           | Complex reasoning, nuanced answers       |
    | **Claude Haiku 4.5** | Fast, concise responses                  |
    | **Gemini 2.5 Flash** | High-speed, cost-efficient conversations |

    Your agent is created with a sensible default configuration — a helpful customer support persona, a `Hello! How can I help you today?` welcome message, and a balanced temperature setting. You can fine-tune all of these in the **Settings** tab later.
  </Step>

  <Step title="Add training sources">
    Open the **Sources** tab and click **Add Source**. You can train your agent on any combination of the following:

    * **File upload** — drag and drop or browse for a PDF, DOCX, or TXT file. Great for product manuals, FAQs, knowledge bases, and policy documents.
    * **Website URL** — enter a URL and BotSmith will scrape the page content automatically. Ideal for pulling in your existing help centre, blog, or marketing site.
    * **Plain text** — paste any text directly into the editor. Useful for quick Q\&A snippets or content you haven't published anywhere yet.

    You can add as many sources as your plan allows. Each source shows a processing status badge — wait for it to read **processed** before moving on.
  </Step>

  <Step title="Preview and test your agent">
    Click the **Preview** button in the top navigation bar to open the built-in chat window. Type questions that your real users might ask and check that the agent's answers are accurate and on-brand.

    If a response isn't quite right, go back to the **Sources** tab to add or remove content, or adjust the system instructions in **Settings** to steer the agent's tone and focus.
  </Step>

  <Step title="Deploy your agent">
    When you're happy with how your agent responds, open the **Widget** tab to deploy it. You have several options:

    **Chat Bubble Widget** *(recommended)* — copy the script snippet and paste it before the closing `</body>` tag of your website's HTML. A floating chat bubble will appear in the bottom-right corner of every page.

    ```html theme={null}
    <!-- BotSmith Widget Script -->
    <script>
      window.botsmithConfig = {
        chatbotId: "YOUR_AGENT_ID",
        domain: "https://app.botsmith.pro"
      };
    </script>
    <script
      src="https://app.botsmith.pro/fast-widget.js"
      chatbot-id="YOUR_AGENT_ID"
      domain="https://app.botsmith.pro"
      defer>
    </script>
    ```

    **Iframe embed** — embed the agent as an inline panel inside any page using a standard `<iframe>` tag.

    **Public link** — share a direct chat URL with anyone — no website required. Perfect for beta testers, internal teams, or social sharing.

    All agents are publicly accessible by default, so your link is ready to share the moment you copy it.
  </Step>
</Steps>

## What's next?

<CardGroup cols={2}>
  <Card title="Customize Appearance" icon="palette" href="/agents/appearance">
    Change your agent's colours, avatar, chat bubble icon, and welcome screen to match your brand.
  </Card>

  <Card title="Connect a Website Widget" icon="code" href="/integrations/website-widget">
    Learn advanced widget configuration options, including custom positioning and trigger behaviour.
  </Card>

  <Card title="Add to Slack" icon="slack" href="/integrations/slack">
    Invite your agent to a Slack channel so your team can query it without leaving their workflow.
  </Card>

  <Card title="View Analytics" icon="chart-bar" href="/analytics/dashboard">
    Track conversations, message volume, and user engagement across all your agents.
  </Card>
</CardGroup>