Skip to main content
Version: 3.0.0

Set up Azure OpenAI

This guide explains how to set up Azure OpenAI for use with Ascend.

Prerequisites​

Create an Azure OpenAI resource​

  1. Navigate to the Azure portal
  2. Search for and select Azure OpenAI
  3. Click Create to create a new instance
  4. Configure basic settings:
    • Select your Subscription
    • Choose a Resource Group
    • Select your Region
    • Select your Pricing tier openai
  5. Click Next to Network. Leave as "All networks" unless you are running self-hosted instances and specifically know how to restrict this further
  6. Click Next to Tags and add any tags you want
note

For more details, reference the Azure OpenAI documentation.

Set up model deployments​

  1. Click Explore Azure AI Foundry portal foundry
  2. Click on Deployments in the far left navigation
  3. Select Deploy model and deploy a base model
  4. Select gpt-4.1 and deploy
note

The deployment name must exactly match the model name for all models

  1. Repeat for gpt-4.1-mini, gpt-4o, and o4-mini
  2. At the end, your Azure OpenAI deployments should look like this: model deployments
  3. Select any one of your deployments
  4. Copy the Target URI as you will need the hostname later (i.e., https://[your_service_name_and_region].cognitiveservices.azure.com/)
  5. Copy the key to place in your Instance Vault in the next section key
note

For more details, reference the [Azure OpenAI model deployments documentation]https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource?pivots=web-portal#deploy-a-model

Connect your Ascend Instance​

  1. Navigate to your Ascend Instance
  2. Go to Settings > Secrets & Vaults > Instance Vault
    • Add your OpenAI secret with a name such as openai-api-key
  3. Go to Settings > AI
  4. Under Azure OpenAI:
    • Set your endpoint
    • Select your secret name from the dropdown endpoint
  5. Click Verify to test the connection. When verification succeeds, click Save to apply your settings
  6. Confirm you can now chat with Otto in the sidebar otto

🎉 Congratulations! You have successfully set up an Azure OpenAI resource with Ascend!

Last updated on