Merge pull request #50628 from ivorb/build-agent-refresh

Stacyrch140 · web-flow · commit a748da66c2ed · 2025-05-23T17:36:42.000-04:00
Build agent refresh
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/1-introduction.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/1-introduction.yml
@@ -6,7 +6,7 @@ metadata:
   description: Get ready to explore AI agents.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
   ms.collection:
     - wwl-ai-copilot
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/2-what-are-agents.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/2-what-are-agents.yml
@@ -6,7 +6,7 @@ metadata:
   description: AI agents have the potential to radically change how we accomplish tasks - but what are they?
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
   ms.collection:
     - wwl-ai-copilot
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/3-agent-development.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/3-agent-development.yml
@@ -6,7 +6,7 @@ metadata:
   description: So you want to build an agent? Let's explore your options?
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
   ms.collection:
     - wwl-ai-copilot
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/4-azure-ai-agent-service.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/4-azure-ai-agent-service.yml
@@ -6,7 +6,7 @@ metadata:
   description: A high-level overview of Azure AI Foundry Agent Service.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
   ms.collection:
     - wwl-ai-copilot
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/5-exercise.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/5-exercise.yml
@@ -6,7 +6,7 @@ metadata:
   description: Create an agent by using Azure AI Foundry Agent Service in the Azure AI Foundry portal.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
   ms.collection:
     - wwl-ai-copilot
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/6-knowledge-check.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/6-knowledge-check.yml
@@ -6,7 +6,7 @@ metadata:
   description: Test your knowledge of AI agents.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
   ms.collection:
     - wwl-ai-copilot
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/7-summary.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/7-summary.yml
@@ -6,7 +6,7 @@ metadata:
   description: Summary of key learning points and further reading for AI agents.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
   ms.collection:
     - wwl-ai-copilot
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/includes/3-agent-development.md b/learn-pr/wwl-data-ai/ai-agent-fundamentals/includes/3-agent-development.md
@@ -1,8 +1,5 @@
 There are many ways that developers can create AI agents, including multiple frameworks and SDKs.
 
-> [!NOTE]
-> Many of the services discussed in this module are in preview. Details are subject to change.
-
 ## Azure AI Foundry Agent Service
 
 Azure AI Foundry Agent Service is a managed service in Azure that is designed to provide a framework for creating, managing, and using AI agents within Azure AI Foundry. The service is based on the OpenAI Assistants API but with increased choice of models, data integration, and enterprise security; enabling you to use both the OpenAI SDK and the Azure Foundry SDK to develop agentic solutions.
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/index.yml b/learn-pr/wwl-data-ai/ai-agent-fundamentals/index.yml
@@ -5,7 +5,7 @@ metadata:
   description: AI agents represent the next generation of intelligent applications. Learn how they can be developed and used on Microsoft Azure.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.service: azure-ai-services
   ms.topic: module-standard-task-based
   ms.collection:
diff --git a/learn-pr/wwl-data-ai/ai-agent-fundamentals/media/agents-playground.png b/learn-pr/wwl-data-ai/ai-agent-fundamentals/media/agents-playground.png
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/1-introduction.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/1-introduction.yml
@@ -4,7 +4,7 @@ title: Introduction
 metadata:
   title: Introduction
   description: "Introduction to building an agent with custom tools."
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: unit
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/2-why-use-custom-tools.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/2-why-use-custom-tools.yml
@@ -4,7 +4,7 @@ title: Why use custom tools
 metadata:
   title: Why use custom tools
   description: "Understand the benefits of using custom tools with your agent."
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: unit
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/3-custom-tool-options.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/3-custom-tool-options.yml
@@ -4,7 +4,7 @@ title: Options for implementing custom tools
 metadata:
   title: Options for implementing custom tools
   description: "Explore the options for implementing custom tools in your agent."
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: unit
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/4-how-use-custom-tools.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/4-how-use-custom-tools.yml
@@ -4,7 +4,7 @@ title: How to integrate custom tools
 metadata:
   title: How to integrate custom tools
   description: "Learn how to integrate custom tools into your agent. This unit covers function calling, Azure Function integration, and OpenAPI specification integration."
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: unit
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/5-exercise.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/5-exercise.yml
@@ -4,7 +4,7 @@ title: Exercise - Build an agent with custom tools
 metadata:
   title: Exercise - Build an agent with custom tools
   description: "Get interactive experience with building an agent with custom tools."
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: unit
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/6-knowledge-check.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/6-knowledge-check.yml
@@ -4,7 +4,7 @@ title: Module assessment
 metadata:
   title: Module assessment
   description: "Check your knowledge of building an agent with custom tools."
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: unit
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/7-summary.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/7-summary.yml
@@ -4,7 +4,7 @@ title: Summary
 metadata:
   title: Summary
   description: "Review the key points of using custom tools with your agent."
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: unit
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/includes/3-custom-tool-options.md b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/includes/3-custom-tool-options.md
@@ -4,8 +4,9 @@ Azure AI Foundry Agent Service offers various custom tools that enhance the capa
 
 Azure AI services provide several custom tool options, including OpenAPI specified tools, Azure Functions, and function calling. These tools enable seamless integration with external APIs, event-driven applications, and custom functions.
 
-- **Function calling**: Function calling allows you to describe the structure of custom functions to an agent and return the functions that need to be called along with their arguments. The agent can dynamically identify appropriate functions based on their definitions. This feature is useful for integrating custom logic and workflows, in a selection of programming languages, into your AI agents.
+- **Custom function**: Function calling allows you to describe the structure of custom functions to an agent and return the functions that need to be called along with their arguments. The agent can dynamically identify appropriate functions based on their definitions. This feature is useful for integrating custom logic and workflows, in a selection of programming languages, into your AI agents.
 - **Azure Functions**: Azure Functions enable you to create intelligent, event-driven applications with minimal overhead. They support triggers and bindings, which simplify how your AI Agents interact with external systems and services. Triggers determine when a function executes, while bindings facilitate streamlined connections to input or output data sources.
 - **OpenAPI specification tools**: These tools allow you to connect your Azure AI Agent to an external API using an OpenAPI 3.0 specification. This provides standardized, automated, and scalable API integrations that enhance the capabilities of your agent. OpenAPI specifications describe HTTP APIs, enabling people to understand how an API works, generate client code, create tests, and apply design standards.
+- **Azure Logic Apps**: This action provides low-code/no-code solutions to add workflows and connects apps, data, and services with the low-code Logic App.
 
 This flexibility to integrate custom functionality in multiple ways enables a wide range of extensibility possibilities for your Foundry Agent Service agents.
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/includes/4-how-use-custom-tools.md b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/includes/4-how-use-custom-tools.md
@@ -33,14 +33,14 @@ Register the function with your agent using the Azure AI SDK:
 functions = FunctionTool(user_functions)
 toolset = ToolSet()
 toolset.add(functions)
-project_client.agents.enable_auto_function_calls(toolset=toolset)
+agent_client.enable_auto_function_calls(toolset=toolset)
 
 # Create your agent with the toolset
-agent = project_client.agents.create_agent(
+agent = agent_client.create_agent(
     model="gpt-4o-mini",
     name="snowfall-agent",
     instructions="You are a weather assistant tracking snowfall. Use the provided functions to answer questions.",
-    toolset={"functions": [recent_snowfall]}
+    toolset=toolset
 )
 ```
 
@@ -79,7 +79,7 @@ When your Azure Function is in place, integrate add it to the agent definition a
       ),
   )
   
-  agent = project_client.agents.create_agent(
+  agent = agent_client.create_agent(
       model=os.environ["MODEL_DEPLOYMENT_NAME"],
       name="azure-function-agent",
       instructions="You are a snowfall tracking agent. Use the provided Azure Function to fetch snowfall based on location.",
@@ -146,15 +146,15 @@ First, create a JSON file ( in this example, called *snowfall_openapi.json*) des
 Then, register the OpenAPI tool in the agent defintion:
 
   ```python
-  from azure.ai.projects.models import OpenApiTool, OpenApiAnonymousAuthDetails
+  from azure.ai.agents.models import OpenApiTool, OpenApiAnonymousAuthDetails
   
   with open("snowfall_openapi.json", "r") as f:
       openapi_spec = json.load(f)
   
   auth = OpenApiAnonymousAuthDetails()
   openapi_tool = OpenApiTool(name="snowfall_api", spec=openapi_spec, auth=auth)
   
-  agent = project_client.agents.create_agent(
+  agent = agent_client.create_agent(
       model="gpt-4o-mini",
       name="openapi-agent",
       instructions="You are a snowfall tracking assistant. Use the API to fetch snowfall data.",
diff --git a/learn-pr/wwl-data-ai/build-agent-with-custom-tools/index.yml b/learn-pr/wwl-data-ai/build-agent-with-custom-tools/index.yml
@@ -3,7 +3,7 @@ uid: learn.wwl.build-agent-with-custom-tools
 metadata:
   title: Integrate custom tools into your agent
   description: Learn how to build an agent with custom tools using the Azure AI Foundry Agent Service.
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   author: ivorb
   ms.author: berryivor
   ms.topic: module-standard-task-based 
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/1-introduction.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/1-introduction.yml
@@ -6,7 +6,7 @@ metadata:
   description: Learn how to start using Azure AI Foundry Agent Service.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
 durationInMinutes: 2
 content: |
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/2-what-is-ai-agent.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/2-what-is-ai-agent.yml
@@ -6,7 +6,7 @@ metadata:
   description: This unit explains what an AI agent is and how it works.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
 durationInMinutes: 6
 content: |
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/3-how-use-agent-service.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/3-how-use-agent-service.yml
@@ -6,7 +6,7 @@ metadata:
   description: This unit explores how to use Azure AI Foundry Agent Service. 
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
 durationInMinutes: 7
 content: |
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/4-when-use-agent-service.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/4-when-use-agent-service.yml
@@ -6,7 +6,7 @@ metadata:
   description: This unit explains how to use Azure AI Foundry Agent Service to develop agents.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
 durationInMinutes: 5
 content: |
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/5-exercise.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/5-exercise.yml
@@ -6,7 +6,7 @@ metadata:
   description: Learn how to build an agent using Azure AI Foundry Agent Service. This unit provides a hands-on exercise to build an agent using Azure AI Foundry Agent Service.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
 durationInMinutes: 30
 content: |
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/6-knowledge-check.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/6-knowledge-check.yml
@@ -6,7 +6,7 @@ metadata:
   description: This unit contains a knowledge check, which can help learners reinforce their understanding of the material.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
 durationInMinutes: 3
 content: |
@@ -17,9 +17,9 @@ quiz:
       - content: "Deploy a compatible model"  
         isCorrect: false  
         explanation: "Incorrect. Deploying a compatible model is the second step. The first step is to create an Azure AI Foundry hub and project."  
-      - content: "Create an Azure AI Foundry hub and project"  
+      - content: "Create an Azure AI Foundry project"  
         isCorrect: true  
-        explanation: "Correct. The first step in setting up Azure AI Foundry Agent Service is to create an Azure AI Foundry hub and project in your Azure subscription."  
+        explanation: "Correct. The first step in setting up Azure AI Foundry Agent Service is to create an Azure AI Foundry project in your Azure subscription."  
       - content: "Make API calls using SDKs"  
         isCorrect: false  
         explanation: "Incorrect. Making API calls using SDKs is the third step after deploying a compatible model."  
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/7-summary.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/7-summary.yml
@@ -6,7 +6,7 @@ metadata:
   description: This unit summarizes the key concepts covered in the module, including key features and how to use Azure AI Foundry Agent Service.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.topic: unit
 durationInMinutes: 2
 content: |
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/includes/4-when-use-agent-service.md b/learn-pr/wwl-data-ai/develop-ai-agent-azure/includes/4-when-use-agent-service.md
@@ -13,7 +13,7 @@ Foundry Agent Service provides several SDKs and a REST API for you to integrate
 
 The diagram shows the following high-level steps that you must implement in your code:
 
-1. Connect to the *AI Foundry project* for your agent, using the project connection string and Entra ID authentication.
+1. Connect to the *AI Foundry project* for your agent, using the project endpoint and Entra ID authentication.
 2. Get a reference to an existing agent that you created in the Azure AI Foundry portal, or create a new one specifying:
     - The *model deployment* in the project that the agent should use to interpret and respond to prompts.
     - *Instructions* that determine the functionality and behavior of the agent.
@@ -56,10 +56,8 @@ Knowledge tools enhance the context or knowledge of your agent. Available tools
 Action tools perform an action or run a function. Available tools include:
 
 - **Code Interpreter**: A sandbox for model-generated Python code that can access and process uploaded files.
-- **Function**: Call your custom function code – you must provide function definitions and implementations.
+- **Custom function**: Call your custom function code – you must provide function definitions and implementations.
 - **Azure Function**: Call code in serverless Azure Functions.
 - **OpenAPI Spec**: Call external APIs based on the OpenAPI 3.0 spec.
 
 By connecting built-in and custom tools, you can allow your agent to perform countless tasks on your behalf.
-
-
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/index.yml b/learn-pr/wwl-data-ai/develop-ai-agent-azure/index.yml
@@ -5,7 +5,7 @@ metadata:
   description: Learn how to start using Azure AI Foundry Agent Service.
   author: ivorb
   ms.author: berryivor
-  ms.date: 05/16/2025
+  ms.date: 05/23/2025
   ms.service: azure-ai-openai
   ms.topic: module-standard-task-based
 title: Develop an AI agent with Azure AI Foundry Agent Service
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/ai-agent-code-pattern.png b/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/ai-agent-code-pattern.png
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/basic-agent-setup-resources.png b/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/basic-agent-setup-resources.png
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/portal-tools.png b/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/portal-tools.png
diff --git a/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/standard-agent-setup-resources.png b/learn-pr/wwl-data-ai/develop-ai-agent-azure/media/standard-agent-setup-resources.png
