# Custom Embed Assistant (BYOA)

### **Overview**

**Bring Your Own Assistant (BYOA)** is a capability in MangoApps' AI Studio that gives organizations the flexibility to integrate and personalize third-party AI assistants directly within their digital workplace. This feature expands on MangoApps’ existing AI integrations by supporting external and embeddable assistants—giving admins full control over the assistant's behavior and visibility.

This guide will take a look at the **“Custom”** option under **Modules > AI Studio > Assistants > Connect Your Assistant**, which allows admins to embed a third-party AI assistants using an embeddable code. This addition complements the existing integrations with [AWS Bedrock](https://guides.mangoapps.com/ai-guide/bring-your-own-assistant/integration-with-aws-bedrock) and OpenAI assistants.

***

### Key Capabilities

* **Custom Embed Code Support**: Paste the embed code provided by your third-party AI provider directly into MangoApps.
* **Personalization with Substitution Tags**: Leverage MangoApps substitution tags to dynamically insert user profile data—such as names, roles, or custom fields (text or dropdown)—into the assistant experience.
* **Audience-Based Access Control**: Admins can define which users or groups can access the custom assistant, across both the web and mobile apps.

***

### Setup Guide

Navigate to **Modules > AI Studio > Assistants > Connect Your Assistant** and select the **“Custom”** option.

<figure><img src="/files/vXrjzUNHSjtG9ZQbE6Q9" alt="" width="563"><figcaption></figcaption></figure>

Fill in the information under the **Configure Assistant** section. Then, paste your third-party assistant’s embed code into the designated field under the **Customize Assistant** section.

Optionally, include substitution tags for personalization. Lastly, configure visibility and access settings for your target audience.

***

### User Experience

Custom assistants appear in the **top navigation bar** or as the **default assistant** if set by an admin. The design and functionality of the assistant depend entirely on the third-party provider.

Custom assistants are **not listed** in the AI Assistants module, which only displays assistants built using MangoApps-native tools.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/ai-guide/bring-your-own-assistant/custom-embed-assistant-byoa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.