​

Azure OpenAI Configuration

The Azure OpenAI configuration screen in Novaplan AI where you’ll enter your Endpoint, Deployment Name, API Key, and Model Name Novaplan AI allows you to integrate with Azure OpenAI’s powerful language models to enable AI features in your workspace, providing enterprise-grade security and compliance with your Azure deployment.

​

Required Fields

​

Endpoint *

The Endpoint URL is required to connect to your Azure OpenAI service instance. How to obtain your Endpoint:

1. Log in to the Azure Portal
2. Navigate to your Azure OpenAI resource
3. Go to the “Keys and Endpoint” section in the left navigation
4. Copy the Endpoint URL (it will look like: https://your-resource-name.openai.azure.com/)

Note: The endpoint must include the complete URL with your resource name.

​

Deployment Name *

The Deployment Name refers to the specific model deployment you’ve created in your Azure OpenAI service. How to find your Deployment Name:

1. In the Azure Portal, navigate to your Azure OpenAI resource
2. Select “Model deployments” from the left navigation
3. Find the deployment you want to use and copy the “Deployment name”
4. This is the name you assigned when you deployed the model (not the model name itself)

​

API Key *

The API Key authenticates your requests to your Azure OpenAI service. How to obtain your API Key:

1. In the Azure Portal, navigate to your Azure OpenAI resource
2. Go to the “Keys and Endpoint” section in the left navigation
3. Copy either Key 1 or Key 2 (both will work)

Security note: Treat this API key as a secret. Use the approved workspace setup flow, and coordinate access and rotation with Novaplan and your provider administrator.

​

Model Name *

The Model Name field defines which Azure OpenAI model you want to use with Novaplan AI. Model choice: Microsoft’s current model catalog includes the GPT-6 family, including gpt-6-astra. Enter the model ID associated with the deployment in your Azure resource. Catalog presence does not mean the model is available in every region, quota tier, or Novaplan integration. How to choose a model:

• Confirm the deployment, model ID, region, and quota in your Azure resource
• Compare capabilities, latency, and cost in the current Microsoft catalog
• Ask Novaplan to test the selected deployment, including any required agent tools, before assigning it to production workflows

​

Configuration Steps

As shown in the image above:

1. Click Configure on the Azure OpenAI provider card
2. Enter your Endpoint URL in the designated field (marked with *)
3. Specify your Deployment Name from your Azure OpenAI service (marked with *)
4. Enter your Azure OpenAI API Key (marked with *)
5. Specify your Model Name (marked with *)
6. Click Add Model to save and validate your credentials

All fields (Endpoint, Deployment Name, API Key, and Model Name) are required to successfully configure Azure OpenAI integration. You must complete these fields to proceed with the setup.

​

Usage Considerations

• API usage will count against your Azure OpenAI resource’s quota and billing
• Different models have different pricing - check Azure’s pricing page for details
• Model capabilities vary - more powerful models may provide better results but at higher cost
• Azure OpenAI provides additional enterprise features like:
  • Virtual Network support
  • Role-based access control
  • Content filtering
  • Regional data residency

​

Troubleshooting

• If you encounter authentication errors, verify your API key and endpoint are correct
• Ensure your Azure subscription is active and has sufficient quota for the selected model
• Verify that the deployment name exists in your Azure OpenAI resource
• Check that the model name matches one of the models available in your Azure OpenAI service
• Ensure the managed Novaplan workspace’s network access is allowed if your Azure resource has network restrictions

For additional support, refer to the Azure OpenAI documentation or contact Novaplan AI support.