Embedding AI chat

There are two ways to create an AI chat experience for your embed users:

Embed the Omni Agent - Add Omni’s own chat experience to your application, with your branding
Bring your own agent - Connect an AI agent that you build to Omni’s MCP Server

In both options, Omni runs each query as the embed user, so the user’s roles and user attributes control what data they can see.

Comparison

	Omni Agent	Your own agent
Chat interface	Omni’s chat interface, with your branding	An interface that you build
How users get access	A signed embed URL in an iframe	Your backend mints an MCP token for each user, no iframe needed
User permissions	Embed URL parameters such as `connectionRoles`, `modelRoles`, and `userAttributes`	The same parameters, passed to `createEmbedMcpToken`
Availability	Available with the Embed feature	Must be enabled by Omni support

Use the Omni Agent if you want a complete chat experience with no chat interface to build or maintain. Use your own agent if:

You already have an AI chat or agent in your application, and you want it to query Omni
You want full control of the chat interface and the agent’s behavior

Embed Omni’s chat experience and control which connections and topics it can use.

Mint MCP tokens for your embed users so your agent can query Omni as each user.