You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-foundry/concepts/concept-playgrounds.md
+40-40Lines changed: 40 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,45 +1,45 @@
1
1
---
2
2
title: Azure AI Foundry Playgrounds
3
3
titleSuffix: Azure AI Foundry
4
-
description: Learn to use Azure AI Foundry playgrounds for exploration, experimentation, and iteration with different models.
4
+
description: Learn how to use Azure AI Foundry playgrounds for rapid prototyping, experimentation, and validation with AI models before production deployment.
5
5
ms.service: azure-ai-foundry
6
6
ms.topic: concept-article
7
-
ms.date: 06/09/2025
7
+
ms.date: 09/22/2025
8
8
ms.author: mopeakande
9
9
author: msakande
10
10
ms.reviewer: tgokal
11
11
manager: nitinme
12
12
reviewer: tgokal
13
13
ms.custom: build-2025 ai-assisted
14
-
#customer intent: I'm a developer and want to use Azure AI Foundry Playground for quick experimentation and prototyping with models and agents before going to code.
14
+
#CustomerIntent: As a developer, I want to use Azure AI Foundry playgrounds for rapid prototyping and experimentation with AI models and agents so that I can validate ideas, test API behavior, and optimize prompts before writing production code.
As you build with state-of-the-art models and build agents and apps with them, Azure AI Foundry playgrounds provide an on-demand, zero-setup environment designed for rapid prototyping, API exploration, and technical validation before you commit a single line of code to your production codebase.
21
+
As you build with state-of-the-art models and create agents and apps with them, Azure AI Foundry playgrounds provide an on-demand, zero-setup environment designed for rapid prototyping, API exploration, and technical validation before you commit a single line of code to your production codebase.
22
22
23
23
## Highlights of the Azure AI Foundry playgrounds experience
24
24
25
25
Some highlights of the Azure AI Foundry playgrounds experience include:
26
26
27
27
-**AgentOps support** for Evaluations and Tracing in the **Agents playground.**
28
-
-**Open in VS Code** for Chat and Agents playground. This feature saves you time by automatically importing your endpoint and key from Azure AI Foundry to VS Code for multi-lingual code samples.
28
+
-**Open in VS Code** for Chat and Agents playground. This feature saves you time by automatically importing your endpoint and key from Azure AI Foundry to VS Code for multilingual code samples.
29
29
-**Images Playground 2.0** for [gpt-image-1](https://ai.azure.com/explore/models/gpt-image-1/version/2025-04-15/registry/azure-openai/?cid=learnDocs), [Stable Diffusion 3.5 Large](https://ai.azure.com/explore/models/Stable-Diffusion-3.5-Large/version/1/registry/azureml-stabilityai/?cid=learnDocs), and [Bria 2.3 Fast](https://ai.azure.com/explore/models/Bria-2.3-Fast/version/1/registry/azureml-bria/?cid=learnDocs) models.
30
30
-**Audio playground** for [gpt-4o-audio](https://ai.azure.com/explore/models/gpt-4o-transcribe/version/2025-03-20/registry/azure-openai/?cid=learnDocs), [gpt-4o-transcribe](https://ai.azure.com/explore/models/gpt-4o-transcribe/version/2025-03-20/registry/azure-openai/?cid=learnDocs), and [gpt-4o-mini-tts](https://ai.azure.com/explore/models/gpt-4o-mini-tts/version/2025-03-20/registry/azure-openai/?cid=learnDocs) models.
31
31
-**Video playground** for Azure OpenAI Sora.
32
32
33
33
:::image type="content" source="../media/concept-playgrounds/playground-landing-page.png" alt-text="Screenshot of the Azure AI Foundry playground landing page showcasing features for rapid prototyping and experimentation. The left pane of the portal has been customized to show the Playgrounds tab." lightbox="../media/concept-playgrounds/playground-landing-page.png":::
34
34
35
35
> [!TIP]
36
-
> In the screenshot of the playground landing page, the left pane of the portal has been customized to show the Playgrounds tab. To learn more about seeing the other items in the left pane, see [Customize the left pane](../what-is-azure-ai-foundry.md#left-pane).
36
+
> In the screenshot of the playground landing page, the left pane of the portal is customized to show the Playgrounds tab. To learn more about seeing the other items in the left pane, see [Customize the left pane](../what-is-azure-ai-foundry.md#left-pane).
37
37
38
38
## Playgrounds as the prelude to production
39
39
40
-
Modern development involves working across multiple systems—APIs, services, SDKs, and data models—often before you're ready to fully commit to a framework, write tests, or spin up infrastructure. As the complexity of software ecosystems increases, the need for safe, lightweight environments to validate ideas becomes critical. The playgrounds were built to meet this need.
40
+
Modern development involves working across multiple systems—APIs, services, SDKs, and data models—often before you're ready to fully commit to a framework, write tests, or spin up infrastructure. As the complexity of software ecosystems increases, the need for safe, lightweight environments to validate ideas becomes critical. The playgrounds are built to meet this need.
41
41
42
-
The Azure AI Foundry playgrounds provide ready-to-use environments with all the necessary tools and features pre-installed, eliminating the need to set up projects, manage dependencies, or solve compatibility issues. The playgrounds can *accelerate developer velocity* by validating API behavior, going quicker to code, reducing cost of experimentation and time to ship, accelerating integration, optimizing prompts, and more.
42
+
The Azure AI Foundry playgrounds provide ready-to-use environments with all the necessary tools and features preinstalled, so you don't need to set up projects, manage dependencies, or solve compatibility issues. The playgrounds can *accelerate developer velocity* by validating API behavior, going quicker to code, reducing cost of experimentation and time to ship, accelerating integration, optimizing prompts, and more.
43
43
44
44
Playgrounds also *provide clarity quickly* when you have questions, by providing answers in seconds—rather than hours—and allowing you to test and validate ideas before you commit to building at scale. For example, the playgrounds are ideal for quickly answering questions like:
45
45
@@ -50,60 +50,60 @@ Playgrounds also *provide clarity quickly* when you have questions, by providing
50
50
51
51
## Open in VS Code capability
52
52
53
-
The **Chat playground** and **Agents playground**allow you to work in VS Code, by using the **Open in VS Code** button that's available through the Azure AI Foundry extension in VS Code.
53
+
The **Chat playground** and **Agents playground**let you work in VS Code by using the **Open in VS Code** button. You can find this button through the Azure AI Foundry extension in VS Code.
54
54
55
-
Available on the multi-lingual sample code samples, "Open in VS Code" enables the automatic import of your code sample, API endpoint, and key to a VS Code workspace in an `/azure` environment. This functionality makes it easy to work in the VS Code IDE from the Azure AI Foundry portal.
55
+
Available on the multilingual sample code samples, **Open in VS Code** automatically imports your code sample, API endpoint, and key to a VS Code workspace in an `/azure` environment. This functionality makes it easy to work in the VS Code IDE from the Azure AI Foundry portal.
56
56
57
-
Follow these steps to use the "Open in VS Code" functionality from the chat and agents playgrounds:
57
+
To use the **Open in VS Code** functionality from the chat and agents playgrounds, follow these steps:
58
58
59
-
1. Select **Try the Chat playground** to open it. Alternatively, you could follow these steps in the Agents playground by selecting **Let's go** on the Agents playground card.
59
+
1. Select **Try the Chat playground** to open it. Alternatively, you can follow these steps in the Agents playground by selecting **Let's go** on the Agents playground card.
60
60
1. If you don't have a deployment already, select **Create new deployment** and deploy a model such as `gpt-4o-mini`.
61
-
1.Ensure that your deployment is selected in the Deployment box.
61
+
1.Make sure your deployment is selected in the Deployment box.
62
62
1. Select **View code** to see the code sample.
63
63
1. Select **Open in VS Code** to open VS Code in a new tab of your browser window.
64
64
65
65
:::image type="content" source="../media/concept-playgrounds/open-in-vs-code-foundry.png" alt-text="Screenshot showing the Open in VS Code button in Azure AI Foundry playground for seamless code integration." lightbox="../media/concept-playgrounds/open-in-vs-code-foundry.png":::
66
66
67
-
1. You're redirected to the `/azure` environment of VS Code where your code sample, API endpoint and key are already imported from the Azure AI Foundry playground.
67
+
1. You're redirected to the `/azure` environment of VS Code where your code sample, API endpoint, and key are already imported from the Azure AI Foundry playground.
68
68
69
69
:::image type="content" source="../media/concept-playgrounds/open-in-vs-code-vscode.png" alt-text="Screenshot of the VS Code environment showing imported code sample, API endpoint, and key from the Azure AI Foundry playground." lightbox="../media/concept-playgrounds/open-in-vs-code-vscode.png":::
70
70
71
-
1. Browse the `READ.ME` file for instructions to run your model.
72
-
1. View your code sample in the `run_model.py`.
71
+
1. Browse the `README.md` file for instructions to run your model.
72
+
1. View your code sample in the `run_model.py` file.
73
73
1. View relevant dependencies in the `requirements.txt` file.
74
74
75
75
76
76
## Agents playground
77
77
78
-
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. To get started with the Agents playground, see the [Quickstart: Create a new agent](../../ai-services/agents/quickstart.md).
78
+
The agents playground lets you explore, prototype, and test agents without running any code. From this page, you can quickly iterate and experiment with new ideas. To get started with the Agents playground, see the [Quickstart: Create a new agent](../../ai-services/agents/quickstart.md).
79
79
80
80
:::image type="content" source="../media/concept-playgrounds/agents-playground.png" alt-text="Screenshot of the agents playground interface for exploring, prototyping, and testing agents without code." lightbox="../media/concept-playgrounds/agents-playground.png":::
81
81
82
82
## Chat playground
83
83
84
84
The chat playground is the place to test the latest reasoning models from Azure OpenAI, DeepSeek, and Meta. To learn more about the chat playground, see the [Quickstart: Use the chat playground in Azure AI Foundry portal](../quickstarts/get-started-playground.md).
85
85
86
-
For all reasoning models, the chat playground provides a chain-of-thought summary drop-down that lets you see how the model was thinking through its response ahead of sharing the output.
86
+
For all reasoning models, the chat playground provides a chain-of-thought summary drop-down that lets you see how the model thinks through its response before sharing the output.
87
87
88
88
:::image type="content" source="../media/concept-playgrounds/chat-playground-cot-summary.png" alt-text="Screenshot of the Chat playground interface for exploring, prototyping, and testing chat models without code." lightbox="../media/concept-playgrounds/chat-playground-cot-summary.png":::
89
89
90
90
## Audio playground
91
91
92
92
The audio playground (preview) lets you use text-to-speech and transcription capabilities with the latest audio models from Azure OpenAI.
93
93
94
-
Follow these steps to try the text to speech capability:
94
+
To try the text-to-speech capability, follow these steps:
95
95
96
96
1. Select **Try the Audio playground** to open it.
97
97
1. If you don't have a deployment already, select **Create new deployment** and deploy a model such as `gpt-4o-mini-tts`.
98
-
1.Ensure that your deployment is selected in the Deployment box.
98
+
1.Make sure your deployment is selected in the Deployment box.
99
99
1. Input a text prompt.
100
100
1. Adjust model parameters such as voice and response format.
101
101
1. Select **Generate** to receive a speech output with playback controls that include play, rewind, forward, adjust speed, and volume.
102
102
1. Download the audio file to your local computer.
103
103
104
104
:::image type="content" source="../media/concept-playgrounds/audio-playground-text-to-speech.png" alt-text="Screenshot of the Audio playground interface showcasing text-to-speech capabilities with playback controls." lightbox="../media/concept-playgrounds/audio-playground-text-to-speech.png":::
105
105
106
-
Follow these steps to try the transcription capability:
106
+
To try the transcription capability, follow these steps:
107
107
108
108
1. If you don't have a deployment already, select **Create new deployment** and deploy a model such as `gpt-4o-transcribe`.
109
109
1. (Optional) Include a phrase list as a text mechanism to guide your audio input.
@@ -115,9 +115,9 @@ Follow these steps to try the transcription capability:
115
115
116
116
## Video playground
117
117
118
-
The video playground (preview) is your rapid iteration environment for exploring, refining, and validating generative video workflows—designed for developers who need to go from idea to prototype with precision, control, and speed. The playground gives you a low-friction interface to test prompt structures, assess motion fidelity, evaluate model consistency across frames, and compare outputs across models—without writing boilerplate or wasting compute cycles. It's also a great demo interface for your Chief Product Officer and Engineering VP.
118
+
The video playground (preview) is your rapid iteration environment for exploring, refining, and validating generative video workflows. It's designed for developers who need to go from idea to prototype with precision, control, and speed. The playground gives you a low-friction interface to test prompt structures, assess motion fidelity, evaluate model consistency across frames, and compare outputs across models—without writing boilerplate or wasting compute cycles. It's also a great demo interface for your chief product officer and engineering VP.
119
119
120
-
All model endpoints are integrated with **Azure AI Content Safety**. As a result, harmful and unsafe images are filtered out before being surfaced in the video playground. If your text prompt and video generation are flagged by content moderation policies, you get a warning notification.
120
+
All model endpoints are integrated with **Azure AI Content Safety**. As a result, harmful and unsafe images are filtered out before they appear in the video playground. If content moderation policies flag your text prompt or video generation, you get a warning notification.
121
121
122
122
You can use the video playground with the **Azure OpenAI Sora** model.
123
123
@@ -127,7 +127,7 @@ You can use the video playground with the **Azure OpenAI Sora** model.
127
127
Follow these steps to use the video playground:
128
128
129
129
> [!CAUTION]
130
-
> Videos generated are retained for 24 hours due to data privacy. Download videos to your local computer for longer retention.
130
+
> Videos you generate are retained for 24 hours due to data privacy. Download videos to your local computer for longer retention.
131
131
132
132
1. Select **Try the Video playground** to open it.
133
133
1. If you don't have a deployment already, select **Deploy now** from the top right side of the homepage and deploy the `sora` model.
@@ -155,33 +155,33 @@ Follow these steps to use the video playground:
155
155
156
156
### What to validate when experimenting in video playground
157
157
158
-
When using the video playground as you plan your production workload, you can explore and validate the following attributes:
158
+
When you use the video playground to plan your production workload, explore and validate the following attributes:
159
159
160
160
-**Prompt-to-Motion Translation**
161
-
- Does the video model interpret my prompt in a way that makes logical and temporal sense?
161
+
- Does the video model interpret your prompt in a way that makes logical and temporal sense?
162
162
- Is motion coherent with the described action or scene?
163
163
-**Frame Consistency**
164
164
- Do characters, objects, and styles remain consistent across frames?
165
165
- Are there visual artifacts, jitter, or unnatural transitions?
166
166
-**Scene Control**
167
-
- How well can I control scene composition, subject behavior, or camera angles?
168
-
- Can I guide scene transitions or background environments?
167
+
- How well can you control scene composition, subject behavior, or camera angles?
168
+
- Can you guide scene transitions or background environments?
169
169
170
170
-**Length and Timing**
171
171
- How do different prompt structures affect video length and pacing?
172
172
- Does the video feel too fast, too slow, or too short?
173
173
174
174
-**Multimodal Input Integration**
175
-
- What happens when I provide a reference image, pose data, or audio input?
176
-
- Can I generate video with lip-sync to a given voiceover?
175
+
- What happens when you provide a reference image, pose data, or audio input?
176
+
- Can you generate video with lip-sync to a given voiceover?
177
177
178
178
-**Post-Processing Needs**
179
-
- What level of raw fidelity can I expect before I need editing tools?
180
-
- Do I need to upscale, stabilize, or retouch the video before using it in production?
179
+
- What level of raw fidelity can you expect before you need editing tools?
180
+
- Do you need to upscale, stabilize, or retouch the video before using it in production?
181
181
182
-
-**Latency & Performance**
182
+
-**Latency and Performance**
183
183
- How long does it take to generate video for different prompt types or resolutions?
184
-
- What's the cost-performance tradeoff of generating 5s vs. 15s clips?
184
+
- What's the cost-performance tradeoff of generating 5-second versus 15-second clips?
185
185
186
186
187
187
## Images playground
@@ -209,7 +209,7 @@ Follow these steps to use the images playground:
209
209
210
210
### What to validate when experimenting in images playground
211
211
212
-
By using the images playground, you can explore and validate the following as you plan your production workload:
212
+
By using the images playground, you can explore and validate the following aspects as you plan your production workload:
213
213
214
214
-**Prompt Effectiveness**
215
215
- What kind of visual output does this prompt generate for my enterprise use case?
@@ -221,12 +221,12 @@ By using the images playground, you can explore and validate the following as yo
221
221
- Can I iterate on variations of the same base prompt with minimal drift?
222
222
223
223
-**Parameter Tuning**
224
-
- What's the effect of changing model parameters like guidance scale, seed, steps, etc.?
225
-
- How can I balance creativity vs. prompt fidelity?
224
+
- What's the effect of changing model parameters like guidance scale, seed, steps, and others?
225
+
- How can I balance creativity versus prompt fidelity?
226
226
227
227
-**Model Comparison**
228
-
- How do results differ between models (for example, SDXL vs. DALL·E)?
229
-
- Which model performs better for realistic faces vs. artistic compositions?
228
+
- How do results differ between models, such as SDXL versus DALL·E?
229
+
- Which model performs better for realistic faces versus artistic compositions?
230
230
231
231
-**Composition Control**
232
232
- What happens when I use spatial constraints like bounding boxes or inpainting masks?
@@ -237,7 +237,7 @@ By using the images playground, you can explore and validate the following as yo
237
237
- What's the best way to prompt for symmetry, specific camera angles, or emotions?
238
238
239
239
-**Integration Readiness**
240
-
- Will this image meet the constraints of my product's UI (aspect ratio, resolution, content safety)?
240
+
- Will this image meet the constraints of my product's UI, including aspect ratio, resolution, and content safety?
241
241
- Does the output conform to brand guidelines or customer expectations?
0 commit comments