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. The exception is an agent with saved widget settings, as described in Save the widget settings as the default.

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>

Save the widget settings as the default

Save as default on the Embed sub-tab stores the widget settings on the agent. You can save a default for the bubble, modal, and sidebar modes. A searchBar or inline widget sits inside your page, so its settings stay in the snippet.

When the settings on screen match the saved default, Taskade generates the short snippet. It holds publicAgentId and no widget settings, and the widget loads the saved settings when it starts. A trigger or interface option stays in the snippet, because Taskade does not save those two. A later save updates every site that uses the short snippet, and you do not paste the code again.

A snippet that sets one of mode, theme, popup, launcher, behavior, or visibility ignores all saved settings. To show the plain widget on one site while a saved default exists, set "mode": "bubble" in the snippet of that site.

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.
• Turn on the Search the web or Read a web page tool for visitors only if the public agent needs the web.
• 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.

A public chat can search the web or read a page only when the matching tool is on for visitors.

A public visitor does not see tool results or the reasoning of the agent. Taskade also hides the input of most tool calls from the visitor. The visitor sees the reply and the web sources of a search. A signed-in member of the agent's workspace still sees the tool details.

Review questions the agent did not answer

The Agent Inbox collects the public questions that your agent did not answer well, so you can teach it the answer. It covers chats on the public agent page and in the embed. A private chat in your workspace never goes to the inbox.

Two things add a question to the inbox:

• After the agent replies in a public chat, Taskade checks the chat for a question that the agent did not answer.
• A visitor clicks the thumbs-down button (Bad response) on a reply. The question behind that reply goes to the inbox, with the reason that the visitor typed. The reason box tells the visitor that the agent owner can see it.

To review the questions:

1. Open the agent, then open the Knowledge tab.
2. Open the Inbox sub-tab. It shows after Taskade adds the first question.
3. For each question, click Answer & save, write the answer, then click Save as knowledge. To skip a question, click Dismiss.

The saved answer becomes agent knowledge, so the agent can use it with the next visitor. Taskade also keeps the questions in a workspace project named Agent Inbox - <agent name>, which every member who can view agents can read.

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.