Merge pull request #53917 from GraemeMalcolm/main

new gen-ai tools module

Author: Carolyn135

learn-pr/paths/develop-generative-ai-apps/index.yml

@@ -3,7 +3,7 @@ uid: learn.wwl.develop-generative-ai-apps
 metadata:
   title: Develop generative AI apps on Microsoft Foundry
   description: Learn how to develop generative AI apps in Microsoft Foundry. (AI-3016)
-  ms.date: 02/17/2026
+  ms.date: 03/19/2026
   author: ivorb
   ms.author: berryivor
   ms.topic: learning-path
@@ -16,22 +16,22 @@ summary: |
   Generative artificial intelligence (AI) is becoming more accessible through comprehensive development platforms like Microsoft Foundry. Learn how to build generative AI applications that use language models to interact with your users.
 iconUrl: /training/achievements/generic-badge.svg
 levels:
-- intermediate
+  - intermediate
 roles:
-- data-scientist
-- ai-engineer
+  - data-scientist
+  - ai-engineer
 products:
-- foundry-tools
-- microsoft-foundry
-- azure-ai-foundry-sdk
+  - foundry-tools
+  - microsoft-foundry
+  - azure-ai-foundry-sdk
 subjects:
-- artificial-intelligence
+  - artificial-intelligence
 modules:
-- learn.wwl.prepare-azure-ai-development
-- learn.wwl.model-catalog-evaluate
-- learn.wwl.foundry-sdk
-- learn.wwl.optimize-generative-ai-model-performance
-- learn.wwl.responsible-ai-studio
+  - learn.wwl.prepare-azure-ai-development
+  - learn.wwl.model-catalog-evaluate
+  - learn.wwl.foundry-sdk
+  - learn.wwl.generative-ai-tools
+  - learn.wwl.optimize-generative-ai-model-performance
+  - learn.wwl.responsible-ai-studio
 trophy:
   uid: learn.wwl.develop-generative-ai-apps.trophy
-

learn-pr/wwl-data-ai/use-generative-ai-tools/01-introduction.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: Introduction to generative AI tools.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 1
+content: |
+  [!include[](includes/01-introduction.md)]

learn-pr/wwl-data-ai/use-generative-ai-tools/02-what-are-tools.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.tools
+title: What are tools?
+metadata:
+  title: What are tools?
+  description: Get started with generative AI tools.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/02-what-are-tools.md)]

learn-pr/wwl-data-ai/use-generative-ai-tools/03-code-interpreter.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.code-interpreter
+title: Use the code_interpreter tool
+metadata:
+  title: Use the code_interpreter tool
+  description: Use the code_interpreter tool to run code and analyze data.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/03-code-interpreter.md)]

learn-pr/wwl-data-ai/use-generative-ai-tools/04-web-search.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.web-search
+title: Use the web_search tool
+metadata:
+  title: Use the web_search tool
+  description: Use the web_search tool to retrieve real-time information from the internet.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/04-web-search.md)]

learn-pr/wwl-data-ai/use-generative-ai-tools/05-file-search.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.file-search
+title: Use the file_search tool
+metadata:
+  title: Use the file_search tool
+  description: Use the file_search tool to search for files within your project.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/05-file-search.md)]

learn-pr/wwl-data-ai/use-generative-ai-tools/06-function.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.functions
+title: Use the functions tool
+metadata:
+  title: Use the functions tool
+  description: Use the functions tool to interact with web-based functions.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 5
+content: |
+  [!include[](includes/06-function.md)]

learn-pr/wwl-data-ai/use-generative-ai-tools/07-exercise.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.exercise
+title: Exercise - Create a generative AI chat app that uses tools
+metadata:
+  title: Exercise - Create a generative AI chat app that uses tools
+  description: Use the file_search tool to create a chat app that uses your data.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 30
+content: |
+  [!include[](includes/07-exercise.md)]

learn-pr/wwl-data-ai/use-generative-ai-tools/08-knowledge-check.yml

@@ -0,0 +1,49 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.knowledge-check
+title: Module assessment
+metadata:
+  title: Module assessment
+  description: Check your knowledge.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+  module_assessment: true
+durationInMinutes: 3
+quiz:
+  questions:
+    - content: "Which tool should you use when a model needs to answer questions from your own uploaded policy documents?"
+      choices:
+        - content: "web_search"
+          isCorrect: false
+          explanation: "Incorrect. The web search tool retrieves public web content, not your private indexed files."
+        - content: "file_search"
+          isCorrect: true
+          explanation: "Correct. The file_search tool retrieves relevant passages from files in your vector store."
+        - content: "code_interpreter"
+          isCorrect: false
+          explanation: "Incorrect. The code_interpreter tool runs Python code; it isn't a document retrieval tool."
+    - content: "In a function-calling workflow, what should your application do after the model returns a function_call item?"
+      choices:
+        - content: "Wait for the model to run the function automatically"
+          isCorrect: false
+          explanation: "Incorrect. The model requests the function call, but your application must run it."
+        - content: "run the function in your code and send a function_call_output back to the model"
+          isCorrect: true
+          explanation: "Correct. Your app runs the function and then returns the output so the model can complete the response."
+        - content: "Convert the function call into a web_search request"
+          isCorrect: false
+          explanation: "Incorrect. Function calls should be handled by executing the requested function, not by switching tools."
+    - content: "Which statement about the code_interpreter tool is correct?"
+      choices:
+        - content: "It can run Python code in a sandboxed runtime to help solve tasks"
+          isCorrect: true
+          explanation: "Correct. code_interpreter provides a Python runtime the model can use to run code and return results."
+        - content: "It can browse external websites directly during code execution"
+          isCorrect: false
+          explanation: "Incorrect. The module notes code_interpreter runs in a sandboxed environment without external network access."
+        - content: "It only supports file uploads and can't perform calculations"
+          isCorrect: false
+          explanation: "Incorrect. code_interpreter supports calculations, analysis, and other Python-based processing."

learn-pr/wwl-data-ai/use-generative-ai-tools/09-summary.yml

@@ -0,0 +1,15 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.generative-ai-tools.summary
+title: Summary
+metadata:
+  title: Summary
+  description: Reflect on what you've learned about generative AI tools.
+  author: graememalcolm
+  ms.author: gmalc
+  ms.date: 03/19/2026
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+durationInMinutes: 1
+content: |
+  [!include[](includes/09-summary.md)]