Skip to content

Commit f5d4830

Browse files
committed
Fix blocking review feedback for Module 10
1 parent a27954d commit f5d4830

8 files changed

Lines changed: 43 additions & 43 deletions

learn-pr/wwl/design-alm-process-ai-powered-business-solutions/includes/1-introduction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
AI powered business solutions introduce new layers of complexity that extend far beyond traditional software lifecycle practices. Models evolve, data shifts, prompts change behavior, and AI agents adapt based on context. As a result, organizations must adopt a disciplined, end-to-end application lifecycle management (ALM) approach.
1+
AI-powered business solutions introduce new layers of complexity that extend far beyond traditional software lifecycle practices. Models evolve, data shifts, prompts change behavior, and AI agents adapt based on context. As a result, organizations must adopt a disciplined, end-to-end application lifecycle management (ALM) approach.
22
This approach governs application code, datasets, prompts, connectors, and model configurations. This module gives solution architects the framework they need to establish that discipline across the entire AI solution stack.
33

44
In this module, learners explore how to design ALM processes that keep AI components governed, reproducible, secure, and monitored from development through retirement across multiple Microsoft technologies. This module explains how AI data, Copilot Studio assets, Microsoft Foundry agents, custom AI models, and Dynamics 365 AI features move through structured environments.

learn-pr/wwl/design-alm-process-ai-powered-business-solutions/includes/2-design-alm-process-data-used-ai-models-agents.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ By the end of this unit, learners are be able to:
1212

1313
* Specify **data residency and movement** policies for Copilot and agent features.
1414

15-
* Operationalize **quality, lineage, and drift** checks with go/nogo criteria and rollback plans.
15+
* Operationalize **quality, lineage, and drift** checks with go/no-go criteria and rollback plans.
1616

1717
* Establish a **RACI** and change workflows for datasets, knowledge sources, and evaluation telemetry.
1818

@@ -46,7 +46,7 @@ By the end of this unit, learners are be able to:
4646

4747
* **Professional visual—Environment & data flow (text diagram)**<br>Dev (Red data → feature builds) → Test (Repro runs, evaluation sets) → Pre-Prod (Gold candidates) → Prod (Gold only)<br>Controls at each hop: validation → approval → immutable snapshot → catalog update
4848

49-
## The AI data ALM process (endtoend)
49+
## The AI data ALM process (end-to-end)
5050

5151
### Phase A—Plan & Catalog
5252

@@ -82,7 +82,7 @@ By the end of this unit, learners are be able to:
8282

8383
* Perform **privacy, security, and compliance** reviews (DLP, RAI, export controls).
8484

85-
* Execute **canary runs** using masked/representative Prod like data.
85+
* Execute **canary runs** using masked/representative Prod-like data.
8686

8787
* _Canary testing is a low-risk deployment strategy.
8888
It releases new code to a small, isolated subset of users or servers to identify issues before a full rollout._
@@ -129,13 +129,13 @@ It releases new code to a small, isolated subset of users or servers to identify
129129

130130
## Region, residency, and cross-border movement
131131

132-
Document **where** prompts/outputs may be processed for Copilot and Power Platform features, and when **cross region capacity** is required.
132+
Document **where** prompts/outputs may be processed for Copilot and Power Platform features, and when **cross-region capacity** is required.
133133

134-
In regulated scenarios, set the default to **inregion** and require explicit approval to enable **overflow processing**.
134+
In regulated scenarios, set the default to **in-region** and require explicit approval to enable **overflow processing**.
135135

136136
Align **mailbox region** (for activity data) and environment geo with your policy; define exceptions and purge schedules.
137137

138-
Professional visual—Residency decision tree (text)<br>Inregion capacity available? → Yes: keep local.<br>No: Is overflow allowed for this workload tier? → If yes, enable cross region under admin control; else block feature or defer.
138+
Professional visual—Residency decision tree (text)<br>In-region capacity available? → Yes: keep local.<br>No: Is overflow allowed for this workload tier? → If yes, enable cross-region under admin control; else block feature or defer.
139139

140140
## Roles and RACI
141141

@@ -160,7 +160,7 @@ The below RACI chart is a representative sample for an organization. It's up to
160160

161161
Maintain **baseline metrics** per release: latency p95, success %, token/€ per task, safety flags/M runs.
162162

163-
Compare live to baseline; if drift exceeds thresholds, **autoopen an incident**, route to data owner, and pause affected actions.
163+
Compare live to baseline; if drift exceeds thresholds, **auto-open an incident**, route to data owner, and pause affected actions.
164164

165165
Rerun evaluation suites nightly/weekly against **golden sets**; store time series for audit.
166166

learn-pr/wwl/design-alm-process-ai-powered-business-solutions/includes/3-design-alm-process-copilot-studio-agents-connectors-actions.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## Overview
22

3-
This unit guides solution architects through designing an Application Lifecycle Management (ALM) process tailored for **Copilot Studio agents, connectors, and custom actions**. A welldefined ALM strategy ensures that Copilotbased solutions are **consistent, secure, governed, versioncontrolled, and ready for enterprise scale** across development, testing, and production environments.
3+
This unit guides solution architects through designing an Application Lifecycle Management (ALM) process tailored for **Copilot Studio agents, connectors, and custom actions**. A well-defined ALM strategy ensures that Copilot-based solutions are **consistent, secure, governed, version-controlled, and ready for enterprise scale** across development, testing, and production environments.
44

55
Architects learn how to structure solution components into managed lifecycles, establish promotion and approval workflows, manage data and environment boundaries, and integrate development tooling—enabling a predictable, repeatable process that aligns with enterprise governance.
66

@@ -44,7 +44,7 @@ Sustainable lifecycle for updates and deprecations
4444

4545
No direct editing in production
4646

47-
Enforce rolebased access at each tier
47+
Enforce role-based access at each tier
4848

4949
Managed solutions only in Test and Prod
5050

@@ -76,15 +76,15 @@ Build actions and prompts
7676

7777
Add knowledge sources in Dev only
7878

79-
Test agent workflows with edgecase prompts
79+
Test agent workflows with edge-case prompts
8080

8181
### 3.2 Testing Stage
8282

8383
Validate reasoning quality and output patterns
8484

8585
Ensure grounding is reliable and compliant
8686

87-
Evaluate eventtriggered actions
87+
Evaluate event-triggered actions
8888

8989
Run regression tests on all agent topics
9090

@@ -148,7 +148,7 @@ Use Visual Studio Code for Copilot connector development where applicable
148148

149149
### Adopt release cadence
150150

151-
Monthly or sprintbased release cycles
151+
Monthly or sprint-based release cycles
152152

153153
Emergency patch process for critical fixes
154154

@@ -164,11 +164,11 @@ ALM must align with enterprise governance rules:
164164

165165
DLP policy enforcement
166166

167-
Environmentspecific connector rules
167+
Environment-specific connector rules
168168

169169
Data residency restrictions
170170

171-
Enterpriseapproved knowledge sources
171+
Enterprise-approved knowledge sources
172172

173173
Review gate for safety, quality, and ethical risk
174174

learn-pr/wwl/design-alm-process-ai-powered-business-solutions/includes/4-design-alm-process-microsoft-foundry-agents.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
## Overview
22

3-
This unit equips solution architects with the knowledge to design a complete Application Lifecycle Management (ALM) process for **Microsoft Foundry agents**. Foundry introduces a structured, enterprisegrade model for creating, governing, deploying, and maintaining agents across environments. A robust ALM approach ensures controlled development, quality assurance, predictable deployment, and secure runtime operations.
3+
This unit equips solution architects with the knowledge to design a complete Application Lifecycle Management (ALM) process for **Microsoft Foundry agents**. Foundry introduces a structured, enterprise-grade model for creating, governing, deploying, and maintaining agents across environments. A robust ALM approach ensures controlled development, quality assurance, predictable deployment, and secure runtime operations.
44

5-
Solution architects must implement ALM processes that standardize agent creation, maintain configuration discipline, control data and model behavior, and integrate operational governance to ensure longterm reliability, compliance, and performance.
5+
Solution architects must implement ALM processes that standardize agent creation, maintain configuration discipline, control data and model behavior, and integrate operational governance to ensure long-term reliability, compliance, and performance.
66

77
## ALM foundations for Microsoft Foundry agents
88

@@ -26,7 +26,7 @@ The Foundry control plane enables centralized oversight of agent definitions, se
2626

2727
## Environment strategy
2828

29-
A multienvironment model is essential for isolating agent development from production workloads.
29+
A multi-environment model is essential for isolating agent development from production workloads.
3030

3131
### Recommended environment tiers
3232

@@ -40,7 +40,7 @@ A multienvironment model is essential for isolating agent development from produ
4040

4141
Microsoft Foundry agents consist of modular components that must be governed and versioned.
4242

43-
* **Key ALMmanaged components**
43+
* **Key ALM-managed components**
4444

4545
* **Agent logic and orchestration**
4646

@@ -102,7 +102,7 @@ Foundry agents rely on data retrieved from controlled environments. ALM must enf
102102

103103
* **Usage of approved data sources**
104104

105-
* **Rolebased access controls (RBAC)**
105+
* **Role-based access controls (RBAC)**
106106

107107
* **Separation of production secrets from development artifacts**
108108

@@ -130,7 +130,7 @@ A centralized governance strategy ensures consistency and reduces operational ri
130130

131131
* Release calendars and change freezes
132132

133-
* Productionready validation templates
133+
* Production-ready validation templates
134134

135135
## Monitoring, feedback, and continuous improvement
136136

learn-pr/wwl/design-alm-process-ai-powered-business-solutions/includes/5-design-alm-process-custom-ai-models.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
## Overview
22

3-
This unit provides solution architects with a structured, enterprisegrade Application Lifecycle Management (ALM) process for custom AI models. It outlines how to manage model creation, evaluation, deployment, governance, and retirement across environments. The goal is to ensure that custom AI models remain reliable, compliant, traceable, and adaptable to changes in business data, requirements, and AI technologies.
3+
This unit provides solution architects with a structured, enterprise-grade Application Lifecycle Management (ALM) process for custom AI models. It outlines how to manage model creation, evaluation, deployment, governance, and retirement across environments. The goal is to ensure that custom AI models remain reliable, compliant, traceable, and adaptable to changes in business data, requirements, and AI technologies.
44

5-
Custom AI models introduce unique ALM challenges such as data drift, model drift, regulatory alignment, and highimpact deployment risks. This unit provides architects with an actionable framework for governing model evolution from ideation through retirement.
5+
Custom AI models introduce unique ALM challenges such as data drift, model drift, regulatory alignment, and high-impact deployment risks. This unit provides architects with an actionable framework for governing model evolution from ideation through retirement.
66

77
## 1. ALM Foundations for Custom AI Models
88

99
### A strong ALM process ensures:
1010

1111
**Consistency**: Every model follows documented development, testing, validation, and deployment steps.
1212

13-
**Compliance**: Sensitive data, PII, and industryspecific requirements are protected and governed across model iterations.
13+
**Compliance**: Sensitive data, PII, and industry-specific requirements are protected and governed across model iterations.
1414

1515
**Repeatability**: Models can be retrained and redeployed predictably, with clear version histories and evaluation criteria.
1616

1717
**Operational Readiness**: Runtime monitoring, governance logs, and rollback plans ensure business resilience.
1818

1919
## 2. Environment Strategy for Model Development
2020

21-
Establishing a multienvironment design prevents configuration drift and ensures safe promotions.
21+
Establishing a multi-environment design prevents configuration drift and ensures safe promotions.
2222

2323
### Recommended Environments
2424

@@ -154,11 +154,11 @@ Transparent audit trails for every deployment.
154154

155155
### Effective monitoring requires:
156156

157-
**Realtime KPIs**: accuracy, latency, cost, throughput, task success.
157+
**Real-time KPIs**: accuracy, latency, cost, throughput, task success.
158158

159159
**Drift detection**: changes in input data distribution or output quality.
160160

161-
**Safety monitoring**: inappropriate or policyviolating outputs.
161+
**Safety monitoring**: inappropriate or policy-violating outputs.
162162

163163
**User behavior analysis**: reduction in reprompts, consistent satisfaction trends.
164164

learn-pr/wwl/design-alm-process-ai-powered-business-solutions/includes/6-design-alm-process-ai-dynamics-365-apps-finance-supply-chain.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## Overview
22

3-
This unit teaches solution architects how to design a complete Application Lifecycle Management (ALM) process for AI components used in Microsoft Dynamics 365 Finance and Dynamics 365 Supply Chain Management.<br>AI capabilities in these applications—such as predictions, anomaly detection, document understanding, knowledge retrieval, and Copilotdriven assistance—require controlled ALM practices to ensure data quality, compliance, security, and operational reliability.
3+
This unit teaches solution architects how to design a complete Application Lifecycle Management (ALM) process for AI components used in Microsoft Dynamics 365 Finance and Dynamics 365 Supply Chain Management.<br>AI capabilities in these applications—such as predictions, anomaly detection, document understanding, knowledge retrieval, and Copilot-driven assistance—require controlled ALM practices to ensure data quality, compliance, security, and operational reliability.
44

55
### A robust ALM process helps teams
66

@@ -14,7 +14,7 @@ This unit teaches solution architects how to design a complete Application Lifec
1414

1515
## ALM Foundations for AI in Dynamics 365 Finance and Supply Chain
1616

17-
AI features in these workloads operate across ERP data, process automation, and modeldriven decision logic. Designing ALM requires a layered approach combining:
17+
AI features in these workloads operate across ERP data, process automation, and model-driven decision logic. Designing ALM requires a layered approach combining:
1818

1919
### AI Assets to Govern
2020

@@ -40,7 +40,7 @@ AI features in these workloads operate across ERP data, process automation, and
4040

4141
* Maintain **repeatable deployment patterns** through managed solutions or deployment pipelines.
4242

43-
* Support **endtoend traceability** across model development, tuning, deployment, and retirement.
43+
* Support **end-to-end traceability** across model development, tuning, deployment, and retirement.
4444

4545
## Environment Strategy
4646

@@ -49,7 +49,7 @@ AI features in these workloads operate across ERP data, process automation, and
4949
| **Environment** | **Purpose** |
5050
|---|---|
5151
| **DEV** | Build and iterate AI models, prompts, orchestration logic, and integrations. |
52-
| **TEST** | Validate with safe, anonymized productionlike data. Perform regression checks. |
52+
| **TEST** | Validate with safe, anonymized production-like data. Perform regression checks. |
5353
| **PROD** | Execute approved AI capabilities in live financial and supply chain workloads. |
5454

5555
### Key Requirements
@@ -106,7 +106,7 @@ Define:
106106

107107
* Align terminology with Finance and Supply Chain metadata (e.g., vendor, ledger, work order, production order).
108108

109-
* Validate prompt behavior through scenariobased testing.
109+
* Validate prompt behavior through scenario-based testing.
110110

111111
## ALM Promotion Gates
112112

@@ -176,7 +176,7 @@ Criteria:
176176

177177
* DLP rules for AI actions
178178

179-
* Guardrails for businesscritical processes (e.g., posting journals, approving purchase orders)
179+
* Guardrails for business-critical processes (e.g., posting journals, approving purchase orders)
180180

181181
### Continuous Improvement Loop
182182

learn-pr/wwl/design-alm-process-ai-powered-business-solutions/includes/7-design-alm-process-ai-dynamics-365-apps-customer-experience-service.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,11 @@ AI capabilities embedded in Dynamics 365 Customer Service and Customer Engagemen
1818

1919
* Provide safe deployment paths with rollback capability
2020

21-
* Support multiapp orchestration (Customer Service, Sales Insights, Customer Insights, Field Service)
21+
* Support multi-app orchestration (Customer Service, Sales Insights, Customer Insights, Field Service)
2222

2323
* Ensure compliance, responsible AI behavior, and auditability
2424

25-
* Enable continuous improvement with telemetry driven tuning
25+
* Enable continuous improvement with telemetry-driven tuning
2626

2727
### AI assets to include in ALM
2828

@@ -72,7 +72,7 @@ AI capabilities embedded in Dynamics 365 Customer Service and Customer Engagemen
7272

7373
### Step 3—Develop and Configure AI Logic
7474

75-
* Build prompts for summarization, classification, reply suggestions, or next best actions.
75+
* Build prompts for summarization, classification, reply suggestions, or next-best actions.
7676

7777
* Configure Copilot behaviors, action rules, context definitions, and conversation boosters.
7878

@@ -82,15 +82,15 @@ AI capabilities embedded in Dynamics 365 Customer Service and Customer Engagemen
8282

8383
* Manage agents, prompts, flows, and data contracts inside solution files.
8484

85-
* Use version controlled repositories to track changes.
85+
* Use version-controlled repositories to track changes.
8686

8787
* Mark releases with semantic versioning (e.g., v1.3.2).
8888

8989
### Step 5—Validate Behavior Across Environments
9090

9191
* Evaluate completeness, factual accuracy, tone, and compliance.
9292

93-
* Run multiturn conversation scenarios to detect logic flaws.
93+
* Run multi-turn conversation scenarios to detect logic flaws.
9494

9595
* Test with real case data (anonymized).
9696

@@ -104,7 +104,7 @@ AI capabilities embedded in Dynamics 365 Customer Service and Customer Engagemen
104104

105105
* Deploy to PROD using approved release pipelines (Azure DevOps or GitHub Actions).
106106

107-
* Validate initial postdeployment performance.
107+
* Validate initial post-deployment performance.
108108

109109
### Step 7—Monitor, Tune, and Iterate
110110

@@ -130,7 +130,7 @@ AI capabilities embedded in Dynamics 365 Customer Service and Customer Engagemen
130130

131131
* Ensure prompts can't trigger disclosure of sensitive customer information.
132132

133-
* Enforce least privilege data access for AI features.
133+
* Enforce least-privilege data access for AI features.
134134

135135
* Apply data loss prevention (DLP) policies and sensitivity labels across environments.
136136

0 commit comments

Comments
 (0)