Merge pull request #2539 from aahill/foundry-docs-3

Quickstart

Author: denrea

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

@@ -9,21 +9,48 @@ 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)
+## Basic agent setup support
+
+Before getting started, determine if you want to perform a basic agent setup or a standard agent setup. Azure AI Foundry only supports basic agent setup. 
+
+**Basic Setup**:  Agents use multitenant search and storage resources fully managed by Microsoft. You don't have visibility or control over these underlying Azure resources. A basic setup can be created using the Azure AI Foundry portal or an automated bicep template.
+
+**Standard Setup**: Agents use customer-owned, single-tenant search and storage resources. With this setup, you have full control and visibility over these resources, but you incur costs based on your usage. Standard setup can only be performed using an automated bicep template.
+
+> [!IMPORTANT]
+> The Azure AI Foundry portal only supports basic setup at this time. If you want to perform a standard agent setup, use the other tabs at the top of the article to learn about standard agent configuration.  
+
+## Create a hub and project in Azure AI Foundry portal
+
+To create a new hub and project, you need either the Owner or Contributor role on the resource group or on an existing hub. If you're unable to create a hub due to permissions, reach out to your administrator.
+
+To create a project in Azure AI Foundry, follow these steps:
+
+1. Go to Azure AI Foundry. If you are in a project, select Azure AI Foundry at the top left of the page to go to the Home page.
+
+1. Select **+ Create project**.
+
+1. Enter a name for the project.
+
+1. If you have a hub, you'll see the one you most recently used selected.
+
+1. If you have access to more than one hub, you can select a different hub from the dropdown.
+
+1. If you want to create a new one, select **Create new hub** and supply a name. If you want to customize the default values, see the [Azure AI Foundry documentation](../../../ai-studio/how-to/create-projects.md?tabs=ai-studio#customize-the-hub).
+
+    :::image type="content" source="../../../ai-studio/media/how-to/projects/projects-create-details.png" alt-text="Screenshot of the project details page within the create project dialog." lightbox="../../../ai-studio/media/how-to/projects/projects-create-details.png":::
+
+1. Select **Create**.
+
+## Deploy a model
 
 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. 
+1. Select your Azure OpenAI resource.
 
     :::image type="content" source="../media/quickstart/agents-foundry.png" alt-text="A screenshot of the initial Agents screen." lightbox="../media/quickstart/agents-foundry.png"::: 
 
@@ -33,7 +60,11 @@ ms.date: 01/21/2025
 
     :::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. 
+## Use the agent playground
+
+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.
+
+1. If you haven't already, select **Agents** from the navigation menu on the left. 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.
 
@@ -43,28 +74,6 @@ ms.date: 01/21/2025
     > 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.