# Provision Sunrise Business AI Assistant This guide covers provisioning a **dedicated Sunrise Business AI Assistant instance** for your company: its own URL, its own databases, and your own sign-on. If your company already runs a chat instance and you only want to start using it, you do not need this page. Go to the [Quick Start](../quick-start/index.md) instead. --- ## Prerequisites Before you begin, make sure you have: - An active Sunrise Console account with permission to make purchases - A company profile associated with your account !!!warning Everything must be in the same resource group Every subscription lives in a resource group, and the provisioning dropdowns only list products **from the same resource group**. A chat instance in *Project A* cannot use a Base LLM API in *Project B*. Choose your resource group before you start and stay in it. !!! If you already have a fully provisioned **Base LLM API** in the resource group you want to use, skip to [Step 2](#step-2-purchase-the-sunrise-business-ai-assistant-subscription). --- ## Step 1: Purchase and provision a Base LLM API Sunrise Business AI Assistant runs on the Base LLM API. You need an active, fully provisioned Base LLM API in the same resource group before you can provision a chat instance. See [Base LLM API](../../../maas/subscriptions/index.md#2-base-llm-api) for plans and pricing. !!!danger The MaaS [Evaluation plan](../../../maas/subscriptions/index.md#1-evaluation-plan) cannot run a Sunrise Business AI Assistant instance That plan is for testing the models directly through the API. When you provision a chat instance, the dropdown lists **Base LLM API subscriptions only**. If an Evaluation plan is all you have, there will be nothing to select. Purchase a **Base LLM API** subscription, not an Evaluation plan. !!! 1. Sign in at [https://portal.ai.sunrise.ch](https://portal.ai.sunrise.ch). 2. Open **Products** from the left navigation, or click **Add Subscription** from the Dashboard. 3. Select **AI Model Service**, then choose **Base LLM API**. 4. Click **Add to cart**, then **Proceed to Checkout**. 5. Complete checkout and confirm your order. For the general checkout flow, see [Buy a Subscription](../../../getting-started/buy-a-subscription.md). Then provision it: 1. Navigate to **Resource Groups** in the left-hand menu and open the resource group that will hold your chat instance. 2. Expand the **Subscriptions** list and find your Base LLM API subscription with status **Ordered**. 3. Click **Provision Service** on that row. 4. Enter a **subscription alias**, a readable label you will see in later dropdowns, for example `MaaS-API-for-Finance-Team-Sunrise-Chat`. 5. Click **Provision**. Provisioning takes a few seconds. **Wait until the subscription shows as provisioned** before moving on; an unfinished subscription does not appear in the chat provisioning dropdown. You do not need to create an API key yourself. The platform creates one on this Base LLM API and attaches it when you provision the chat instance in Step 3. With one subscription you can create as many API keys as you want and re-create them at any time. --- ## Step 2: Purchase the Sunrise Business AI Assistant subscription 1. Open **Products** from the left navigation, or click **Add Subscription** from the Dashboard. 2. Select **Sunrise AI Platform**, then choose your Sunrise Business AI Assistant plan. See [Subscriptions](../subscriptions/index.md) for what each plan includes. 3. Click **Add to cart**, then **Proceed to Checkout**. 4. Complete checkout and confirm your order. For the general checkout flow, see [Buy a Subscription](../../../getting-started/buy-a-subscription.md). --- ## Step 3: Provision Sunrise Business AI Assistant 1. Navigate to **Resource Groups** in the left-hand menu and open the resource group holding your Base LLM API. 2. Expand the **Subscriptions** list and find your Sunrise Business AI Assistant subscription with status **Ordered**. 3. Click **Provision Service** on that row. 4. In the **Provision service** dialog: - Enter a **subscription alias**, a readable label you will use to identify this instance later. - Select a **MaaS Instance**, this is the Base LLM API from Step 1. 5. Click **Provision**. !!!info You never paste an API key When you select a MaaS Instance, the platform creates a new API key on that Base LLM API, verifies that the key works, and attaches it to your chat instance automatically. There is no key to copy, and nothing to enter by hand. !!! Provisioning normally takes **5 to 10 minutes**. Watch the subscription status in the console until it shows as provisioned. --- ## Step 4: Open your instance Once the subscription shows as provisioned, click **Launch Product** on the Sunrise Business AI Assistant row. Your instance opens at its own URL and you sign in with your Sunrise account. Paid plans use enterprise SSO, so you sign in through your company identity provider rather than typing a password into the chat. !!!warning Sign in at least once before buying an assistant Your chat user account is created the first time you sign in. A pre-built assistant purchased before you have ever signed in will not appear in your **My Agents** list. !!! --- ## What happens next - Your chat instance draws inference from the credit pool of the Base LLM API you selected. All keys on that subscription share the same pool. See [Base LLM API](../../../maas/subscriptions/index.md#2-base-llm-api). - To add users, share your instance URL with them. Access is controlled through your identity provider. - To increase the credit allowance, see [How to add LLM Credits](../../../maas/model-service-guides/how-to-add-additional-llm-credits.md). --- ## If provisioning fails | What you see | What it means | What to do | | :--- | :--- | :--- | | The MaaS Instance dropdown is empty | You have no provisioned Base LLM API in this resource group, or you only have an Evaluation plan | Purchase and provision a Base LLM API first, or switch resource group | | Your Base LLM API is missing from the dropdown | It has not finished provisioning, or it sits in a different resource group | Wait for provisioning to finish, or open the correct resource group | | "The selected MaaS key is invalid" | The Base LLM API behind it is not responding, or the subscription is not healthy | Check the [status dashboard](https://status.ai.sunrise.ch/), then retry | | Stuck in progress, then fails | The instance could not be built | [Contact support](https://support.ai.sunrise.ch/) with your subscription ID | | Fails immediately | The request was rejected | The error message names the reason | --- ## Removing a chat instance !!!danger Removing a chat instance deletes its data Conversations, uploaded files and knowledge bases in that instance are destroyed and cannot be recovered. Export anything you need first. !!! A chat instance cannot be removed while pre-built assistants are still installed on it. Remove the assistants first, then the chat instance. Removing a chat instance does **not** remove the API key it created on your Base LLM API. That key stays on the Base LLM API subscription and should be deleted separately if you no longer need it. For the cancellation procedure, see [How to cancel a subscription](../../../maas/model-service-guides/how-to-cancel-a-model-service-subscription.md). --- ## See also [!ref icon="zap" text="Quick Start, your first conversation"](../quick-start/index.md) [!ref icon="package" text="Sunrise Business AI Assistant subscription plans"](../subscriptions/index.md) [!ref icon="credit-card" text="Model Service subscription plans"](../../../maas/subscriptions/index.md)