Embed a Public AI Agent

Add a public Taskade AI agent to your website with an iframe or a chat widget. You publish the agent, copy the code from Publish → Embed, and paste the code into your page.

Page type: How-to guide. Use it when you know the goal and need the steps.

Before you start

You need an AI agent and edit access to your website's HTML.

• An AI agent in your workspace. Publishing and embedding are on every plan.
• Access to your site's HTML. You paste one <iframe class="genesis-app-embed"></iframe> or two <script> tags.
• Optional, Business and above: Hide Branding, a custom background, and a meta image for the public agent.

Publish the agent and copy the code

Turn on public access, then copy the code that Taskade generates for you.

1. Open the agent, then open the Publish tab. In the agent list, the Share menu item opens the same screen.
2. Turn on the Publish Agent switch.
3. Open the Embed sub-tab.
4. Pick Add to your website for an iframe, or Add a chat widget for a widget.
5. Copy the generated code.

┌────────────────────────────────────────────────────────────┐
│  Publish Agent                                  [ switch ] │
├────────────────────────────────────────────────────────────┤
│   Share │ Embed │ Customize │ Tool Permissions             │
│           ─────                                            │
│   Add to your website        iframe, fixed size            │
│   Add a chat widget          launcher or in-page panel     │
└────────────────────────────────────────────────────────────┘

The generated code holds the current public agent ID and only the options that the selected mode supports. The Customize sub-tab sets the look. Tool Permissions shows only when the agent has tools.

Choose an embed type

Pick the smallest surface that fits the page.

bubble is the widget default. Taskade leaves it out of the generated config.

inline must mount into a page element. searchBar can mount into one, for a pill in a site header. The generated snippet includes this host element:

<div id="taskade-agent"></div>

Move this element to the place where the pill or panel must appear. Keep its ID aligned with the target value. A searchBar without a target is a pill fixed to the corner that popup.position sets.

Add an iframe

Use the iframe when the agent must stay open inside a known area.

<iframe
  allow="clipboard-read; clipboard-write"
  src="YOUR_PUBLIC_AGENT_URL"
  width="100%"
  height="400"
  frameborder="0"
  allowfullscreen
></iframe>

Add the widget

Place the generated script near the end of the page body.

<script src="https://assets.taskade.com/embeds/latest/taskade-embed.min.js"></script>
<script type="module">
  window.taskadeAgent = TaskadeEmbed.TaskadeEmbed.init({
    "publicAgentId": "PUBLIC_AGENT_ID"
  });
</script>

Keep the double TaskadeEmbed.TaskadeEmbed.init name. The CDN bundle exposes the current initializer at that path.

The snippet stores the widget handle on window.taskadeAgent. Your page code can call these methods:

For an inline panel, add the host element. Then set the mode and the target:

<div id="taskade-agent"></div>
<script src="https://assets.taskade.com/embeds/latest/taskade-embed.min.js"></script>
<script type="module">
  window.taskadeAgent = TaskadeEmbed.TaskadeEmbed.init({
    "publicAgentId": "PUBLIC_AGENT_ID",
    "mode": "inline",
    "target": "#taskade-agent"
  });
</script>

Configure the widget

Pass only the options that the selected mode uses.

Some options apply only to some modes:

• The theme radius, density, and font style the widget around the chat, not the chat transcript.
• launcher.size does not apply to searchBar or inline.
• popup.position applies to searchBar only when it has no target.
• inline is always open. It uses no label, proactive message, auto-open delay, custom trigger, or hotkey.

Keep public access safe

Treat the embed as public access to the agent.

• Review the agent's instructions and knowledge before you publish it.
• Keep secrets and private records out of public knowledge sources.
• Turn off tools that a public visitor must not use.
• Test the public page in a signed-out browser.
• Turn off the Publish Agent switch if the link reaches the wrong audience.
• Keep your API token out of the page. The embed code needs only the public agent ID. Your own server code uses a token, as Authentication shows.

Note: A public agent keeps no memory between visitor chats. Read what visitors asked in the agent's Messages tab.

Next steps

• Publish Agents Publicly: the product steps for sharing an agent by link.
• Agent Widgets: pick and style a chat widget in the app.
• Enable public agent access: publish an agent from code with the Action API.
• Action API guide: call agents and projects from your own service.
• Hosted Taskade MCP: reach the same workspace from an AI client.