clean up and added new images

01-intro-to-ai-agents/README.md

@@ -2,7 +2,7 @@
 
 Welcome to the "AI Agents for Beginners" course! This course gives you fundamental knowledge and applied samples for building with AI Agents.
 
-Join the Azure AI Discord Community to meet other learners, and AI Agent Builders and ask any questions you have on this course.
+Join the [Azure AI Discord Community](https://discord.gg/kzRShWzttr) to meet other learners, and AI Agent Builders and ask any questions you have on this course.
 
 To start this course, we begin by getting a better understanding of what AI Agents are and how we can use them in the applications and workflows we build.
 
@@ -15,7 +15,6 @@ This lesson covers:
 - What are some of the basic building blocks when designing Agentic Solutions?
 
 ## Learning Goals
-
 After completing this lesson, you should be able to:
 
 - Understand AI Agent concepts and how they differ from other AI solutions.
@@ -30,13 +29,12 @@ AI Agents are **systems** that enable **Large Language Models(LLMs)** to **perfo
 
 Let's break this definition into smaller parts:
 
-- **System** - It's important to think about agents not as just a single component but as a system of many components.
-
-At the basic level, the components of an AI Agent are:
+- **System** - It's important to think about agents not as just a single component but as a system of many components.At the basic level, the components of an AI Agent are:
+  - **Environment** - The defined space where the AI Agent is operating. For example, if we had a travel booking AI Agent, the environment could be the travel booking system that the AI Agent uses to complete tasks.
+  - **Sensors** - Environments have information and provide feedback. AI Agents use sensors to gather and interpret this information about the current state of the environment. In the Travel Booking Agent example, the travel booking system can provide information such as hotel availability or flight prices.
+  - **Actuators** - Once the AI Agent receives the current state of the environment, For the current task the agent determines what action to perform to change the environment. For the travel booking agent, it might be to book an available room for the user.
 
-    - **Environment** - The defined space where the AI Agent is operating. For example, if we had a travel booking AI Agent, the environment could be the travel booking system that the AI Agent uses to complete tasks.
-    - **Sensors** - Environments have information and provide feedback. AI Agents use sensors to gather and interpret this information about the current state of the environment. In the Travel Booking Agent example, the travel booking system can provide information such as hotel availability or flight prices.
-    - **Actuators** - Once the AI Agent receives the current state of the environment, For the current task the agent determines what action to perform to change the environment. For the travel booking agent, it might be to book an available room for the user.
+![What Are AI Agents?](./images/what-are-ai-agents.png?WT.mc_id=academic-105485-koreyst)
 
 **Large Language Models** - The concept of agents existed before the creation of LLMs. The advantage of building AI Agents with LLMs is their ability to interpret human language and data. This ability enables LLMs to interpret environmental information and define a plan to change the environment.
 
@@ -62,9 +60,12 @@ Now that we have a general definition of AI Agents, let us look at some specific
 
 ## When to Use AI Agents
 
-In the earlier section, we use the Travel Agent use-case to explain how the different type of agents can be used in different scenarios of travel booking.
+In the earlier section, we used the Travel Agent use-case to explain how the different type of agents can be used in different scenarios of travel booking. We will contiue to use this application througout the course.
+
+Let's look at they types of use cases that AI Agents are best used for:
+
+![When to use AI Agents?](./images/when-to-use-ai-agents.png?WT.mc_id=academic-105485-koreyst)
 
-Let's look at when to use AI Agents more generally:
 
 - **Open-Ended Problems** - allowing the LLM to determine needed steps to complete a task because it can't always be hardcoded into a workflow.
 - **Multi-Step Processes** - tasks that require a level of complexity in which the AI Agent needs to use tools or information over multiple turns instead of single shot retrieval.  

03-agentic-design-patterns/README.md

@@ -1,29 +1,38 @@
 # AI Agentic Design Principles
 
 ## Introduction
+
 There are many ways to think about building AI Agentic Systems. Given that ambiguity is a feature and not a bug in Generative AI design, it’s sometimes difficult for engineers to figure out where to even start. We have created a set of human-centric UX Design Principles to enable developers to build customer-centric agentic systems to solve their business needs. These design principles are not a prescriptive architecture but rather a starting point for teams who are defining and building out agent experiences.
 
 In general, agents should:
+
 - Broaden and scale human capacities (brainstorming, problem-solving, automation, etc.)
 - Fill in knowledge gaps (get me up-to-speed on knowledge domains, translation, etc.)
 - Facilitate and support collaboration in the ways we as individuals prefer to work with others
 - Make us better versions of ourselves (e.g., life coach/task master, helping us learn emotional regulation and mindfulness skills, building resilience, etc.)
 
 ## This Lesson Will Cover
+
 - What are the Agentic Design Principles
 - What are some guidelines to follow while implementing these design principles
 - What are some examples of using the design principles
 
 ## Learning Goals
+
 After completing this lesson, you will be able to:
+
 1. Explain what the Agentic Design Principles are
 2. Explain the guidelines to using the Agentic Design Principles
 3. Understand how to build an agent using the Agentic Design Principles
 
 ## The Agentic Design Principles
 
+![Agentic Design Principles](./images/agentic-design-principles.png?WT.mc_id=academic-105485-koreyst)
+
 ### Agent (Space)
+
 This is the environment in which the agent operates. These principles inform how we design agents for engaging in physical and digital worlds.
+
 - **Connecting, not collapsing** – help connect people to other people, events, and actionable knowledge to enable collaboration and connection.
 - Agents help connect events, knowledge, and people.
 - Agents bring people closer together. They are not designed to replace or belittle people.
@@ -34,7 +43,9 @@ This is the environment in which the agent operates. These principles inform how
   - Agent may operate in invisible form, yet its background process path and collaboration with other Agents is transparent to and controllable by the user.
 
 ### Agent (Time)
+
 This is how the agent operates over time. These principles inform how we design agents interacting across the past, present, and future.
+
 - **Past**: Reflecting on history that includes both state and context.
   - Agent provides more relevant results based on analysis of richer historical data beyond only the event, people, or states.
   - Agent creates connections from past events and actively reflects on memory to engage with current situations.
@@ -48,26 +59,32 @@ This is how the agent operates over time. These principles inform how we design
   - Agent is shaped by and evolves through continuous user interaction.
 
 ### Agent (Core)
+
 These are the key elements in the core of an agent’s design.
+
 - **Embrace uncertainty but establish trust**.
   - A certain level of Agent uncertainty is expected. Uncertainty is a key element of agent design.
   - Trust and transparency are foundational layers of Agent design.
   - Humans are in control of when the Agent is on/off and Agent status is clearly visible at all times.
 
 ## The Guidelines To Implement These Principles
+
 When you’re using the above design principles, use the following guidelines:
+
 1. **Transparency**: Inform the user that AI is involved, how it functions (including past actions), and how to give feedback and modify the system.
 2. **Control**: Enable the user to customize, specify preferences and personalize, and have control over the system and its attributes (including the ability to forget).
 3. **Consistency**: Aim for consistent, multi-modal experiences across devices and endpoints. Use familiar UI/UX elements where possible (e.g., microphone icon for voice interaction) and reduce the customer’s cognitive load as much as possible (e.g., aim for concise responses, visual aids, and ‘Learn More’ content).
 
-## How To Design an Agent using These Principles and Guidelines
-Imagine you are designing a Writing Coach (an example is the Microsoft 365 Writing Coach Agent), here is how you could think about using the Design Principles and Guidelines:
-1. **Transparency** – Let the user know that the Writing Coach is an AI-enabled Agent. Provide some basic instructions on how to get started (e.g., a “Hello” message, sample prompts). Clearly document this on the product page. Show the list of prompts a user has asked in the past. Make it clear how to give feedback (thumbs up and down, Send Feedback button, etc.). Clearly articulate if the Agent has usage or topic restrictions.
+## How To Design a Travel Agent using These Principles and Guidelines
+
+Imagine you are designing a Travel Agent, here is how you could think about using the Design Principles and Guidelines:
+
+1. **Transparency** – Let the user know that the Travel Agent is an AI-enabled Agent. Provide some basic instructions on how to get started (e.g., a “Hello” message, sample prompts). Clearly document this on the product page. Show the list of prompts a user has asked in the past. Make it clear how to give feedback (thumbs up and down, Send Feedback button, etc.). Clearly articulate if the Agent has usage or topic restrictions.
 2. **Control** – Make sure it’s clear how the user can modify the Agent after it’s been created with things like the System Prompt. Enable the user to choose how verbose the Agent is, its writing style, and any caveats on what the Agent should not talk about. Allow the user to view and delete any associated files or data, prompts, and past conversations.
 3. **Consistency** – Make sure the icons for Share Prompt, add a file or photo and tag someone or something are standard and recognizable. Use the paperclip icon to indicate file upload/sharing with the Agent, and an image icon to indicate graphics upload.
 
 ## Additional Resources
 - [Practices for Governing Agentic AI Systems | OpenAI](https://openai.com)
 - [The HAX Toolkit Project - Microsoft Research](https://microsoft.com)
 - [Responsible AI Toolbox](https://responsibleaitoolbox.ai)
-- Design Kit – general-purpose human-centered design approaches
+