Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
707f4cb
Update LocalDeployment.md
Atulku-Microsoft Aug 5, 2025
e261db6
Update DeploymentGuide.md
Atulku-Microsoft Aug 5, 2025
d9a08be
Merge pull request #366 from microsoft/psl-update-readme-sfi
Roopan-Microsoft Aug 7, 2025
4f441dc
added all the environment variable in bicep needed for local setup
Priyanka-Microsoft Aug 8, 2025
07a35a9
Merge pull request #372 from microsoft/azdup-env-var-into-bicep
Roopan-Microsoft Aug 11, 2025
0e4c6e7
Merge pull request #374 from microsoft/main
Prajwal-Microsoft Aug 11, 2025
9967e18
deploymentMD-Updated
UtkarshMishra-Microsoft Aug 11, 2025
0ebd13e
updated env in readme local setup
Priyanka-Microsoft Aug 12, 2025
7deb672
Merge pull request #377 from microsoft/updated-readme-local-setup
Prajwal-Microsoft Aug 12, 2025
b13907b
updated env in readme local setup
Priyanka-Microsoft Aug 13, 2025
f0614de
Merge pull request #375 from microsoft/deploymentMD
Prajwal-Microsoft Aug 13, 2025
3b610a9
updated readme link
Priyanka-Microsoft Aug 14, 2025
1f2758a
added APP_env variable in bicep
Priyanka-Microsoft Aug 14, 2025
1bd9a0a
Merge pull request #378 from microsoft/updated-readme-local-deployment
Prajwal-Microsoft Aug 14, 2025
fc6235b
UpdatedTestFiles
UtkarshMishra-Microsoft Aug 18, 2025
4844590
Differentiate between setup and processing errors
AjitPadhi-Microsoft Aug 19, 2025
9b5f754
lint issue fix
AjitPadhi-Microsoft Aug 19, 2025
64ff24c
fix unit test
AjitPadhi-Microsoft Aug 19, 2025
d3487c1
fix unit test
AjitPadhi-Microsoft Aug 19, 2025
31ec335
Merge pull request #386 from microsoft/UnitTest
Roopan-Microsoft Aug 19, 2025
b6d2cc2
Merge branch 'dev' of https://github.com/microsoft/Multi-Agent-Custom…
AjitPadhi-Microsoft Aug 19, 2025
53124b4
Merge pull request #384 from microsoft/task_error_logging
Roopan-Microsoft Aug 19, 2025
c476b99
removed local deployment file as content is similar to DeploymentGuide
Priyanka-Microsoft Aug 19, 2025
d7413b1
removed local deployment file as content is similar to DeploymentGuide
Priyanka-Microsoft Aug 19, 2025
e502aa2
removed local deployment file as content is similar to DeploymentGuide
Priyanka-Microsoft Aug 19, 2025
ffffd12
Merge pull request #387 from microsoft/remove-local-deployment-file
Roopan-Microsoft Aug 19, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ jobs:
- name: Run tests with coverage
if: env.skip_tests == 'false'
run: |
pytest --cov=. --cov-report=term-missing --cov-report=xml
pytest --cov=. --cov-report=term-missing --cov-report=xml --ignore=tests/e2e-test/tests

- name: Skip coverage report if no tests
if: env.skip_tests == 'true'
Expand Down
4 changes: 2 additions & 2 deletions docs/CustomizingAzdParameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ By default this template will use the environment name as the prefix to prevent
| Name | Type | Default Value | Purpose |
| ------------------------------- | ------ | ----------------- | --------------------------------------------------------------------------------------------------- |
| `AZURE_ENV_NAME` | string | `macae` | Used as a prefix for all resource names to ensure uniqueness across environments. |
| `AZURE_LOCATION` | string | `swedencentral` | Location of the Azure resources. Controls where the infrastructure will be deployed. |
| `AZURE_ENV_OPENAI_LOCATION` | string | `swedencentral` | Specifies the region for OpenAI resource deployment. |
| `AZURE_LOCATION` | string | `<User selects during deployment>` | Location of the Azure resources. Controls where the infrastructure will be deployed. |
| `AZURE_ENV_OPENAI_LOCATION` | string | `<User selects during deployment>` | Specifies the region for OpenAI resource deployment. |
| `AZURE_ENV_MODEL_DEPLOYMENT_TYPE` | string | `GlobalStandard` | Defines the deployment type for the AI model (e.g., Standard, GlobalStandard). |
| `AZURE_ENV_MODEL_NAME` | string | `gpt-4o` | Specifies the name of the GPT model to be deployed. |
| `AZURE_ENV_FOUNDRY_PROJECT_ID` | string | `<Existing Workspace Id>` | Set this if you want to reuse an AI Foundry Project instead of creating a new one. |
Expand Down
26 changes: 21 additions & 5 deletions docs/DeploymentGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@ The easiest way to run this accelerator is in a VS Code Dev Containers, which wi

## Detailed Development Container setup instructions

The solution contains a [development container](https://code.visualstudio.com/docs/remote/containers) with all the required tooling to develop and deploy the accelerator. To deploy the Chat With Your Data accelerator using the provided development container you will also need:
The solution contains a [development container](https://code.visualstudio.com/docs/remote/containers) with all the required tooling to develop and deploy the accelerator. To deploy the Multi-Agent solutions accelerator using the provided development container you will also need:

- [Visual Studio Code](https://code.visualstudio.com)
- [Remote containers extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
Expand Down Expand Up @@ -287,7 +287,7 @@ The files for the dev container are located in `/.devcontainer/` folder.

- You can use the Bicep extension for VSCode (Right-click the `.bicep` file, then select "Show deployment plan") or use the Azure CLI:
```bash
az deployment group create -g <resource-group-name> -f deploy/macae-dev.bicep --query 'properties.outputs'
az deployment group create -g <resource-group-name> -f infra/main.bicep --query 'properties.outputs'
```
- **Note**: You will be prompted for a `principalId`, which is the ObjectID of your user in Entra ID. To find it, use the Azure Portal or run:

Expand All @@ -301,7 +301,7 @@ The files for the dev container are located in `/.devcontainer/` folder.

**Role Assignments in Bicep Deployment:**

The **macae-dev.bicep** deployment includes the assignment of the appropriate roles to AOAI and Cosmos services. If you want to modify an existing implementation—for example, to use resources deployed as part of the simple deployment for local debugging—you will need to add your own credentials to access the Cosmos and AOAI services. You can add these permissions using the following commands:
The **main.bicep** deployment includes the assignment of the appropriate roles to AOAI and Cosmos services. If you want to modify an existing implementation—for example, to use resources deployed as part of the simple deployment for local debugging—you will need to add your own credentials to access the Cosmos and AOAI services. You can add these permissions using the following commands:

```bash
az cosmosdb sql role assignment create --resource-group <solution-accelerator-rg> --account-name <cosmos-db-account-name> --role-definition-name "Cosmos DB Built-in Data Contributor" --principal-id <aad-user-object-id> --scope /subscriptions/<subscription-id>/resourceGroups/<solution-accelerator-rg>/providers/Microsoft.DocumentDB/databaseAccounts/<cosmos-db-account-name>
Expand All @@ -320,11 +320,16 @@ The files for the dev container are located in `/.devcontainer/` folder.

5. **Create a `.env` file:**

- Navigate to the `src` folder and create a `.env` file based on the provided `.env.sample` file.
- Navigate to the `src\backend` folder and create a `.env` file based on the provided `.env.sample` file.
- Update the `.env` file with the required values from your Azure resource group in Azure Portal App Service environment variables.
- Alternatively, if resources were
provisioned using `azd provision` or `azd up`, a `.env` file is automatically generated in the `.azure/<env-name>/.env`
file. To get your `<env-name>` run `azd env list` to see which env is default.

6. **Fill in the `.env` file:**

- Use the output from the deployment or check the Azure Portal under "Deployments" in the resource group.
- Make sure to set APP_ENV to "**dev**" in `.env` file.

7. **(Optional) Set up a virtual environment:**

Expand All @@ -337,8 +342,19 @@ The files for the dev container are located in `/.devcontainer/` folder.
```bash
pip install -r requirements.txt
```

9. **Build the frontend (important):**

9. **Run the application:**
- Before running the frontend server, you must build the frontend to generate the necessary `build/assets` directory.

From the `src/frontend` directory, run:

```bash
npm install
npm run build
```

10. **Run the application:**

- From the src/backend directory:

Expand Down
164 changes: 0 additions & 164 deletions docs/LocalDeployment.md

This file was deleted.

23 changes: 22 additions & 1 deletion infra/main.bicep
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ param enableTelemetry bool = true

param existingLogAnalyticsWorkspaceId string = ''

param azureopenaiVersion string = '2025-01-01-preview'

// Restricting deployment to only supported Azure OpenAI regions validated with GPT-4o model
@metadata({
azd : {
Expand Down Expand Up @@ -1000,7 +1002,7 @@ module containerApp 'br/public:avm/res/app/container-app:0.14.2' = if (container
}
{
name: 'AZURE_OPENAI_API_VERSION'
value: '2025-01-01-preview' //TODO: set parameter/variable
value: azureopenaiVersion
}
{
name: 'APPLICATIONINSIGHTS_INSTRUMENTATION_KEY'
Expand Down Expand Up @@ -1718,3 +1720,22 @@ type webSiteConfigurationType = {
@description('Optional. The tag of the container image to be used by the Web Site.')
containerImageTag: string?
}


output COSMOSDB_ENDPOINT string = 'https://${cosmosDbResourceName}.documents.azure.com:443/'
output COSMOSDB_DATABASE string = cosmosDbDatabaseName
output COSMOSDB_CONTAINER string = cosmosDbDatabaseMemoryContainerName
output AZURE_OPENAI_ENDPOINT string = 'https://${aiFoundryAiServicesResourceName}.openai.azure.com/'
output AZURE_OPENAI_MODEL_NAME string = aiFoundryAiServicesModelDeployment.name
output AZURE_OPENAI_DEPLOYMENT_NAME string = aiFoundryAiServicesModelDeployment.name
output AZURE_OPENAI_API_VERSION string = azureopenaiVersion
// output APPLICATIONINSIGHTS_INSTRUMENTATION_KEY string = applicationInsights.outputs.instrumentationKey
// output AZURE_AI_PROJECT_ENDPOINT string = aiFoundryAiServices.outputs.aiProjectInfo.apiEndpoint
output AZURE_AI_SUBSCRIPTION_ID string = subscription().subscriptionId
output AZURE_AI_RESOURCE_GROUP string = resourceGroup().name
output AZURE_AI_PROJECT_NAME string = aiFoundryAiProjectName
output AZURE_AI_MODEL_DEPLOYMENT_NAME string = aiFoundryAiServicesModelDeployment.name
// output APPLICATIONINSIGHTS_CONNECTION_STRING string = applicationInsights.outputs.connectionString
output AZURE_AI_AGENT_MODEL_DEPLOYMENT_NAME string = aiFoundryAiServicesModelDeployment.name
output AZURE_AI_AGENT_ENDPOINT string = aiFoundryAiServices.outputs.aiProjectInfo.apiEndpoint
output APP_ENV string = 'Prod'
Loading
Loading