Overview
Easily share your AI agent with others by choosing how they can interact with it. Whether you want to send a live chat link, embed a support widget, showcase tasks in an iframe, or allow full template cloning, you have flexible options to fit any use case.Clonable Template
Let others clone your Agent - complete with its instructions and setup - into their own workspace. This makes it easy to share best practices, pre-built use cases, or workflows without needing to rebuild from scratch. Cloned agents use the recipient’s credits, not yours, making this perfect for scalable distribution.Copy to Project
Want to create a copy of your agent for yourself? Use the “Copy to Project” feature to duplicate agents quickly between different projects. This preserves all agent configurations, settings, and instructions.Chat UI
Let others interact with your Agent through a clean, conversation-style interface — just like a chatbot. You can share it via a link or embed it as an iframe. This is perfect for letting people experience your Agent without modifying anything. All usage is billed to your account, and others can use the Agent without needing to set it up themselves.Developer Notes
The
iframe inherits 100% of its parent container by default. Configure your container’s dimensions carefully to ensure the iframe displays correctly within your page layout without causing layout issues.Chat Widget
Turn your Agent into a pop-up chat interface you can embed on any website with a simple script tag. It behaves like a support chat window and is ideal for customer-facing use cases like answering questions, handling requests, or collecting feedback directly on your site.Developer Notes
Target the
.relevanceai-chat-bubble-app class to style the chat bubble. Adjust its z-index property to position the bubble above or below other UI elements such as cookie popups and toast messages.| URL parameter | Type | Values | Description | Examples |
|---|---|---|---|---|
primary_color | string | A valid CSS color for your form. | #685fff | |
bubble_style | enum | agent, icon | Use an agents avatar or the bubble_icon. | agent |
bubble_icon | enum | pd/ai-agent, notebook/deploy, pencil, star, sparkle, sparkles, pd/lightning-filled, pd/chat, pd/send-diagonal, stack, duration, pd/check, pd/play, arrow-r, pd/search, share, plus, pd/question-filled | The icon to use if bubble_style is set to icon. | |
input_placeholder_text | string | Set the message input placeholder text. | Type your question here… | |
hide_file_uploads | boolean | Toggle file uploads. | true | |
hide_conversation_list | boolean | Toggle multiple conversations. | true | |
hide_tool_steps | boolean | Toggle tool steps. | true | |
starting_message_prompts | string | Add starting prompts. | ["I need help with my billing", "Write me an email"] | |
hide_logo | boolean | Toggle Relevance AI branding. | false | |
hide_description | boolean | Toggle agent description. | true |
Task UI
This gives users access to a task-focused version of your Agent via an iframe. Users can view past task runs, pick from existing tasks, and even interact with outputs — all within a self-contained UI. It’s great for operational dashboards, workflow demos, or giving others visibility into what your Agent is doing.SDK
For developers who want full control over the user experience, you can build custom agent integrations directly into your website or application using our JavaScript/TypeScript SDK. The SDK gives you complete flexibility to:- Design custom chat interfaces that perfectly match your brand
- Build unique user experiences beyond what the standard embeds offer
- Integrate agent capabilities into existing applications
- Handle real-time messaging and task management programmatically
Frequently asked questions (FAQs)
Why can't I clone an agent that I originally cloned from the Marketplace?
Why can't I clone an agent that I originally cloned from the Marketplace?
Some Relevance Builders have chosen to restrict cloning of agents that originated from their Marketplace listings. This prevents users from redistributing paid listings to avoid payment and protects the builder’s intellectual property.If you need another copy of the agent, you can return to the Marketplace and clone the original listing again or add it to other projects directly from there.
Why can't I use Copy to Project on an agent I cloned from the Marketplace?
Why can't I use Copy to Project on an agent I cloned from the Marketplace?
Some Relevance Builders have chosen to restrict copying of agents that originated from their Marketplace listings. The Copy to Project feature is disabled for these agents to prevent users from redistributing paid listings without proper authorization and to protect the builder’s intellectual property.To add the agent to additional projects, visit the Marketplace and clone the original listing directly to each project where you need it.