chore: add azure open ai setup doc

2026-07-25 20:56:00 -04:00 · 2025-05-07 10:32:49 -06:00
parent 3f6decb77b
commit b3f7efdb2a
8 changed files with 63 additions and 29 deletions
@@ -0,0 +1,63 @@
+---
+title: Azure OpenAI
+description: How to set up Azure OpenAI with Msty Studio
+navTruncate: false
+---
+Azure OpenAI is a Microsoft cloud service that provides access to OpenAI’s powerful language models, such as GPT, through the secure and scalable Azure platform. It’s beneficial because it combines advanced AI capabilities with enterprise-grade security, compliance, and integration tools, making it ideal for businesses to utilize LLM models and AI applications safely and efficiently.
+
+This guide will walk you through the steps to set up Azure OpenAI in Msty Studio.
+
+## Azure Setup
+
+These steps cover how to setup Azure OpenAI in the Azure portal. These steps assume you have an Azure account and have access to the Azure OpenAI service. 
+
+::steps
+1. Go to [Azure Portal](https://portal.azure.com/)
+2. Search for **Azure OpenAI** in the main search bar at the top
+3. Select option to **Create Azure OpenAI** if you don't have an existing Azure OpenAI resource
+4. If setting up new Azure OpenAI resource, go through the steps to create a new resource
+5. Once the resource is created, select it from the list of resources
+6. Towards the top of the resource page, click on **Go to Azure AI Foundry Portal**
+![foundry button](/images/azure/foundry-button.png)
+7. Select **Deployments** from the left menu
+8. Select the **Deploy Model** button from the top menu and select either base or fine-tuned model
+![deploy model](/images/azure/deploy-model.png)
+9. From the modal, select the model you want to deploy and click **Confirm** and then **Confirm and Continue**
+![select model](/images/azure/select-model.png)
+10. After the deployment completes, the deployment details section displays a **Target URI** - copy this value
+![target uri](/images/azure/target-uri.png)
+11. Below the Target URI is the **Key** - copy this value as well
+
+The **Target URI** has a format - 
+https://\<your-resource-name\>.cognitiveservices.azure.com/openai/deployments/\<model-name\> ... ?api-version=\<api-version\>
+
+The key parts that we'll want to capture are: 
+ - your resource name
+ - api-version
+ - model name
+
+::
+
+We'll use the target URI and Key in the next steps to set up Msty Studio. 
+
+## Msty Studio Setups
+
+Remember to pull the **Target URI** and **Key** from the Azure OpenAI portal before proceeding with these steps.
+
+::steps
+1. Go to [Msty Studio](https://msty.studio) 
+2. Select **Model Hub** from the left menu
+3. Select **Add Provider**
+4. Select **Azure OpenAI** from the list of providers
+5. Enter the **Key** value into the **API Key** field
+6. Enter the **Target URI** from the Azure OpenAI Foundry portal into the **Base URL** field, mainly this portion: `https://<your-resource-name>.cognitiveservices.azure.com/openai/deployments`
+  OR you can skip the base url and enter the **Resource name** in the corresponding field
+7. Enter the **API Version** in the corresponding field
+8. Select the **Model(s)** that you have deployed in Azure OpenAI - note that all models will be listed but you can only utilize the ones you've deployed for this resource 
+9. Select **Add Provider** to save the provider
+![new azure provider](/images/azure/new-azure-provider.png)
+::
+
+Now, start a new chat and say hello to your new Azure OpenAI model!
+
+![chat with azure open ai](/images/azure/azure-chat.png)
@@ -1,29 +0,0 @@
---
-title: Backup Data
-description: How to backup and restore your data
-navTruncate: false
---
-
-Msty Studio keeps all of your data local. Specifically, in the browser that you use to access Studio. As such, if you clear your browser cache or local storage, then that will wipe all of your data.
-
-Visit [msty.studio/data](https://msty.studio/data) to backup and restore your data.
-
-![backup and restore data](/images/export-data.png)
-
-::alert{type="info" icon="tabler:info-circle"}
-This is Work in Progress feature. Please note that this feature works in conjunction with the current Workspace that you are in. Meaning, it will only export data for your current Workspace as well as import data to your current Workspace.
-::
-
-## Backup Data
-
-Select **Export Data** to download a backup of your current Workspace data. This will download a `.db` file to your device.
-
-## Restore Data
-
-You can restore your Workspace data from a backup by dragging and dropping the backup file to the window. You can also select the option to **import** which will open a file explorer for you to select the backup file you'd like to import.
-
-Please be aware, this will overwrite all data for the current Workspace and you should consider exporting a backup prior to doing this.
-
-## Reset Data
-
-This option will reset the data for your current Workspace. Please be aware, this will remove all data for the Workspace and you should consider exporting a backup prior to doing this.