From 60f820a55f8c0d64d3d180b2be0a538dbb0a28c8 Mon Sep 17 00:00:00 2001 From: dkirby-ms Date: Tue, 1 Oct 2024 14:58:21 -0500 Subject: [PATCH 01/12] initialize folders --- docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md | 1 + .../retail/contoso_hypermarket/cleanup/_index.md | 1 + .../retail/contoso_hypermarket/data_pipeline/_index.md | 1 + .../retail/contoso_hypermarket/deployment/_index.md | 1 + .../retail/contoso_hypermarket/forecasting/_index.md | 1 + .../retail/contoso_hypermarket/intrusion_detection/_index.md | 1 + .../retail/contoso_hypermarket/observability/_index.md | 1 + .../retail/contoso_hypermarket/people_counting/_index.md | 1 + .../retail/contoso_hypermarket/speech_to_text/_index.md | 1 + .../retail/contoso_hypermarket/troubleshooting/_index.md | 1 + 10 files changed, 10 insertions(+) create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md create mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md new file mode 100644 index 00000000..864b9c1f --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md @@ -0,0 +1 @@ +# Contoso Hypermarket diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md new file mode 100644 index 00000000..652f37dc --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md @@ -0,0 +1 @@ +# Cleanup \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md new file mode 100644 index 00000000..633e77b4 --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md @@ -0,0 +1 @@ +# Data Pipeline \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md new file mode 100644 index 00000000..d36c65e5 --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md @@ -0,0 +1 @@ +# Deployment diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md new file mode 100644 index 00000000..d02047f1 --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md @@ -0,0 +1 @@ +# Forecasting / predictive analytics \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md new file mode 100644 index 00000000..2acdba72 --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md @@ -0,0 +1 @@ +# Intrusion Detection \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md new file mode 100644 index 00000000..c5ac4a2f --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md @@ -0,0 +1 @@ +# Observability \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md new file mode 100644 index 00000000..bf40c7df --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md @@ -0,0 +1 @@ +# People Counting \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md new file mode 100644 index 00000000..6f2e0eca --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md @@ -0,0 +1 @@ +# Speech to Text \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md new file mode 100644 index 00000000..64a80c87 --- /dev/null +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md @@ -0,0 +1 @@ +# Troubleshooting \ No newline at end of file From 762ea91de3441a67f37885259b0e19ff28733a03 Mon Sep 17 00:00:00 2001 From: dkirby-ms Date: Tue, 1 Oct 2024 15:58:47 -0500 Subject: [PATCH 02/12] add headers --- .../retail/contoso_hypermarket/_index.md | 7 +++++++ .../retail/contoso_hypermarket/cleanup/_index.md | 7 +++++++ .../retail/contoso_hypermarket/data_pipeline/_index.md | 7 +++++++ .../retail/contoso_hypermarket/deployment/_index.md | 7 +++++++ .../retail/contoso_hypermarket/forecasting/_index.md | 7 +++++++ .../contoso_hypermarket/intrusion_detection/_index.md | 7 +++++++ .../retail/contoso_hypermarket/observability/_index.md | 7 +++++++ .../retail/contoso_hypermarket/people_counting/_index.md | 7 +++++++ .../retail/contoso_hypermarket/speech_to_text/_index.md | 7 +++++++ .../retail/contoso_hypermarket/troubleshooting/_index.md | 7 +++++++ 10 files changed, 70 insertions(+) diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md index 864b9c1f..20c94743 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 1 +title: Contoso Hypermarket +linkTitle: Contoso Hypermarket +--- + # Contoso Hypermarket diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md index 652f37dc..92cc5a33 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 8 +title: Clean up environment +linkTitle: Cleanup +--- + # Cleanup \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md index 633e77b4..d4a8cf55 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 6 +title: Data pipeline +linkTitle: Data pipeline +--- + # Data Pipeline \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md index d36c65e5..0918f420 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 1 +title: Deployment +linkTitle: Deployment +--- + # Deployment diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md index d02047f1..5149473c 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 5 +title: Forecasting +linkTitle: Forecasting +--- + # Forecasting / predictive analytics \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md index 2acdba72..c000005f 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 3 +title: Intrusion detection +linkTitle: Intrusion detection +--- + # Intrusion Detection \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md index c5ac4a2f..df503d1a 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 7 +title: Observability +linkTitle: Observability +--- + # Observability \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md index bf40c7df..ece7f7d1 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 2 +title: People counting +linkTitle: People counting +--- + # People Counting \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md index 6f2e0eca..171173df 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 4 +title: Speech to text +linkTitle: Speech to text +--- + # Speech to Text \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md index 64a80c87..b55d6120 100644 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md +++ b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md @@ -1 +1,8 @@ +--- +type: docs +weight: 9 +title: Troubleshooting +linkTitle: Troubleshooting +--- + # Troubleshooting \ No newline at end of file From c4226094643a41dae3c17c59c49fef8338b9ab96 Mon Sep 17 00:00:00 2001 From: dkirby-ms Date: Wed, 23 Oct 2024 21:09:15 -0500 Subject: [PATCH 03/12] init --- .../{retail => }/contoso_hypermarket/_index.md | 0 .../contoso_hypermarket/cerebral/_index.md | 6 ++++++ .../{retail => }/contoso_hypermarket/cleanup/_index.md | 0 .../contoso_hypermarket/data_pipeline/_index.md | 0 .../{retail => }/contoso_hypermarket/deployment/_index.md | 0 .../footfall}/_index.md | 0 .../contoso_hypermarket/observability/_index.md | 0 .../contoso_hypermarket/predictive_analytics/_index.md | 8 ++++++++ .../contoso_hypermarket/shopper_insights/_index.md | 8 ++++++++ .../contoso_hypermarket/speech_to_text/_index.md | 0 .../contoso_hypermarket/troubleshooting/_index.md | 0 .../retail/contoso_hypermarket/forecasting/_index.md | 8 -------- .../contoso_hypermarket/intrusion_detection/_index.md | 8 -------- 13 files changed, 22 insertions(+), 16 deletions(-) rename docs/azure_jumpstart_ag/{retail => }/contoso_hypermarket/_index.md (100%) create mode 100644 docs/azure_jumpstart_ag/contoso_hypermarket/cerebral/_index.md rename docs/azure_jumpstart_ag/{retail => }/contoso_hypermarket/cleanup/_index.md (100%) rename docs/azure_jumpstart_ag/{retail => }/contoso_hypermarket/data_pipeline/_index.md (100%) rename docs/azure_jumpstart_ag/{retail => }/contoso_hypermarket/deployment/_index.md (100%) rename docs/azure_jumpstart_ag/{retail/contoso_hypermarket/people_counting => contoso_hypermarket/footfall}/_index.md (100%) rename docs/azure_jumpstart_ag/{retail => }/contoso_hypermarket/observability/_index.md (100%) create mode 100644 docs/azure_jumpstart_ag/contoso_hypermarket/predictive_analytics/_index.md create mode 100644 docs/azure_jumpstart_ag/contoso_hypermarket/shopper_insights/_index.md rename docs/azure_jumpstart_ag/{retail => }/contoso_hypermarket/speech_to_text/_index.md (100%) rename docs/azure_jumpstart_ag/{retail => }/contoso_hypermarket/troubleshooting/_index.md (100%) delete mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md delete mode 100644 docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/_index.md diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/cerebral/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/cerebral/_index.md new file mode 100644 index 00000000..b6fa194f --- /dev/null +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/cerebral/_index.md @@ -0,0 +1,6 @@ +--- +type: docs +weight: 6 +title: Cerebral +linkTitle: Cerebral +--- \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/cleanup/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/cleanup/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/cleanup/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/data_pipeline/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/data_pipeline/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/data_pipeline/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/deployment/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/deployment/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/deployment/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/footfall/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/people_counting/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/footfall/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/observability/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/observability/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/observability/_index.md diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/predictive_analytics/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/predictive_analytics/_index.md new file mode 100644 index 00000000..de150d7d --- /dev/null +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/predictive_analytics/_index.md @@ -0,0 +1,8 @@ +--- +type: docs +weight: 5 +title: Predictive Analytics +linkTitle: Predictive Analytics +--- + +# Predictive Analytics \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/shopper_insights/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/shopper_insights/_index.md new file mode 100644 index 00000000..beb6dd46 --- /dev/null +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/shopper_insights/_index.md @@ -0,0 +1,8 @@ +--- +type: docs +weight: 3 +title: Shopper Insights +linkTitle: Shopper Insights +--- + +# Shopper Insights \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/speech_to_text/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/speech_to_text/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/speech_to_text/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/troubleshooting/_index.md similarity index 100% rename from docs/azure_jumpstart_ag/retail/contoso_hypermarket/troubleshooting/_index.md rename to docs/azure_jumpstart_ag/contoso_hypermarket/troubleshooting/_index.md diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md deleted file mode 100644 index 5149473c..00000000 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/forecasting/_index.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -type: docs -weight: 5 -title: Forecasting -linkTitle: Forecasting ---- - -# Forecasting / predictive analytics \ No newline at end of file diff --git a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md b/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md deleted file mode 100644 index c000005f..00000000 --- a/docs/azure_jumpstart_ag/retail/contoso_hypermarket/intrusion_detection/_index.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -type: docs -weight: 3 -title: Intrusion detection -linkTitle: Intrusion detection ---- - -# Intrusion Detection \ No newline at end of file From 6466a624a1f0f21fd1325304831382098a2d8080 Mon Sep 17 00:00:00 2001 From: dkirby-ms Date: Thu, 24 Oct 2024 20:47:00 -0500 Subject: [PATCH 04/12] initial draft hm intro --- .../contoso_hypermarket/_index.md | 45 ++++++++++++++++++- 1 file changed, 43 insertions(+), 2 deletions(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 20c94743..42998a0a 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -1,8 +1,49 @@ --- type: docs weight: 1 -title: Contoso Hypermarket linkTitle: Contoso Hypermarket +description: >- + Learn how Contoso Hypermarket, an international consumer goods distributor and retailer, implements an AI-enhanced cloud-to-edge strategy with computer vision, next-gen language models, data pipelines, Microsoft Fabric, and Azure Arc. --- -# Contoso Hypermarket +# Contoso Hypermarket overview + +Contoso Hypermarket, an international consumer goods distributor and retailer, is at the forefront of the retail industry's digital transformation. Leveraging next-generation AI-powered shopper analytics solutions, Contoso Hypermarket utilizes advanced computer vision technologies to enhance customer experiences and optimize store operations. + +By integrating advanced computer vision into their retail facilities, Contoso Hypermarket can analyze shopper behavior in real-time, providing valuable insights into customer preferences and shopping patterns. These insights enable the hypermarket to tailor marketing strategies, optimize product placements, and improve inventory management, ensuring that customers find what they need quickly and efficiently. + +The AI-powered solutions also enhance maintenance and operational efficiency. With real-time monitoring and analytics, Contoso Hypermarket can detect errors or anomalies with automated checkout activities, manage equipment and detect malfunctions. This cutting-edge approach drives operational excellence, positioning Contoso Hypermarket as a leader in the retail sector. + +## Architecture and technology stack + +Contoso Hypermarket uses an AI technology stack, services, and processes to support their digital transformation. A set of reference use-cases is included with the Jumpstart Agora Contoso Hypermarket scenario. + +- **Natural language querying with small language models** - Using SLMs at the edge for natural language query (NLQ) interaction with Contoso operations and connected systems and data to support frontline workers and corporate personnel. +- **Computer vision for shopper analytics** - Computer vision using tuned inferencing models provides advanced shopper insights like foot traffic patterns, dwell time, product interaction, and demographic analysis. +- **Speech to text** - Converts spoken language into written text to facilitate customer service interactions, transcribe meetings, and support voice-activated commands for in-store assistance. +- **IoT at the Edge** - Manages IoT devices and sensors at the edge to collect and process data in real-time, enabling predictive maintenance, inventory tracking, and enhanced operational efficiency. +- **Predictive analytics with Copilot** - Analyzes sales and inventory trends and provides forecasting insights for optimizing inventory and sales. +- **Edge-to-cloud data pipeline** - Seamless data integration between IoT devices at the edge, customer and business data, and Microsoft Fabric, aggregating real-time shopper insights, centralized data management, predictive maintenance, and enhanced decision-making capabilities and enabling advanced data insights. + +## Virtual edge environment + +Jumpstart Agora provides virtual sandbox environments that simulate edge infrastructure deployments for industry solutions. The automation in the Contoso Hypermarket scenario deploys an Azure Virtual machine to support this "virtual" factory's AI technology. Additional features are included to further enhance the "virtual industry" experience in a lab setting, including simulated RTSP feeds, data emulators, and MQTT and OPC UA devices and data. Review the diagram and dedicated guides below to learn more about the virtual environment. + +![Applications and technology stack architecture diagram](./img/simulation_stack.png) + +## Getting started + +To get started with the "Contoso Hypermarket" Jumpstart Agora scenario, we provided you with a dedicated guide for each step of the way. The guides are designed to be as simple as possible but also keep the detailed-oriented spirit of the Jumpstart. + +| **Guide** | **Contoso Hypermarket service or platform** | **Technology stack** | +|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------| +| [Deployment guide](../contoso_hypermarket/deployment/) | Not applicable | Not applicable | +| [Jumpstart Cerebral](../contoso_hypermarket/cerebral/) | Natural Language Query | Azure OpenAI, phi3, gpt35turbo, Rancher K3s, InfluxDB, Microsoft SQL Server on Linux | +| [Data pipeline and reporting across cloud and edge](../contoso_hypermarket/data_pipeline/) | Operational technology (OT) | Azure IoT Operations, Microsoft Fabric, MQTT, Event Hub, Rancher K3s, InfluxDB, PostgreSQL, MQTT simulators | +| [Web UI and Computer vision](../contoso_hypermarket/ai_inferencing/) | Computer vision | Yolo8, RTSP, OpenCV, Rancher K3s, PostgreSQL, Azure Arc | +| [Speech-to-text](../contoso_hypermarket/speech_to_text/) | Customer service | Azure AI Speech, Rancher K3s, Azure Arc | +| [Predictive analytics with Copilot](../contoso_hypermarket/predictive_analytics/) | Predictive inventory | Microsoft Copilot | +| [Infrastructure observability for Kubernetes and Arc-enabled Kubernetes](../contoso_hypermarket/observability/) | Infrastructure | Arc-enabled Kubernetes, Rancher K3s, Prometheus, Grafana | +| [Cleanup deployment](../contoso_hypermarket/cleanup/) | Not applicable | Not applicable | +| [Troubleshooting](../contoso_hypermarket/troubleshooting/) | Not applicable | Not applicable | +| [Frequently asked questions (FAQ)](../../faq/) | Not applicable | Not applicable | From 6b4db39eed251e7debe412d1c785213c81b0879d Mon Sep 17 00:00:00 2001 From: dkirby-ms Date: Thu, 24 Oct 2024 20:51:51 -0500 Subject: [PATCH 05/12] M --- .../contoso_hypermarket/_index.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 42998a0a..1fd0384e 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -1,22 +1,22 @@ --- type: docs weight: 1 -linkTitle: Contoso Hypermarket +linkTitle: Contoso HyperMarket description: >- - Learn how Contoso Hypermarket, an international consumer goods distributor and retailer, implements an AI-enhanced cloud-to-edge strategy with computer vision, next-gen language models, data pipelines, Microsoft Fabric, and Azure Arc. + Learn how Contoso HyperMarket, an international consumer goods distributor and retailer, implements an AI-enhanced cloud-to-edge strategy with computer vision, next-gen language models, data pipelines, Microsoft Fabric, and Azure Arc. --- -# Contoso Hypermarket overview +# Contoso HyperMarket overview -Contoso Hypermarket, an international consumer goods distributor and retailer, is at the forefront of the retail industry's digital transformation. Leveraging next-generation AI-powered shopper analytics solutions, Contoso Hypermarket utilizes advanced computer vision technologies to enhance customer experiences and optimize store operations. +Contoso HyperMarket, an international consumer goods distributor and retailer, is at the forefront of the retail industry's digital transformation. Leveraging next-generation AI-powered shopper analytics solutions, Contoso HyperMarket utilizes advanced computer vision technologies to enhance customer experiences and optimize store operations. -By integrating advanced computer vision into their retail facilities, Contoso Hypermarket can analyze shopper behavior in real-time, providing valuable insights into customer preferences and shopping patterns. These insights enable the hypermarket to tailor marketing strategies, optimize product placements, and improve inventory management, ensuring that customers find what they need quickly and efficiently. +By integrating advanced computer vision into their retail facilities, Contoso HyperMarket can analyze shopper behavior in real-time, providing valuable insights into customer preferences and shopping patterns. These insights enable the hypermarket to tailor marketing strategies, optimize product placements, and improve inventory management, ensuring that customers find what they need quickly and efficiently. -The AI-powered solutions also enhance maintenance and operational efficiency. With real-time monitoring and analytics, Contoso Hypermarket can detect errors or anomalies with automated checkout activities, manage equipment and detect malfunctions. This cutting-edge approach drives operational excellence, positioning Contoso Hypermarket as a leader in the retail sector. +The AI-powered solutions also enhance maintenance and operational efficiency. With real-time monitoring and analytics, Contoso HyperMarket can detect errors or anomalies with automated checkout activities, manage equipment and detect malfunctions. This cutting-edge approach drives operational excellence, positioning Contoso HyperMarket as a leader in the retail sector. ## Architecture and technology stack -Contoso Hypermarket uses an AI technology stack, services, and processes to support their digital transformation. A set of reference use-cases is included with the Jumpstart Agora Contoso Hypermarket scenario. +Contoso HyperMarket uses an AI technology stack, services, and processes to support their digital transformation. A set of reference use-cases is included with the Jumpstart Agora Contoso HyperMarket scenario. - **Natural language querying with small language models** - Using SLMs at the edge for natural language query (NLQ) interaction with Contoso operations and connected systems and data to support frontline workers and corporate personnel. - **Computer vision for shopper analytics** - Computer vision using tuned inferencing models provides advanced shopper insights like foot traffic patterns, dwell time, product interaction, and demographic analysis. @@ -27,15 +27,15 @@ Contoso Hypermarket uses an AI technology stack, services, and processes to supp ## Virtual edge environment -Jumpstart Agora provides virtual sandbox environments that simulate edge infrastructure deployments for industry solutions. The automation in the Contoso Hypermarket scenario deploys an Azure Virtual machine to support this "virtual" factory's AI technology. Additional features are included to further enhance the "virtual industry" experience in a lab setting, including simulated RTSP feeds, data emulators, and MQTT and OPC UA devices and data. Review the diagram and dedicated guides below to learn more about the virtual environment. +Jumpstart Agora provides virtual sandbox environments that simulate edge infrastructure deployments for industry solutions. The automation in the Contoso HyperMarket scenario deploys an Azure Virtual machine to support this "virtual" factory's AI technology. Additional features are included to further enhance the "virtual industry" experience in a lab setting, including simulated RTSP feeds, data emulators, and MQTT and OPC UA devices and data. Review the diagram and dedicated guides below to learn more about the virtual environment. ![Applications and technology stack architecture diagram](./img/simulation_stack.png) ## Getting started -To get started with the "Contoso Hypermarket" Jumpstart Agora scenario, we provided you with a dedicated guide for each step of the way. The guides are designed to be as simple as possible but also keep the detailed-oriented spirit of the Jumpstart. +To get started with the "Contoso HyperMarket" Jumpstart Agora scenario, we provided you with a dedicated guide for each step of the way. The guides are designed to be as simple as possible but also keep the detailed-oriented spirit of the Jumpstart. -| **Guide** | **Contoso Hypermarket service or platform** | **Technology stack** | +| **Guide** | **Contoso HyperMarket service or platform** | **Technology stack** | |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------| | [Deployment guide](../contoso_hypermarket/deployment/) | Not applicable | Not applicable | | [Jumpstart Cerebral](../contoso_hypermarket/cerebral/) | Natural Language Query | Azure OpenAI, phi3, gpt35turbo, Rancher K3s, InfluxDB, Microsoft SQL Server on Linux | From fb5a624cfe23d4df1796c904146f7ccc7150a818 Mon Sep 17 00:00:00 2001 From: dkirby-ms Date: Thu, 24 Oct 2024 21:18:44 -0500 Subject: [PATCH 06/12] deployment guide text --- .../contoso_hypermarket/deployment/_index.md | 266 +++++++++++++++++- 1 file changed, 263 insertions(+), 3 deletions(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/deployment/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/deployment/_index.md index 0918f420..540c4594 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/deployment/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/deployment/_index.md @@ -1,8 +1,268 @@ --- type: docs weight: 1 -title: Deployment -linkTitle: Deployment +title: Deployment guide +linkTitle: Deployment guide --- -# Deployment +# Deployment guide + +## Overview + +Jumpstart Agora provides a simple deployment process using Azure Bicep and PowerShell that minimizes user interaction. This automation automatically configures the Contoso HyperMarket scenario environment, including the infrastructure, the Contoso HyperMarket AI applications, CI/CD artifacts, observability components, and cloud architecture. The diagram below details the high-level architecture that is deployed and configured as part of the automation. + +![Architecture diagram](./img/architecture_diagram.png) + +Deploying the "Contoso HyperMarket" scenario consists of the following steps (once prerequisites are met). + + 1. Deploy infrastructure - The user deploys a Bicep file that creates the infrastructure in an Azure resource group. + 2. Bicep template deploys multiple Azure resources including the Client virtual machine. + 3. Client VM uses a custom script extension to run the Bootstrap PowerShell script which initializes the environment. + 4. Bootstrap script injects the Logon script to the Client VM. + 5. User logs in to the _Agora-VM-Client_ Azure virtual machine. + 6. After login the _Agora-VM-Client_ PowerShell scripts automatically run that configure the infrastructure, applications and CI/CD. These scripts will take some time to run. + +Once automation is complete, users can immediately start enjoying the Contoso HyperMarket experience. + +![Deployment flow architecture diagram](./img/deployment_workflow.png) + +## Prerequisites + +- [Install or update Azure CLI to version 2.65.0 or above](https://learn.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest). Use the following command to check your current installed version. + + ```shell + az --version + ``` + +- Login to Azure CLI using the *`az login`* command. + +- Ensure that you have selected the correct subscription you want to deploy Agora to by using the *`az account list --query "[?isDefault]"`* command. If you need to adjust the active subscription used by Az CLI, follow [this guidance](https://learn.microsoft.com/cli/azure/manage-azure-subscriptions-azure-cli#change-the-active-subscription). + +- Agora must be deployed to one of the following regions. **Deploying Agora outside of these regions may result in unexpected results or deployment errors.** + + - East US + - East US 2 + - West US 2 + - North Europe + - West Europe + +- **Agora requires 40 Ds-series vCPUs**. Ensure you have sufficient vCPU quota available in your Azure subscription and the region where you plan to deploy Agora. You can use the below Az CLI command to check your vCPU utilization. + + ```shell + az vm list-usage --location --output table + ``` + + ![Screenshot showing az vm list-usage](./img/az_vm_list_usage.png) + +- Create Azure service principal (SP). An Azure service principal assigned with the _Owner_ Role-based access control (RBAC) role is required. You can use Azure Cloud Shell (or other Bash shell), or PowerShell to create the service principal. + + - (Option 1) Create service principal using [Azure Cloud Shell](https://shell.azure.com/) or Bash shell with Azure CLI: + + ```shell + az login + subscriptionId=$(az account show --query id --output tsv) + az ad sp create-for-rbac -n "" --role "Owner" --scopes /subscriptions/$subscriptionId + ``` + + For example: + + ```shell + az login + subscriptionId=$(az account show --query id --output tsv) + az ad sp create-for-rbac -n "JumpstartAgoraSPN" --role "Owner" --scopes /subscriptions/$subscriptionId + ``` + + Output should look similar to this: + + ```json + { + "appId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX", + "displayName": "JumpstartAgora", + "password": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX", + "tenant": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX" + } + ``` + + - (Option 2) Create service principal using PowerShell. If necessary, follow [this documentation](https://learn.microsoft.com/powershell/azure/install-az-ps?view=azps-8.3.0) to install Azure PowerShell modules. + + ```powershell + $account = Connect-AzAccount + $spn = New-AzADServicePrincipal -DisplayName "" -Role "Owner" -Scope "/subscriptions/$($account.Context.Subscription.Id)" + echo "SPN App id: $($spn.AppId)" + echo "SPN secret: $($spn.PasswordCredentials.SecretText)" + echo "SPN tenant: $($account.Context.Tenant.Id)" + ``` + + For example: + + ```powershell + $account = Connect-AzAccount + $spn = New-AzADServicePrincipal -DisplayName "JumpstartAgoraSPN" -Role "Owner" -Scope "/subscriptions/$($account.Context.Subscription.Id)" + echo "SPN App id: $($spn.AppId)" + echo "SPN secret: $($spn.PasswordCredentials.SecretText)" + ``` + + Output should look similar to this: + + ![Screenshot showing creating an SPN with PowerShell](./img/create_spn_powershell.png) + + > **Note:** If you create multiple subsequent role assignments on the same service principal, your client secret (password) will be destroyed and recreated each time. Therefore, make sure you grab the correct secret. + + > **Note:** The Jumpstart scenarios are designed with as much ease of use in mind and adhering to security-related best practices whenever possible. It is optional but highly recommended to scope the service principal to a specific [Azure subscription and resource group](https://learn.microsoft.com/cli/azure/ad/sp?view=azure-cli-latest) as well as considering using a [less privileged service principal account](https://learn.microsoft.com/azure/role-based-access-control/best-practices). + +- Clone the Azure Arc Jumpstart repository + + ```shell + git clone https://github.com/microsoft/azure_arc.git + ``` + +- Azure IoT Operations requires creating a "user_impersonation" delegated permission on Azure Key Vault for this service principal. + + - Navigate to *Microsoft Entra Id* (previously known as Azure Active Directory) in the Azure portal. + + ![Screenshot showing searching for Microsoft Entra ID in the Azure portal](./img/entra_id_portal.png) + + - Click on "App registrations" and search for the name of the service principal you created. + + ![Screenshot showing searching for the service principal in the Entra Id portal](./img/entra_id_search.png) + + - Click on "API permissions" and add a new permission. + + ![Screenshot showing adding a new API permission](./img/entra_id_add_permission.png) + + - Select "Azure Key Vault". + + ![Screenshot showing adding a new API permission](./img/entra_id_keyvault_permission.png) + + - Click on "Delegated permissions" and select the "user_impersonation" permission. + + ![Screenshot showing adding a new API permission](./img/entra_id_user_impersonation.png) + + ![Screenshot showing added API permission](./img/entra_id_permission_added.png) + +## Deployment: Bicep deployment via Azure CLI + +- Upgrade to latest Bicep version + + ```shell + az bicep upgrade + ``` + +- Edit the [main.parameters.json](https://github.com/microsoft/azure_arc/blob/main/azure_jumpstart_ag/contoso_hypermarket/bicep/main.parameters.json) template parameters file and supply some values for your environment. + - _`spnClientId`_ - Your Azure service principal application id + - _`spnClientSecret`_ - Your Azure service principal secret + - _`spnObjectId`_ - Your Azure service principal id + - _`spnTenantId`_ - Your Azure tenant id + - _`windowsAdminUsername`_ - Client Windows VM Administrator username + - _`windowsAdminPassword`_ - Client Windows VM Password. Password must have 3 of the following: 1 lower case character, 1 upper case character, 1 number, and 1 special character. The value must be between 12 and 123 characters long. + - _`deployBastion`_ - Option to deploy using Azure Bastion instead of traditional RDP. Set to *`true`* or *`false`*. + - _`customLocationRPOID`_ - Custom location resource prodivder id. + +-To get the `spnObjectId`, you can use Azure CLI or Azure PowerShell. + + - (Option 1) Using [Azure Cloud Shell](https://shell.azure.com/) or Bash shell with Azure CLI. + + ```shell + az ad sp show --id "" --query id -o tsv + ``` + + - (Option 2) Using PowerShell. If necessary, follow [this documentation](https://learn.microsoft.com/powershell/azure/install-az-ps?view=azps-8.3.0) to install Azure PowerShell modules. + + ```powershell + (Get-AzADServicePrincipal -ApplicationId "").Id + ``` + + ![Screenshot showing example parameters](./img/parameters_bicep.png) + +- You will need to get the Azure Custom Location Resource Provider (RP) Object ID (OID) and export it as an environment variable. This is required to enable [Custom Location](https://learn.microsoft.com/azure/azure-arc/platform/conceptual-custom-locations) on your cluster. + +> **Note:** You need permissions to list all the service principals. + +### Option 1: Bash + + ```shell + customLocationRPOID=$(az ad sp list --filter "displayname eq 'Custom Locations RP'" --query "[?appDisplayName=='Custom Locations RP'].id" -o tsv) + ``` + +### Option 2: PowerShell + + ```powershell + $customLocationRPOID=(az ad sp list --filter "displayname eq 'Custom Locations RP'" --query "[?appDisplayName=='Custom Locations RP'].id" -o tsv) + ``` + +- Now you will deploy the Bicep file. Navigate to the local cloned [deployment folder](https://github.com/microsoft/azure_arc/tree/main/azure_jumpstart_ag/contoso_hypermarket/bicep) and run the below command: + + ```shell + az login + az group create --name "" --location "" + az deployment group create -g "" -f "main.bicep" -p "main.parameters.json" -p customLocationRPOID="$customLocationRPOID" + ``` + + > **Note:** If you see any failure in the deployment, please check the [troubleshooting guide](../troubleshooting/). + +## Start post-deployment automation + +Once your deployment is complete, you can open the Azure portal and see the Agora scenario resources inside your resource group. You will be using the _Agora-Client-VM_ Azure virtual machine to explore various capabilities of Agora. You will need to remotely access _Agora-Client-VM_. + + ![Screenshot showing all deployed resources in the resource group](./img/deployed_resources.png) + + > **Note:** For enhanced Agora security posture, RDP (3389) and SSH (22) ports are not open by default in Agora deployments. You will need to create a network security group (NSG) rule to allow network access to port 3389, or use [Azure Bastion](https://learn.microsoft.com/azure/bastion/bastion-overview) or [Just-in-Time (JIT)](https://learn.microsoft.com/azure/defender-for-cloud/just-in-time-access-usage?tabs=jit-config-asc%2Cjit-request-asc) access to connect to the VM. + +### Connecting to the Agora Client virtual machine + +Various options are available to connect to _Agora-Client-VM_, depending on the parameters you supplied during deployment. + +- [RDP](../deployment/#connecting-directly-with-rdp) - available after configuring access to port 3389 on the _Agora-NSG-Prod_, or by enabling [Just-in-Time access (JIT)](../deployment/#connect-using-just-in-time-access-jit). +- [Azure Bastion](../deployment/#connect-using-azure-bastion) - available if *`true`* was the value of your _`deployBastion`_ parameter during deployment. + +#### Connecting directly with RDP + +By design, Agora does not open port 3389 on the network security group. Therefore, you must create an NSG rule to allow inbound 3389. + +- Open the _Agora-NSG-Prod_ resource in Azure portal and click "Add" to add a new rule. + + ![Screenshot showing adding a new inbound security rule](./img/nsg_add_rule.png) + +- Select My IP address from the dropdown. + + Screenshot showing adding a new allow RDP inbound security rule + +
+ + ![Screenshot showing all inbound security rule](./img/nsg_rdp_all_rules.png) + + ![Screenshot showing connecting to the VM using RDP](./img/rdp_connect.png) + +#### Connect using Azure Bastion + +- If you have chosen to deploy Azure Bastion in your deployment, use it to connect to the VM. + + ![Screenshot showing connecting to the VM using Bastion](./img/bastion_connect.png) + + > **Note:** When using Azure Bastion, the desktop background image is not visible. Therefore some screenshots in this guide may not exactly match your experience if you are connecting to _Agora-Client-VM_ with Azure Bastion. + +#### Connect using just-in-time access (JIT) + +If you already have [Microsoft Defender for Cloud](https://learn.microsoft.com/azure/defender-for-cloud/just-in-time-access-usage?tabs=jit-config-asc%2Cjit-request-asc) enabled on your subscription and would like to use JIT to access the Client VM, use the following steps: + +- In the Client VM configuration pane, enable just-in-time. This will enable the default settings. + + ![Screenshot showing how to enable JIT](./img/enable_jit.png) + + ![Screenshot showing connecting to the VM using RDP](./img/connect_jit.png) + +### The Logon scripts + +- Once you log into the _Agora-Client-VM_, multiple automated scripts will open and start running. These scripts usually take around thirty minutes to finish, and once completed, the script windows will close automatically. At this point, the deployment is complete. + + ![Screenshot showing Agora-Client-VM](./img/automation.png) + +- Deployment is complete! Let's begin exploring the features of Contoso HyperMarket! + + ![Screenshot showing complete deployment](./img/contoso_hypermarket_complete.png) + + ![Screenshot showing Agora resources in Azure portal](./img/rg_complete.png) + +## Next steps + +Once deployment is complete its time to start experimenting with the various scenarios under the “Contoso HyperMarket” experience, starting with the [“Data pipeline and reporting across cloud and edge for Contoso HyperMarket”](../data_opc/). From 1bad0b4bce21c82b9f676f246005e7090d70cbb4 Mon Sep 17 00:00:00 2001 From: Dale Kirby <32211549+dkirby-ms@users.noreply.github.com> Date: Fri, 25 Oct 2024 08:05:32 -0500 Subject: [PATCH 07/12] Update docs/azure_jumpstart_ag/contoso_hypermarket/_index.md Co-authored-by: Lior Kamrat <46730876+likamrat@users.noreply.github.com> --- docs/azure_jumpstart_ag/contoso_hypermarket/_index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 1fd0384e..09adfb84 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -10,9 +10,9 @@ description: >- Contoso HyperMarket, an international consumer goods distributor and retailer, is at the forefront of the retail industry's digital transformation. Leveraging next-generation AI-powered shopper analytics solutions, Contoso HyperMarket utilizes advanced computer vision technologies to enhance customer experiences and optimize store operations. -By integrating advanced computer vision into their retail facilities, Contoso HyperMarket can analyze shopper behavior in real-time, providing valuable insights into customer preferences and shopping patterns. These insights enable the hypermarket to tailor marketing strategies, optimize product placements, and improve inventory management, ensuring that customers find what they need quickly and efficiently. +By integrating advanced computer vision into their retail facilities, Contoso HyperMarket can analyze shopper behavior in real-time, providing valuable insights into customer preferences and shopping patterns. These insights enable them to tailor marketing strategies, optimize product placements, and improve inventory management, ensuring that customers find what they need quickly and efficiently. -The AI-powered solutions also enhance maintenance and operational efficiency. With real-time monitoring and analytics, Contoso HyperMarket can detect errors or anomalies with automated checkout activities, manage equipment and detect malfunctions. This cutting-edge approach drives operational excellence, positioning Contoso HyperMarket as a leader in the retail sector. +The AI-powered solutions also enhance maintenance and operational efficiency. With real-time monitoring and analytics, Contoso HyperMarket can detect errors or anomalies with automated checkout activities, manage equipment and detect malfunctions. This innovative approach drives operational excellence, positioning Contoso HyperMarket as a leader in the retail sector. ## Architecture and technology stack From 8e663fe9516b59ce1d63f1bd304268b9c3a84b80 Mon Sep 17 00:00:00 2001 From: Dale Kirby <32211549+dkirby-ms@users.noreply.github.com> Date: Fri, 25 Oct 2024 08:05:57 -0500 Subject: [PATCH 08/12] Update docs/azure_jumpstart_ag/contoso_hypermarket/_index.md Co-authored-by: Lior Kamrat <46730876+likamrat@users.noreply.github.com> --- docs/azure_jumpstart_ag/contoso_hypermarket/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 09adfb84..7ba8609c 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -19,7 +19,7 @@ The AI-powered solutions also enhance maintenance and operational efficiency. Wi Contoso HyperMarket uses an AI technology stack, services, and processes to support their digital transformation. A set of reference use-cases is included with the Jumpstart Agora Contoso HyperMarket scenario. - **Natural language querying with small language models** - Using SLMs at the edge for natural language query (NLQ) interaction with Contoso operations and connected systems and data to support frontline workers and corporate personnel. -- **Computer vision for shopper analytics** - Computer vision using tuned inferencing models provides advanced shopper insights like foot traffic patterns, dwell time, product interaction, and demographic analysis. +- **Computer vision for shopper insights** - Computer vision using tuned inferencing models provides advanced shopper insights like foot traffic patterns, dwell time, product interaction, and demographic analysis. - **Speech to text** - Converts spoken language into written text to facilitate customer service interactions, transcribe meetings, and support voice-activated commands for in-store assistance. - **IoT at the Edge** - Manages IoT devices and sensors at the edge to collect and process data in real-time, enabling predictive maintenance, inventory tracking, and enhanced operational efficiency. - **Predictive analytics with Copilot** - Analyzes sales and inventory trends and provides forecasting insights for optimizing inventory and sales. From 4d7d3d5b1aa7447f626850c693b953d5b6043286 Mon Sep 17 00:00:00 2001 From: Dale Kirby <32211549+dkirby-ms@users.noreply.github.com> Date: Fri, 25 Oct 2024 08:06:04 -0500 Subject: [PATCH 09/12] Update docs/azure_jumpstart_ag/contoso_hypermarket/_index.md Co-authored-by: Lior Kamrat <46730876+likamrat@users.noreply.github.com> --- docs/azure_jumpstart_ag/contoso_hypermarket/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 7ba8609c..9f9f98f1 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -22,7 +22,7 @@ Contoso HyperMarket uses an AI technology stack, services, and processes to supp - **Computer vision for shopper insights** - Computer vision using tuned inferencing models provides advanced shopper insights like foot traffic patterns, dwell time, product interaction, and demographic analysis. - **Speech to text** - Converts spoken language into written text to facilitate customer service interactions, transcribe meetings, and support voice-activated commands for in-store assistance. - **IoT at the Edge** - Manages IoT devices and sensors at the edge to collect and process data in real-time, enabling predictive maintenance, inventory tracking, and enhanced operational efficiency. -- **Predictive analytics with Copilot** - Analyzes sales and inventory trends and provides forecasting insights for optimizing inventory and sales. +- **Predictive inventory and operations analytics with Microsoft Copilot** - Analyzes sales and inventory trends and provides forecasting insights for optimizing inventory and sales. - **Edge-to-cloud data pipeline** - Seamless data integration between IoT devices at the edge, customer and business data, and Microsoft Fabric, aggregating real-time shopper insights, centralized data management, predictive maintenance, and enhanced decision-making capabilities and enabling advanced data insights. ## Virtual edge environment From e99c5cd88703e6a317c23ae7088910423998735d Mon Sep 17 00:00:00 2001 From: Dale Kirby <32211549+dkirby-ms@users.noreply.github.com> Date: Fri, 25 Oct 2024 08:06:12 -0500 Subject: [PATCH 10/12] Update docs/azure_jumpstart_ag/contoso_hypermarket/_index.md Co-authored-by: Lior Kamrat <46730876+likamrat@users.noreply.github.com> --- docs/azure_jumpstart_ag/contoso_hypermarket/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 9f9f98f1..13c3aebd 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -25,7 +25,7 @@ Contoso HyperMarket uses an AI technology stack, services, and processes to supp - **Predictive inventory and operations analytics with Microsoft Copilot** - Analyzes sales and inventory trends and provides forecasting insights for optimizing inventory and sales. - **Edge-to-cloud data pipeline** - Seamless data integration between IoT devices at the edge, customer and business data, and Microsoft Fabric, aggregating real-time shopper insights, centralized data management, predictive maintenance, and enhanced decision-making capabilities and enabling advanced data insights. -## Virtual edge environment +## Virtual sandbox edge environment Jumpstart Agora provides virtual sandbox environments that simulate edge infrastructure deployments for industry solutions. The automation in the Contoso HyperMarket scenario deploys an Azure Virtual machine to support this "virtual" factory's AI technology. Additional features are included to further enhance the "virtual industry" experience in a lab setting, including simulated RTSP feeds, data emulators, and MQTT and OPC UA devices and data. Review the diagram and dedicated guides below to learn more about the virtual environment. From 2291f318820d9d5ce20610fd5e6c97726d05ba59 Mon Sep 17 00:00:00 2001 From: Dale Kirby <32211549+dkirby-ms@users.noreply.github.com> Date: Fri, 25 Oct 2024 08:06:23 -0500 Subject: [PATCH 11/12] Update docs/azure_jumpstart_ag/contoso_hypermarket/_index.md Co-authored-by: Lior Kamrat <46730876+likamrat@users.noreply.github.com> --- docs/azure_jumpstart_ag/contoso_hypermarket/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 13c3aebd..3812adbf 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -27,7 +27,7 @@ Contoso HyperMarket uses an AI technology stack, services, and processes to supp ## Virtual sandbox edge environment -Jumpstart Agora provides virtual sandbox environments that simulate edge infrastructure deployments for industry solutions. The automation in the Contoso HyperMarket scenario deploys an Azure Virtual machine to support this "virtual" factory's AI technology. Additional features are included to further enhance the "virtual industry" experience in a lab setting, including simulated RTSP feeds, data emulators, and MQTT and OPC UA devices and data. Review the diagram and dedicated guides below to learn more about the virtual environment. +Jumpstart Agora provides virtual sandbox environments that simulate edge infrastructure deployments for industry solutions. The automation in the Contoso HyperMarket scenario deploys an Azure Virtual machine to support this "virtual" factory's AI technology. Additional features are included to further enhance the "virtual industry" experience in a lab setting, including simulated Real-Time Streaming Protocol (RTSP) feeds, data emulators, MQTT, industrial assets, and data. Review the diagram and dedicated guides below to learn more about the virtual environment. ![Applications and technology stack architecture diagram](./img/simulation_stack.png) From a4648824459cac63dd37ce6988ba2c2207d77dbe Mon Sep 17 00:00:00 2001 From: Dale Kirby <32211549+dkirby-ms@users.noreply.github.com> Date: Fri, 25 Oct 2024 08:06:28 -0500 Subject: [PATCH 12/12] Update docs/azure_jumpstart_ag/contoso_hypermarket/_index.md Co-authored-by: Lior Kamrat <46730876+likamrat@users.noreply.github.com> --- docs/azure_jumpstart_ag/contoso_hypermarket/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md index 3812adbf..a6a3b673 100644 --- a/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md +++ b/docs/azure_jumpstart_ag/contoso_hypermarket/_index.md @@ -42,7 +42,7 @@ To get started with the "Contoso HyperMarket" Jumpstart Agora scenario, we provi | [Data pipeline and reporting across cloud and edge](../contoso_hypermarket/data_pipeline/) | Operational technology (OT) | Azure IoT Operations, Microsoft Fabric, MQTT, Event Hub, Rancher K3s, InfluxDB, PostgreSQL, MQTT simulators | | [Web UI and Computer vision](../contoso_hypermarket/ai_inferencing/) | Computer vision | Yolo8, RTSP, OpenCV, Rancher K3s, PostgreSQL, Azure Arc | | [Speech-to-text](../contoso_hypermarket/speech_to_text/) | Customer service | Azure AI Speech, Rancher K3s, Azure Arc | -| [Predictive analytics with Copilot](../contoso_hypermarket/predictive_analytics/) | Predictive inventory | Microsoft Copilot | +| [Predictive analytics with Microsoft Copilot](../contoso_hypermarket/predictive_analytics/) | Predictive inventory | Microsoft Copilot | | [Infrastructure observability for Kubernetes and Arc-enabled Kubernetes](../contoso_hypermarket/observability/) | Infrastructure | Arc-enabled Kubernetes, Rancher K3s, Prometheus, Grafana | | [Cleanup deployment](../contoso_hypermarket/cleanup/) | Not applicable | Not applicable | | [Troubleshooting](../contoso_hypermarket/troubleshooting/) | Not applicable | Not applicable |