Skip to content

Quick Deploy Guide [Option A]

Prerequisites

Choose Your Development Environment

Local Visual Studio Code: Open Visual Studio Code. From the File menu, select Open Folder and choose the folder where you want to deploy the workshop.

Or choose one of the options below:

Open in GitHub Codespaces Open in VS Code Web

Note: Please use this optional prompt if you would like to use GitHub Copilot to run the workshop: 

Can you please follow the step by step in https://microsoft.github.io/agentic-applications-for-unified-data-foundation-solution-accelerator/deployment-guide-optionA/ for me.
Important instructions:
Do NOT make any code changes to the repository files. 
Only follow the deployment guide instructions exactly as documented. 
Run the commands step by step and wait for each to complete before proceeding.
If I encounter any errors or issues, help me troubleshoot and resolve them before continuing.
Explain what each step does before running it.
If a step fails, suggest solutions based on the error message.

Azure-Only Deployment

1. Clone the repository

git clone https://github.com/microsoft/agentic-applications-for-unified-data-foundation-solution-accelerator.git

cd agentic-applications-for-unified-data-foundation-solution-accelerator

2. Enable Azure-only mode

When prompted for an environment name, enter a unique 3–20 character alphanumeric value (this is used to prefix resources and prevent conflicts).

azd env set AZURE_ENV_ONLY true

3. Deploy Azure resources

azd auth login

az login

VS Code Web users: Use az login --use-device-code since browser-based login is not supported in VS Code Web.

Register the Microsoft Cognitive Services resource provider (required if not already registered on your subscription):

az provider register --namespace Microsoft.CognitiveServices

azd up

When you start the deployment, you will need to set the following parameters:

Setting Description Default value
Azure Subscription The Azure subscription to deploy resources into. Only prompted if you have multiple subscriptions. (auto-selected if only one)
Azure Region The region where resources will be created. (empty)
AI Model Location The region where AI model will be created *(empty)

Different tenant? Use: azd auth login --tenant-id <tenant-id>

4. Setup Python environment

python -m venv .venv

.venv\Scripts\activate   # or: source .venv/bin/activate

pip install uv && uv pip install -r scripts/requirements.txt

5. Build the solution

az login

VS Code Web users: Use az login --use-device-code since browser-based login is not supported in VS Code Web.

python scripts/00_build_solution.py --from 04

Note: Press Enter key to start or Ctrl+C to cancel the process.

6. Test the agent

python scripts/08_test_agent.py

Sample questions to try:

  • "How many tickets are high priority"
  • "What is the average score from inspections?"
  • "What constitutes a failed inspection?"
  • "Do any inspections violate quality control standards in our Inspection Procedures?"

7. Deploy the application

azd env set AZURE_ENV_DEPLOY_APP true

azd up

8. Set up app permissions

python scripts/00_build_solution.py --from 09

Note: Press Enter key to start or Ctrl+C to cancel the process.

After the agent configuration & API permission set up completes, open the app URL shown in the output.

9. Customize for Your Industry (Optional)

Follow steps in this page to Customize for your use case.

Repository: github.com/microsoft/agentic-applications-for-unified-data-foundation-solution-accelerator