microsoft · ntrogh · Jun 18, 2025 · Jun 11, 2025 · Jun 12, 2025 · Jun 12, 2025
diff --git a/docs/intelligentapps/images/playground/capability_warning.png b/docs/intelligentapps/images/playground/capability_warning.png
diff --git a/docs/intelligentapps/images/playground/chat_prompt.png b/docs/intelligentapps/images/playground/chat_prompt.png
diff --git a/docs/intelligentapps/images/playground/compare.png b/docs/intelligentapps/images/playground/compare.png
diff --git a/docs/intelligentapps/images/playground/deploy_to_foundry.png b/docs/intelligentapps/images/playground/deploy_to_foundry.png
diff --git a/docs/intelligentapps/images/playground/parameters.png b/docs/intelligentapps/images/playground/parameters.png
diff --git a/docs/intelligentapps/images/playground/playground.png b/docs/intelligentapps/images/playground/playground.png
diff --git a/docs/intelligentapps/images/playground/response_area.png b/docs/intelligentapps/images/playground/response_area.png
diff --git a/docs/intelligentapps/images/playground/tool_bar.png b/docs/intelligentapps/images/playground/tool_bar.png
diff --git a/docs/intelligentapps/playground.md b/docs/intelligentapps/playground.md
@@ -1,40 +1,106 @@
 ---
 ContentId: e919aee8-fd2e-401b-9d83-0ff6f98b23ba
-DateApproved: 12/11/2024
+DateApproved: 14/06/2025
 MetaDescription: Chat with selected generative AI model in playground. Change system prompt and parameters. Add attachment for Multi-Modal models. Keep chat history.
 ---
-# AI Toolkit playground
+# Model playground in AI Toolkit
+The AI Toolkit playground provides an interactive environment to experiment with generative AI models. You can test various prompts, adjust model parameters, compare responses from different models and explore multi-modal capabilities by attaching different types of input files.
 
-The AI Toolkit playground enables you to interact with your AI models and try different prompts with different model parameter settings. You can also use the playground to interact with multi-modal models that support attachment of different input formats.
-
-![Playground view](./images/playground/playground.png)
+![AI Toolkit playground interface showing a chat interaction with a generative AI model.](./images/playground/playground.png)
 
 ## Test a model in the playground
 
 To access the playground:
 
-- In AI Toolkit view, select **Playground**
-
-- Select **Load in Playground** or **Try in Playground** from a model card in the model catalog
+- In AI Toolkit view, select **Tools** > **Playground**
+- Select **Try in Playground** from a model card in the model catalog
+- Double click a model from **MY Models** to open it in the playground
 
 To test a model in the playground, follow these steps:
 
-1. In **Model Preferences**, select a model from the dropdown list
+1. In **Model Preferences**, select a model from the dropdown list.
+2. Optionally, add a **System Prompt** to guide the model response.
+3. Optionally, configure the model parameters available for the selected model.
+4. Enter a chat prompt in the chat input box
+
+## Model preferences
+![Model Preferences panel displaying adjustable parameters for generative AI models](./images/playground/parameters.png)
+
+The **Model Preferences** panel allows you to select a model for playground interaction, set system prompts to guide the model's behavior and configure the model parameters for the selected model.
+
+### Select a model
+The dropdown list in the **Model Preferences** panel shows the models you have added to AI Toolkit. You can select **Browse Models** to open the model catalog and add more models.
+
+### System prompt
+A system prompt is a predefined instruction that guides the model's behavior and response style. You can add, edit, or delete the system prompt in the input text area to influence how the model generates responses.
+
+### Configure inference parameters
+The available parameters depend on the model type and publisher. Common parameters include:
+- Temperature: Controls the randomness of the model's output. Lower values make the output more deterministic. Higher values introduce more variability.
+- Top P: Controls the diversity of the output by limiting the cumulative probability of the selected tokens. A lower value results in more focused responses. A higher value allows for more diverse outputs.
+- Max Response Length (Tokens): Sets the maximum number of tokens in the model's response. This limits the length of the generated text.
+- Frequency Penalty: Reduces the likelihood of the model repeating the same tokens in the response. Higher values discourage repetition.
+- Presence Penalty: Encourages the model to introduce new topics or concepts in the response. Higher values promote diversity in the generated text.
+
+## Chat prompt
+
+![Chat prompt input box in AI Toolkit playground showing an attachment icon for adding files.](./images/playground/chat_prompt.png)
+
+The chat prompt is the input text you provide to the model. You can enter a question, statement, or any text that you want the model to respond to. The model generates a response based on the provided prompt and the configured system prompts and parameters.
+
+Available features in the chat prompt input box:
+- **Send**: Submit the chat prompt to the model for processing.
+- **Clear**: Clear the chat prompt input box.
+- **File Attachment**: Attach files to the chat prompt for multi-modal models.
+- **Image Attachment**: Attach images to the chat prompt for multi-modal models.
+- **Web Search**: Perform a web search to find information related to the chat prompt.
+- **Mode Switch**: Switch between different modes for using AI features.
+
+### Switch between modes
+You can switch between different modes in the chat prompt input box:
+- **Use native supported AI features from a model**: This mode allows you to use the native capabilities of the selected model, such as web search or file attachment.
+- **Use all AI features**: This mode allows you to use AI feature implemented by AI Toolkit, such as file attachment regardless of the model's native capabilities.
+
+If a capability is not supported by the selected model or by AI Toolkit, a warning appears above the chat prompt input box. The warning recommends that you switch to a different model that supports the feature.
+
+![Screenshot showing warning message displayed above the chat prompt input box stating Capability not supported.](./images/playground/capability_warning.png)
+
+## Model responses
+![AI Toolkit playground response area showing a generated Python code snippet for encoding text in base64, with options to copy or regenerate the response.](./images/playground/response_area.png)
 
-    ![Select a model and configure context instructions in the playground.](./images/playground/parameters.png)
+Model responses are displayed above the chat prompt input box. Before you enter a chat prompt, the playground shows a welcome screen with three starter prompts for you to get started with the playground.
 
-1. Optionally, add context instructions to guide the model response
+Available features in the model response area:
+- **Copy Response**: Copy the model's response text to the clipboard.
+- **Regenerate Response**: Regenerate the model's response based on the same prompt or regenerate response with another model.
+- **Copy Code**: Copy the generated code in the response to the clipboard or insert it into a new file.
+- **Rendering**: Playground supports rendering of code snippets, images, markdown, LaTex and other content in the model's response.
+- **Token Count**: Displays the number of tokens used in the model's response. This helps you understand the cost and performance of the model.
 
-1. Optionally, configure the model parameters
+## Tool bar
 
-1. Enter a chat prompt in the chat input box
+The tool bar in the playground provides quick access to various actions and features:
+![Tool bar in AI Toolkit playground showing buttons for clearing chat history, saving chat, and switching modes.](./images/playground/tool_bar.png)
 
-    From the chat input box, you can also clear chat history or add attachments for the prompt.
+- **New Playground**: Create a new playground session.
+- **History**: View, rename, delete, and switch to a chat history.
+- **Automatic Naming**: Names of chat sessions are automatically generated based on the user prompt.
+- **Compare**: Compare responses from different models side by side.
+- **View Code**: View the generated code for the chat prompt from LLM integration.
 
-## Add attachments for multi-modal models
+### Compare model responses
+![Screenshot showing side by side comparison of responses from different models in the AI Toolkit playground.](./images/playground/compare.png)
 
-Multi-modal models are models that can process multiple types of input, such as text, images, audio, or video. By attaching files to your chat prompt, you can ask questions about the contents of these files.
+The **Compare** feature allows you to compare responses from different models side by side. This is useful for evaluating the performance of different models on the same prompt.
 
-For the models that support attachments, the attachment icon (paperclip) will show in the chat input box. Select the icon, and follow the instructions to attach one or more local files and use them with your prompt.
+To compare model responses:
+1. Select the **Compare** button in the tool bar.
+2. Choose the models you want to compare from the dropdown list.
+3. Enter the same chat prompt in one of the input boxes. Your prompt is copied to the other input boxes.
+4. Select **Send** to submit the prompt to all selected models.
+5. The responses from each model appear side by side for easy comparison.
 
-![Adding attachments](./images/playground/attachment.png)
+For each model you are comparing, you can:
+- Copy the response text to the clipboard.
+- Configure the model parameters for the selected model.
+- Continue the chat with the selected model.