Merge pull request #2481 from aahill/foundry-docs

foundry quickstart

Author: v-dirichards

articles/ai-services/agents/includes/quickstart-foundry.md

@@ -0,0 +1,70 @@
+---
+manager: nitinme
+author: aahill
+ms.author: aahi
+ms.service: azure
+ms.topic: include
+ms.date: 01/21/2025
+---
+
+## Prerequisites
+- An Azure subscription - <a href="https://azure.microsoft.com/free/cognitive-services" target="_blank">Create one for free</a>.
+- An [Azure AI hub resource](../../../ai-studio/how-to/create-azure-ai-resource.md) with a model deployed. For more information about model deployment, see the [resource deployment guide](../../../ai-studio/how-to/create-azure-ai-resource.md).
+- An [Azure AI project](../../../ai-studio/how-to/create-projects.md) in Azure AI Foundry portal.
+- Make sure you have the **Azure AI Developer** [RBAC role](../../../ai-studio/concepts/rbac-ai-studio.md) assigned.
+
+## Go to the Azure AI Foundry portal (Preview)
+
+1. Sign in to [Azure AI Foundry](https://ai.azure.com).
+1. Go to your project or [create a new project](../../../ai-studio//how-to/create-projects.md) in Azure AI Foundry portal.
+1. From your project overview, select **Agents**, located under **playgrounds**. The Agents playground allows you to explore, prototype, and test AI Agents without needing to run any code. From this page, you can quickly iterate and experiment with new ideas.
+
+1. Select your Azure OpenAI resource and optionally an Azure AI Search resource. 
+
+    > [!IMPORTANT]
+    > * If you don't select an Azure AI Search resource, A Microsoft-managed storage will be used to contain your data. If you do select an Azure AI Search resource, then customer-managed storage will be used.  
+    > * If you don't select an Azure AI Search resource now, and begin using customer-managed storage later, the data stored in the Microsoft-managed storage will be lost. 
+
+    :::image type="content" source="../media/quickstart/agents-foundry.png" alt-text="A screenshot of the initial Agents screen." lightbox="../media/quickstart/agents-foundry.png"::: 
+ 
+1. Select a [model](../concepts/model-region-support.md) deployment for the Agent to use. If you don't have one, a screen to deploy a new model will open. Otherwise you can select **Deploy a model**.
+
+    :::image type="content" source="../media/quickstart/select-deploy-model.png" alt-text="A screenshot of the model selection screen." lightbox="../media/quickstart/select-deploy-model.png"::: 
+
+    :::image type="content" source="../media/quickstart/model-list.png" alt-text="A screenshot of the available models." lightbox="../media/quickstart/model-list.png"::: 
+
+1. In the **Create and debug your agents** screen that appears, select **New agent**. This will create a new agent, and open a **Setup** pane where you can change its parameters and tools. 
+
+    You can optionally give your agent a name other than the one generated for it, and add instructions to help improve its performance. Give your agent clear directions on what to do and how to do it. Include specific tasks, their order, and any special instructions like tone or engagement style.
+
+    :::image type="content" source="../media/quickstart/create-debug-agent.png" alt-text="A screenshot of the Agents create and debug screen." lightbox="../media/quickstart/create-debug-agent.png":::
+
+    > [!TIP]
+    > Your agent can access multiple [**tools**](../how-to/tools/overview.md) that extend its capabilities, such as the ability to search the web with Bing, run code, and more. In the **Setup** pane, scroll down to **knowledge** and **action** and select **Add** to see the tools available for use. 
+    > :::image type="content" source="../media/quickstart/portal-tools.png" alt-text="A screenshot of the Agents tool choices." lightbox="../media/quickstart/portal-tools.png":::
+
+    
+
+1. At the top of the **Setup** pane, select **Try in playground** to start using your agent.
+
+## Use your agent
+
+The **Agents playground** allows you to explore, prototype, and test agents without needing to run any code. From this page, you can quickly iterate and experiment with new ideas. When you interact with an agent, it:
+
+1. Creates a thread object, which contains the context for a conversation, including individual messages sent between the agent and a user.
+
+1. Appends a message object to the thread. A new message will be added to the thread for each turn of a conversation between an agent and a user. 
+
+1. Creates a run object on the thread to generate a response by calling the model and any tools you've added.     
+
+To interact with your agent:
+
+1. Optionally change the **agent name** if you want, and add **instructions**. Instructions guide the personality of the agent and define its goals. Instructions are similar to [system messages](../../openai/concepts/advanced-prompt-engineering.md). 
+
+1. In the chat area of the playground, enter a message and wait for the agent to respond. 
+    
+:::image type="content" source="../media/quickstart/agents-playground.png" alt-text="A screenshot of the Agents playground." lightbox="../media/quickstart/agents-playground.png":::
+
+## See also
+
+* See the [tools overview](../how-to/tools/overview.md) to learn about the tools you can allow your agent to use to extend its capabilities.

articles/ai-services/agents/media/quickstart/agents-foundry.png

@@ -8,14 +8,20 @@ ms.author: aahi
 ms.service: azure-ai-agent-service
 ms.topic: quickstart
 ms.date: 12/11/2024
-zone_pivot_groups: programming-languages-agents
+zone_pivot_groups: agents-quickstart
 ms.custom: azure-ai-agents
 ---
 
 # Quickstart: Create a new agent
 
 Azure AI Agent Service allows you to create AI agents tailored to your needs through custom instructions and augmented by advanced tools like code interpreter, and custom functions.
 
+::: zone pivot="ai-foundry"
+
+[!INCLUDE [quickstart-ai-foundry](includes/quickstart-foundry.md)]
+
+::: zone-end
+
 ::: zone pivot="programming-language-csharp"
 
 [!INCLUDE [quickstart-csharp](includes/quickstart-csharp.md)]

articles/ai-services/agents/media/quickstart/agents-playground.png

@@ -38,15 +38,6 @@ groups:
       title: C#
     - id: programming-language-rest
       title: REST
-- id: azure-ai-model-catalog-sub-group-samples
-# Owner: mopeakande
-  title: Programming languages
-  prompt: Choose a tool or API
-  pivots:
-    - id: programming-language-python
-      title: Python
-    - id: programming-language-rest
-      title: REST
 - id: programming-languages-set-conmod
 # Owner: pafarley
   title: Programming languages
@@ -146,7 +137,7 @@ groups:
   prompt: Choose your preferred usage method
   pivots:
   - id: programming-language-studio
-    title: Portal
+    title: Studio
   - id: programming-language-csharp
     title: C#
   - id: programming-language-go
@@ -575,21 +566,6 @@ groups:
     title: "JavaScript: Node.js"
   - id: programming-language-python
     title: Python
-- id: azure-ai-inference-samples
-# Owner: santiagxf
-  title: Programing languages
-  prompt: Choose a tool or API
-  pivots:
-    - id: programming-language-python
-      title: Python
-    - id: programming-language-javascript
-      title: JavaScript
-    - id: programming-language-java
-      title: Java
-    - id: programming-language-csharp
-      title: C#
-    - id: programming-language-rest
-      title: REST
 - id: azure-ai-model-catalog-samples-embeddings
 # Owner: santiagxf
   title: Programing languages
@@ -601,17 +577,6 @@ groups:
       title: JavaScript
     - id: programming-language-rest
       title: REST
-- id: azure-ai-models-deployment
-# Owner: santiagxf
-  title: Prograaming languages
-  prompt: Choose a tool or API
-  pivots:
-    - id: ai-foundry-portal
-      title: Foundry portal
-    - id: programming-language-cli
-      title: Azure CLI
-    - id: programming-language-bicep
-      title: Bicep
 - id: aml-control-methods
   # Owner: gopalv
   title: Azure Machine Learning control plane
@@ -951,10 +916,12 @@ groups:
     title: Python
   - id: programming-language-typescript
     title: TypeScript
-- id: programming-languages-agents
-  title: Programming languages
-  prompt: Choose a programming language
+- id: agents-quickstart
+  title: Usage methods
+  prompt: Choose a usage method
   pivots:
+  - id: ai-foundry
+    title: AI Foundry
   - id: programming-language-csharp
     title: C#
   - id: programming-language-python-azure
@@ -1022,18 +989,3 @@ groups:
     title: Python
   - id: programming-language-csharp
     title: C#
-- id: audio-completions-quickstart
-# Owner: eur
-  title: Programming languages
-  prompt: Choose a tool or API
-  pivots:
-  - id: ai-foundry-portal
-    title: Portal
-  - id: programming-language-javascript
-    title: JavaScript
-  - id: programming-language-python
-    title: Python
-  - id: programming-language-typescript
-    title: TypeScript
-  - id: rest-api
-    title: REST