Skip to content

Quick Deploy Guide [Option B]

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/quick-deploy/deployment-guide-optionB/ 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 required resource providers (if not already registered on your subscription):

Register Microsoft Cognitive Services: 

az provider register --namespace Microsoft.CognitiveServices

Register Microsoft App: 

az provider register --namespace Microsoft.App

Register Microsoft App Configuration: 

az provider register --namespace Microsoft.AppConfiguration

NOTE: If you are running the latest azd version (version 1.23.9), please run the following command. 

azd config set provision.preflight off

Run the deployment:

Run the following command to provision all required Azure resources:

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 03

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

6. Test the agent

python scripts/07_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. Launch the application

The web application is already deployed during the initial azd up deployment. Open the app URL shown in the deployment output in your browser.

8. Customize for Your Industry (Optional)

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

Bring Your Own Data (Optional)

Instead of using AI-generated sample data, you can run the entire lab with your own data.

  1. Place your files in data/customdata/:

    data/customdata/
├── tables/
│   └── *.csv                   # One CSV per table
└── documents/
    └── *.pdf                   # PDF documents for AI Search

    The config/ folder (with ontology_config.json) is auto-generated from your CSV files. See data/customdata/README.md for details.

  2. Run the build with --custom-data:

    python scripts/00_build_solution.py --custom-data data/customdata --from 03

    You will be prompted for your Industry and Use Case. The script will auto-generate the config, skip step 01 (AI data generation), and run the remaining pipeline steps.

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