pull base content,head:wwlpublishsync,into:204cce7b31ec95f51eefa781b050b2054145f995fd40ddece39ce713435d4c6d-live

Author: wwlpublish

learn-pr/azure/build-enterprise-ai-agents-with-java-spring/includes/7-exercise-agent-ai-development.md

@@ -10,6 +10,7 @@ For this exercise, you need some environment variables from prior exercises. If
 
 ```azurecli
 export RESOURCE_GROUP=<resource-group>
+export DB_SERVER_NAME=<server-name>
 export OPENAI_RESOURCE_NAME=OpenAISpringAI
 export AZURE_OPENAI_ENDPOINT=$(az cognitiveservices account show \
     --resource-group $RESOURCE_GROUP \
@@ -23,6 +24,12 @@ export AZURE_OPENAI_API_KEY=$(az cognitiveservices account keys list \
     --query "key1" \
     --output tsv \
     | tr -d '\r')
+export PGHOST=$(az postgres flexible-server show \
+    --resource-group $RESOURCE_GROUP \
+    --name $DB_SERVER_NAME \
+    --query fullyQualifiedDomainName \
+    --output tsv \
+    | tr -d '\r')
 ```
 
 ### Create the BlogWriterService
@@ -83,138 +90,6 @@ public class BlogWriterService {
      * 4. Refine the draft based on feedback
      * 5. Repeat until approved or max iterations reached
      * 
-     * @param topic The blog post topic
-     * @return A refined blog post with a maximum of 10 sentences
-     */
-    public String generateBlogPost(String topic) {
-        logger.info("Starting blog generation for topic: {}", topic);
-
-        // PHASE 1: WRITER AGENT
-        // Prompt the Writer agent to generate the initial blog draft
-        String initialPrompt = String.format("""
-            You are a professional blog writer. Write a well-structured, engaging blog post about "%s".
-            The post should have a clear introduction, body paragraphs, and conclusion.
-            Include relevant examples and maintain a conversational yet professional tone.
-            
-            IMPORTANT FORMATTING REQUIREMENTS:
-            1. Format as plain text only (no Markdown, HTML, or special formatting)
-            2. Use simple ASCII characters only
-            3. For the title, simply put it on the first line and use ALL CAPS instead of "#" symbols
-            4. Separate paragraphs with blank lines
-            5. The blog post must be concise and contain NO MORE THAN 10 SENTENCES total.
-            """, topic);
-        
-        // Using Spring AI's fluent API to send the prompt and get the response
-        logger.info("Sending initial draft generation prompt to AI model");
-        String draft = chatClient.prompt()
-                .user(initialPrompt)  // Creates a UserMessage with the prompt
-                .call()               // Executes the AI call
-                .content();           // Extracts the content from the response
-        logger.info("Initial draft successfully generated for topic: {}", topic);
-
-        // PHASE 2: EVALUATION & REFINEMENT LOOP
-        // Setup for the iterative improvement process
-        boolean approved = false;
-        int iteration = 1;
-        boolean forceFirstIteration = true; // Force at least one round of feedback to demonstrate the pattern
-        
-        // Continue until we reach max iterations or get approval (but always do at least one iteration)
-        while ((!approved && iteration <= MAX_ITERATIONS) || forceFirstIteration) {
-            logger.info("Starting iteration {} of blog refinement", iteration);
-            
-            // PHASE 2A: EDITOR AGENT
-            // Prompt the Editor agent to evaluate the current draft
-            String evalPrompt = String.format("""
-                You are a critical blog editor with extremely high standards. Evaluate the following blog draft and respond with either:
-                PASS - if the draft is exceptional, well-written, engaging, and complete
-                NEEDS_IMPROVEMENT - followed by specific, actionable feedback on what to improve
-                
-                Focus on:
-                - Clarity and flow of ideas
-                - Engagement and reader interest
-                - Professional yet conversational tone
-                - Structure and organization
-                - Strict adherence to the 10-sentence maximum length requirement
-                
-                IMPORTANT EVALUATION RULES:
-                1. The blog MUST have no more than 10 sentences total. Count the sentences carefully.
-                2. For the first iteration, ALWAYS respond with NEEDS_IMPROVEMENT regardless of quality.
-                3. Be extremely thorough in your evaluation and provide detailed feedback.
-                4. If the draft exceeds 10 sentences, it must receive a NEEDS_IMPROVEMENT rating.
-                5. Even well-written drafts should receive suggestions for improvement in early iterations.
-                
-                Draft:
-                %s
-                """, draft);
-            
-            // Send the evaluation prompt to the AI model
-            logger.info("Sending draft for editorial evaluation (iteration: {})", iteration);
-            String evaluation = chatClient.prompt()
-                    .user(evalPrompt)
-                    .call()
-                    .content();
-            
-            // After first iteration, remove the force flag
-            if (forceFirstIteration) {
-                forceFirstIteration = false;
-            }
-            
-            // Check if the Editor agent approves the draft
-            if (evaluation.toUpperCase().contains("PASS") && iteration > 1) { // Only allow PASS after first iteration
-                // Draft is approved, exit the loop
-                approved = true;
-                logger.info("Draft approved by editor on iteration {}", iteration);
-            } else {
-                // Draft needs improvement, extract the specific feedback
-                String feedback = extractFeedback(evaluation);
-                logger.info("Editor feedback received (iteration {}): {}", iteration, feedback);
-                
-                // PHASE 2B: WRITER AGENT (REFINEMENT)
-                // Prompt the Writer agent to refine the draft based on the feedback
-                String refinePrompt = String.format("""
-                    You are a blog writer. Improve the following blog draft based on this editorial feedback:
-                    
-                    Feedback: %s
-                    
-                    Current Draft:
-                    %s
-                    
-                    IMPORTANT REQUIREMENTS:
-                    1. The final blog post MUST NOT exceed 10 sentences total.
-                    2. Maintain a clear introduction, body, and conclusion structure.
-                    3. Keep formatting as plain text only (NO Markdown, HTML, or special formatting)
-                    4. For the title, use ALL CAPS instead of any special formatting
-                    5. Separate paragraphs with blank lines
-                    6. Use only simple ASCII characters
-                    7. Provide the complete improved version while addressing the feedback.
-                    8. Count your sentences carefully before submitting.
-                    """, feedback, draft);
-                
-                // Send the refinement prompt to the AI model
-                logger.info("Requesting draft revision based on feedback (iteration: {})", iteration);
-                draft = chatClient.prompt()
-                        .user(refinePrompt)
-                        .call()
-                        .content();
-                logger.info("Revised draft received for iteration {}", iteration);
-            }
-            iteration++;
-        }
-
-        // PHASE 3: FINALIZATION
-        // Return the final draft, either approved or after reaching max iterations
-        if (!approved) {
-            logger.warn("Maximum iterations ({}) reached without editor approval", MAX_ITERATIONS);
-        } else {
-            logger.info("Blog post generation completed successfully for topic: {}", topic);
-        }
-
-        return draft;
-    }
-
-    /**
-     * Enhanced version of generateBlogPost that also returns metadata about the generation process.
-     * 
      * This method ensures at least one feedback-improvement cycle occurs to demonstrate
      * the full evaluator-optimizer pattern in action, regardless of initial draft quality.
      * 
@@ -499,13 +374,10 @@ public class BlogWriterService {
 
 This implementation includes the following key features:
 
-- Basic blog generation. The `generateBlogPost` method:
-  - Creates a well-structured blog post on a given topic.
+- Blog generation with metadata. The `generateBlogPostWithMetadata` method:
+  - Creates a well-structured blog post on a given topic with detailed metadata about the generation process.
   - Uses an iterative refinement process with Writer and Editor agents.
   - Enforces a 10-sentence maximum length.
-
-- Enhanced metadata generation. The `generateBlogPostWithMetadata` method:
-  - Extends the basic functionality to capture detailed metadata about the generation process.
   - Tracks iterations, approval status, token usage, and editor feedback history.
   - Returns all information in a structured `BlogGenerationResult` object.
 

learn-pr/wwl-azure/get-started-identity-access-labs/1-introduction.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: "Introduction."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/1-introduction.md)]

learn-pr/wwl-azure/get-started-identity-access-labs/2-create-user.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.create-user
+title: Perform basic User Management tasks
+metadata:
+  title: Perform basic User Management tasks
+  description: "Perform labs to learn about creating users and assigning them access rights."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 15
+content: |
+  [!include[](includes/2-create-user.md)]

learn-pr/wwl-azure/get-started-identity-access-labs/3-create-group.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.create-group
+title: Perform basic Group Management tasks
+metadata:
+  title: Perform basic Group Management tasks
+  description: "Perform labs to create groups, assign users, and grant access."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 15
+content: |
+  [!include[](includes/3-create-group.md)]

learn-pr/wwl-azure/get-started-identity-access-labs/4-configure-password-protect.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.configure-password-protection
+title: Perform basic Password Protection tasks
+metadata:
+  title: Perform basic Password Protection tasks
+  description: "Perform an interactive lab to configure and enable password protection features."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 5
+content: |
+  [!include[](includes/4-configure-password-protect.md)]

learn-pr/wwl-azure/get-started-identity-access-labs/5-configure-password-reset.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.configure-password-reset
+title: Perform basic Self-Service Password Reset (SSPR) tasks
+metadata:
+  title: Perform basic Self-Service Password Reset (SSPR) tasks
+  description: "Perform this interactive lab to enable and configure basics features of SSPR."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 5
+content: |
+  [!include[](includes/5-configure-password-reset.md)]

learn-pr/wwl-azure/get-started-identity-access-labs/6-add-multifactor-authentication.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.add-multifactor-authentication
+title: Perform basic Multifactor Authentication tasks
+metadata:
+  title: Perform basic Multifactor Authentication tasks
+  description: "Perform the lab to enable multifactor authentication to protect users and company data."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 10
+content: |
+  [!include[](includes/6-add-multifactor-authentication.md)]

learn-pr/wwl-azure/get-started-identity-access-labs/7-create-conditional-access-policy.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.create-conditional-access-policy
+title: Perform basic Conditional Access policy tasks
+metadata:
+  title: Perform basic Conditional Access policy tasks
+  description: "Perform the lab to explore creating and evaluating the impact of Conditional Access policies."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 10
+content: |
+  [!include[](includes/7-create-conditional-access-policy.md)]

learn-pr/wwl-azure/get-started-identity-access-labs/8-knowledge-check.yml

@@ -0,0 +1,60 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.knowledge-check
+title: Knowledge check
+metadata:
+  title: Knowledge check
+  description: "Check your knowledge."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 3
+content: |
+  [!include[](includes/8-knowledge-check.md)]
+quiz:
+  title: "Check your knowledge"
+  questions:
+  - content: "The goal is to create a new user in Microsoft Entra ID. What is the first step to take?"
+    choices:
+    - content: "Browse to Identity > Users > All users."
+      isCorrect: false
+      explanation: "Incorrect. This is the second step after signing in to the Microsoft Entra admin center."
+    - content: "Select New user > Create new user."
+      isCorrect: false
+      explanation: "Incorrect. This is the third step after browsing to the All users page."
+    - content: "Sign in to the Microsoft Entra admin center as at least a User Administrator."
+      isCorrect: true
+      explanation: "Correct. The first step is to sign in to the Microsoft Entra admin center with the appropriate role."
+  - content: "What is the first step to add a license to a user in Microsoft Entra ID?"
+    choices:
+    - content: "Sign in to the Microsoft 365 admin center as at least a License Administrator."
+      isCorrect: true
+      explanation: "Correct. The first step is to sign in to the Microsoft 365 admin center with the appropriate administrative role."
+    - content: "Navigate to Billing > Licenses."
+      isCorrect: false
+      explanation: "Incorrect. This is the second step. The first step is to sign in to the Microsoft 365 admin center."
+    - content: "Select the license to assign."
+      isCorrect: false
+      explanation: "Incorrect. This is the third step. The first step is to sign in to the Microsoft 365 admin center."
+  - content: "An identity and access administrator needs to invite an external user to collaborate on a project. What is the first step to take?"
+    choices:
+    - content: "Send an email invitation directly from the admin's email client."
+      isCorrect: false
+      explanation: "Incorrect. Invitations should be sent through the Microsoft Entra admin center to ensure proper tracking and management."
+    - content: "Sign in to the Microsoft Entra admin center as at least a User Administrator."
+      isCorrect: true
+      explanation: "Correct. The first step is to sign in to the Microsoft Entra admin center with the necessary permissions to invite external users."
+    - content: "Create a new user account for the external user."
+      isCorrect: false
+      explanation: "Incorrect. There is no need to create a new user account; instead, invite the external user to use their existing account."
+  - content: "An identity and access admin needs to assign a role to a user in Microsoft Entra. What is the first step to take?"
+    choices:
+    - content: "Sign in to the Microsoft Entra admin center."
+      isCorrect: true
+      explanation: "Correct. The first step in assigning a role in Microsoft Entra is to sign in to the Microsoft Entra admin center."
+    - content: "Navigate to the Azure portal."
+      isCorrect: false
+      explanation: "Incorrect. Role assignments in Microsoft Entra are managed through the Microsoft Entra admin center, not the Azure portal."
+    - content: "Create a new user account."
+      isCorrect: false
+      explanation: "Incorrect. Creating a new user account isn't the first step in assigning a role. Sign in to the Microsoft Entra admin center first."

learn-pr/wwl-azure/get-started-identity-access-labs/9-summary-resources.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.get-started-identity-access-labs.summary-resources
+title: Summary and resources
+metadata:
+  title: Summary and resources
+  description: "Summary and resources."
+  ms.date: 03/29/2025
+  author: wwlpublish
+  ms.author: roberts
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/9-summary-resources.md)]