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

# Embedded

> Example section for showcasing embedded UI components

## Introduction

`Embedded` lets you drop a fully-featured Alcamine Agent into any web page with a single line of HTML. The UI, networking and state-management are all handled for you – just supply the URL of the Agent you want to surface.

### When to choose Embedded

* You want the **fastest time-to-value** and are happy with a ready-made UI.
* You prefer not to deal with auth, network calls or edge-cases – we manage all of that for you.
* You still need full access to the **JavaScript SDK** and **low-level Components** later on. Start simple, evolve when you need to.

If you would rather design your own chat experience, jump straight to our [Components](./components.mdx) and [JS SDK](./sdk.mdx) docs.

## Quick Start

1. Navigate to the **Agent detail page** in your workspace.
2. Click the **Share** button and copy the generated URL – it will look something like:

```text theme={null}
https://acme.alcamine.com/acme-sales-assistant
```

3. Drop an `<iframe>` into your site and paste the URL into the `src` attribute:

```html theme={null}
<iframe
  class="h-[600px] w-full rounded-lg border shadow-sm"
  src="https://acme.alcamine.com/acme-sales-assistant"
  allow="microphone; camera;"
  loading="lazy"
  style="background: transparent;"
/>
```

That's it – refresh the page and your Agent is live.

> **Permission Note**
> The iframe **must** include `allow="microphone; camera;"` so that users can record voice or video messages. You can add additional permissions as your use-case requires.

## Going further

* **Custom UI** Prefer to craft your own look & feel? Head over to [Components](./components.mdx) and [JS SDK](./sdk.mdx) for granular control.
* **Different embed styles** We're exploring new layouts (floating widgets, side-bars, full-screen modals…). Have a creative use-case? [Reach out](mailto:support@alcamine.com) – we'd love to hear about it.
* **Theming** A public theming API is coming soon. Until then, let us know your brand requirements and we'll help you tailor the experience manually.

## Next steps

• Read the [Components guide](./components.mdx) to learn how each building block works.
• Browse the [JS SDK reference](./sdk.mdx) to interact with Agents programmatically.
• Check the [API Reference](../api-reference/introduction.mdx) if you need server-side integration.

Happy embedding!