US:18810- Standardize Bicep Parameters for KM-Generic

Author: VishalS-Microsoft

documents/CustomizingAzdParameters.md

@@ -3,51 +3,38 @@
 By default this template will use the environment name as the prefix to prevent naming collisions within Azure. The parameters below show the default values. You only need to run the statements below if you need to change the values. 
 
 
-> To override any of the parameters, run `azd env set <key> <value>` before running `azd up`. On the first azd command, it will prompt you for the environment name. Be sure to choose 3-20 characters alphanumeric unique name. 
+> To override any of the parameters, run `azd env set <PARAMETER_NAME> <VALUE>` before running `azd up`. On the first azd command, it will prompt you for the environment name. Be sure to choose 3-20 charaters alphanumeric unique name. 
 
-Change the Content Understanding Location (allowed values: Sweden Central, Australia East)
+## Parameters
 
-```shell
-azd env set AZURE_CONTENT_UNDERSTANDING_LOCATION 'swedencentral'
-```
-
-Change the Secondary Location (example: eastus2, westus2, etc.)
-
-```shell
-azd env set AZURE_SECONDARY_LOCATION eastus2
-```
-
-Change the Model Deployment Type (allowed values: Standard, GlobalStandard)
-
-```shell
-azd env set AZURE_OPEN_AI_MODEL_DEPLOYMENT_TYPE GlobalStandard
-```
-
-Set the Model Name (allowed values: gpt-4o-mini, gpt-4o, gpt-4)
+| Name                                      | Type    | Default Value            | Purpose                                                                    |
+| ----------------------------------------- | ------- | ------------------------ | -------------------------------------------------------------------------- |
+| `AZURE_LOCATION`                          | string  | ` ` *(empty)*            | Sets the Azure region for resource deployment.                             |
+| `AZURE_ENV_NAME`                          | string  | `env_name`               | Sets the environment name prefix for all Azure resources.                  |
+| `AZURE_CONTENT_UNDERSTANDING_LOCATION`    | string  | `swedencentral`          | Specifies the region for content understanding resources.                  |
+| `AZURE_SECONDARY_LOCATION`                | string  | `eastus2`                | Specifies a secondary Azure region.                                        |
+| `AZURE_OPEN_AI_MODEL_DEPLOYMENT_TYPE`     | string  | `GlobalStandard`         | Defines the model deployment type (allowed: `Standard`, `GlobalStandard`). |
+| `AZURE_OPEN_AI_DEPLOYMENT_MODEL`          | string  | `gpt-4o-mini`            | Specifies the GPT model name (e.g., `gpt-4`, `gpt-4o-mini`).               |
+| `AZURE_ENV_MODEL_VERSION`                 | string  | `2024-07-18`             | Sets the Azure model version (allowed: `2024-08-06`, etc.).                |
+| `AZURE_ENV_OPENAI_API_VERSION`            | string  | `2024-02-15-preview`     | Specifies the API version for Azure OpenAI.                                |
+| `AZURE_OPEN_AI_DEPLOYMENT_MODEL_CAPACITY` | integer | `30`                     | Sets the GPT model capacity.                                               |
+| `AZURE_OPENAI_EMBEDDING_MODEL`            | string  | `text-embedding-ada-002` | Sets the name of the embedding model to use.                               |
+| `AZURE_ENV_IMAGETAG`                      | string  | `latest_migrated`        | Sets the image tag (`latest`, `dev`, `hotfix`, `latest_migrated`, etc.).   |
+| `AZURE_OPENAI_EMBEDDING_MODEL_CAPACITY`   | integer | `80`                     | Sets the capacity for the embedding model deployment.                      |
+| `AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID`    | string  | ` ` *(empty)*            | Reuses an existing Log Analytics Workspace instead of creating a new one.  |
 
-```shell
-azd env set AZURE_OPEN_AI_DEPLOYMENT_MODEL gpt-4o-mini
-```
 
-Change the Model Capacity (choose a number based on available GPT model capacity in your subscription)
 
-```shell
-azd env set AZURE_OPEN_AI_DEPLOYMENT_MODEL_CAPACITY 30
-```
+## How to Set a Parameter
 
-Change the Embedding Model 
+To customize any of the above values, run the following command **before** `azd up`:
 
-```shell
-azd env set AZURE_OPENAI_EMBEDDING_MODEL text-embedding-ada-002
+```bash
+azd env set <PARAMETER_NAME> <VALUE>
 ```
 
-Change the Embedding Deployment Capacity (choose a number based on available embedding model capacity in your subscription)
-
-```shell
-azd env set AZURE_OPENAI_EMBEDDING_MODEL_CAPACITY 80
-```
+**Example:**
 
-Set the Log Analytics Workspace Id if you need to reuse the existing workspace which is already existing
-```shell
-azd env set AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID '/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.OperationalInsights/workspaces/<workspace-name>'
+```bash
+azd env set AZURE_LOCATION westus2
 ```

infra/main.bicep

@@ -37,7 +37,7 @@ param gptModelName string = 'gpt-4o-mini'
 @description('Version of the GPT model to deploy:')
 param gptModelVersion string = '2024-07-18'
 
-var azureOpenAIApiVersion = '2024-02-15-preview'
+param azureOpenAIApiVersion string = '2024-02-15-preview'
 
 @minValue(10)
 @description('Capacity of the GPT deployment:')

infra/main.bicepparam

@@ -7,7 +7,9 @@ param secondaryLocation = readEnvironmentVariable('AZURE_SECONDARY_LOCATION', 'e
 param deploymentType = readEnvironmentVariable('AZURE_OPEN_AI_MODEL_DEPLOYMENT_TYPE', 'GlobalStandard')
 param gptModelName = readEnvironmentVariable('AZURE_OPEN_AI_DEPLOYMENT_MODEL', 'gpt-4o-mini')
 param gptModelVersion = readEnvironmentVariable('AZURE_ENV_MODEL_VERSION', '2024-07-18')
+param azureOpenAIApiVersion = readEnvironmentVariable('AZURE_ENV_OPENAI_API_VERSION', '2024-02-15-preview')
 param gptDeploymentCapacity = int(readEnvironmentVariable('AZURE_OPEN_AI_DEPLOYMENT_MODEL_CAPACITY', '30'))
 param embeddingModel = readEnvironmentVariable('AZURE_OPENAI_EMBEDDING_MODEL', 'text-embedding-ada-002')
+param imageTag = readEnvironmentVariable('AZURE_ENV_IMAGETAG', 'latest_migrated')
 param embeddingDeploymentCapacity = int(readEnvironmentVariable('AZURE_OPENAI_EMBEDDING_MODEL_CAPACITY', '80'))
 param existingLogAnalyticsWorkspaceId = readEnvironmentVariable('AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID', '')