update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/en-us/assets/assistant/Studio-Object-Insert.png

@@ -1,131 +1,92 @@
 ---
 title: Assistant
-description: How to use the Assistant to help you build, grow, and monetize your creations.
+description: How to use Assistant to help build, grow, and monetize your creations.
 ---
 
-import BetaAlert from '../includes/beta-features/beta-alert.md'
+**Assistant** is an AI helper that accelerates content creation by helping you get started, supplementing your skills, and assisting with ongoing development. It can do the following and much more:
 
-**Assistant** is an AI helper that can answer questions about building, growing, and monetizing Roblox creations. It is trained on the official Roblox documentation and is designed to answer these categories of questions:
-
-- **Building** — Answers questions about [creating an experience](../creation.md) in Studio.
-- **Scripting** — Generate simple [scripts](../scripting/index.md) and/or ask for an explanation of Lua code.
-- **Growing** — Answers questions about improving an existing experience by leveraging its [analytics](../production/analytics/index.md).
-- **Monetizing** — Answers questions about how to [monetize](../production/monetization/index.md) your experience.
+- Answer how to do things on Roblox
+- Add and edit objects and scripts directly in your place's data model
+- Insert objects from the Creator Store
+- "Explain this code" by selecting parts of a script in the Script Editor
+- Create materials to restyle your objects
 
 <Alert severity="info">
 [Built with Meta Llama 3](https://llama.meta.com/llama3/license/)
 </Alert>
 
-## Using Assistant
+## Studio Features
 
-Assistant is accessible from both the official [Documentation](../) site and within [Studio](../studio/index.md).
+You can access Assistant from [Studio](../studio/index.md) and the [documentation](/assistant), but Studio has the larger set of features. In Studio, Assistant consists of a large language model (LLM) that generates code and a run-command module (similar to the existing [command bar](../studio/ui-overview.md#command-bar)) that runs code.
 
-### From Documentation
+As a result, Assistant can act directly on your data model, such as inserting and modifying objects, writing and inserting scripts, and automating repetitive tasks like modifying properties in bulk.
 
-To access Assistant from the official [Documentation](../) site:
+For a more in-depth look at what Assistant can do and how to use it, see the [Prompt Guide and Examples](prompt-engineering.md) and the following Roblox Staff livestream for tips, tricks, and inspiration.
 
-1. In the upper navigation bar, click the **Assistant** button.
+<iframe width="640" height="360" src="https://www.youtube.com/embed/vMaOGgeuR4Y?si=fuX-80mMMzhQB6sn&amp;start=240" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
 
-   <img src="../assets/assistant/Documentation-Button.png" width="650" />
+### Insert and Modify Scripts
 
-1. Select a premade question or type your own. See [Prompting Tips](#prompting-tips) for guidance on generating improved responses.
+Assistant can insert new scripts, modify existing ones, and perform these actions across multiple objects as necessary. For example, if you ask it to create a remote event, it can create a local script, a server script, and the event all at once.
 
-   <img src="../assets/assistant/Documentation-Prompts.png" width="790" />
+If you enter a script generation request like "Make the player's character jump when they touch this part," Assistant shows the script's contents and adds the new script instance to the currently selected object in the data model. If nothing is selected, Assistant decides where to place it based on your prompts.
 
-1. Based on the result, you can then:
+<img src="../assets/assistant/Studio-Script-Insert.png" width="360" alt="Requested script inserted into selected part." />
 
-   - Click thumbs up or thumbs down to rate the result and improve future results.
-   - Click the redo icon to process a new result.
+The generated script might not function flawlessly. In these cases, you can either make further edits in the [Script Editor](../studio/script-editor.md) or ask Assistant to edit the script it just created. It can even act on existing scripts that it didn't create if you need help with code that you've written yourself.
 
-   <img src="../assets/assistant/Documentation-Options.png" width="790" />
+### Insert and Modify Objects
 
-### In Studio
+Assistant can create, edit, delete and iterate on instances in your data model, including inserting items from the Creator Store.
 
-<BetaAlert betaName="Assistant Preview" leadIn="The Studio tooling is currently in beta through " leadOut="." components={props.components} />
+<img src="../assets/assistant/Studio-Object-Insert.png" width="532" alt="Assistant adding objects through the Studio prompt." />
 
-To access Assistant from Studio:
+If you examine the code, you can see that Assistant calls `Class.InsertService:GetFreeModels()` to query the Creator Store for a wheelbarrow model and uses `Class.Model:PivotTo()` to place it near a tree.
 
-1. Click the **Assistant** button in the top-right corner of Studio.
+### Provide Answers and Suggestions
 
-   <img src="../assets/studio/general/Toolbar-Assistant.png" width="754" alt="Assistant button indicated in top-right area of toolbar" />
+If you need general knowledge or help while creating an experience, you can ask Assistant questions like how to make a team system, how to design a game loop, how to use specific Studio tools, and much more. It can even explain code that it generated or that you wrote yourself.
 
-2. Type a request into the field near the bottom of the window, using guidance from [Prompting Tips](#prompting-tips) to generate improved responses. Based on the result, you can then:
+<img src="../assets/assistant/Studio-Explain-Code.png" width="360" alt="Code explanation provided by Assistant in Studio." />
 
-   - Click thumbs up or thumbs down to rate the result and improve future results.
-   - Click the redo icon to process a new result.
-
-   <img src="../assets/assistant/Studio-General-UI.png" width="360" alt="General user interface for Assistant in Studio" />
-
-#### Quick Style
+### Generate Materials
 
 When given a request to generate a material, Assistant in Studio can quickly style existing parts through a lightweight implementation of the [Material Generator](../studio/material-generator.md).
 
-<img src="../assets/assistant/Studio-Quick-Styling-Material.png" width="360" alt="Material variations shown in Assistant for quick styling" />
-
-#### Insert Script
+<img src="../assets/assistant/Studio-Quick-Styling-Material.png" width="360" alt="Material variations shown in Assistant for quick styling." />
 
-If you enter a script generation request like _"Make the player's character jump when they touch this part,"_ Assistant will show the script's contents and add the new script instance to the currently selected object in the data model. If nothing is selected, Assistant will make the placement decision based on your prompts.
-
-<img src="../assets/assistant/Studio-Script-Insert.png" width="360" alt="Requested script inserted into selected part" />
-
-<Alert severity="info">
-At times, the generated script may not function flawlessly. In such cases, you can either make further edits in the [Script Editor](../studio/script-editor.md), or select the script snippet and ask Assistant to modify it.
-</Alert>
+## Accessing Assistant
 
-#### Explain Code
+Assistant is available in two locations: Studio and the documentation.
 
-If you enter a request to explain code and you have a code snippet selected in the [Script Editor](../studio/script-editor.md), Assistant explains what that selected snippet does.
-
-<img src="../assets/assistant/Studio-Explain-Code.png" width="360" alt="Code explanation provided by Assistant in Studio" />
-
-## Prompting Tips
-
-The following prompting tips enable Assistant to provide a more detailed and helpful response.
-
-### Context and Details
-
-The more context and examples you can provide in your prompts, the better. Instead of asking _"How can I design a core loop?"_ provide specific contextual examples, such as:
-
-<blockquote>
-
-_Help me design a fun core loop for my game. I want to build a game where players can hunt treasure as pirates. They can also buy and upgrade pirate ships and battle each other._
+### In Studio
 
-</blockquote>
+To access Assistant from Studio:
 
-### Multi-Step Prompts
+1. Click the **Assistant** button in the top-right corner.
 
-Consider using a multi-step prompt to encourage Assistant to think. Instead of simply asking _"Can you explain this script to me?"_ and pasting in the script, ask it to explain step-by-step by separating the question from the script with `###`. Doing so enables Assistant to deconstruct and organize the information clearly to provide better answers.
+   <img src="../assets/studio/general/Toolbar-Assistant.png" width="754" alt="Assistant button indicated in top-right area of toolbar." />
 
-<Tabs>
-<TabItem label="Prompt">
-<blockquote>
+2. Type a request into the field near the bottom of the window, using guidance from the [Prompt Guide](prompt-engineering.md) to generate improved responses.
 
-_Can you explain what this script is doing step by step?_
+   - Click thumbs up or thumbs down to rate the result and improve future results.
+   - Click the redo icon to process a new result.
 
-**\###**
+     <img src="../assets/assistant/Studio-General-UI.png" width="360" alt="General user interface for Assistant in Studio." />
 
-_local part = workspace.Part_
+### From the Documentation
 
-_local function onTouched(otherPart)_<br />
-&nbsp;&nbsp;&nbsp;&nbsp;_print(part.Name .. " collided with " .. otherPart.Name)_<br />
-_end_
+To access Assistant from the [documentation](/assistant):
 
-_part.Touched:Connect(onTouched)_
+1. In the upper navigation bar, click the **Assistant** button.
 
-**\###**
+   <img src="../assets/assistant/Documentation-Button.png" width="650" />
 
-</blockquote>
-</TabItem>
-<TabItem label="Assistant Response">
-<blockquote>
+1. Select a premade question or type your own. See the [Prompt Guide](prompt-engineering.md) for guidance on generating improved responses.
 
-_Certainly! This script is an example of how to handle collisions between two parts in Roblox. Let's break it down step by step:_
+   <img src="../assets/assistant/Documentation-Prompts.png" width="790" />
 
-1. `local part = workspace.Part`: _This line of code creates a local variable named `part` and assigns it the value of the `Part` object located in the workspace. You can replace `Part` with the name of the specific part you want to detect collisions with._
-2. `local function onTouched(otherPart)`: _This line of code defines a function named `onTouched` that takes in a parameter `otherPart`. This function will be called whenever the part collides with another part._
-3. `print(part.Name .. " collided with " .. otherPart.Name)`: _This line of code prints a message to the output console, indicating that the `part` has collided with `otherPart`. The `part.Name` and `otherPart.Name` are concatenated using the `..` operator to form the message._
-4. `part.Touched:Connect(onTouched)`: _This line of code connects the `onTouched` function to the `Touched` event of `part`. Whenever the part collides with another part, the `onTouched` function will be called._
+   - Click thumbs up or thumbs down to rate the result and improve future results.
+   - Click the redo icon to process a new result.
 
-</blockquote>
-</TabItem>
-</Tabs>
+     <img src="../assets/assistant/Documentation-Options.png" width="790" />

content/en-us/assets/studio/general/Controller-Emulator-VR.png

@@ -3,25 +3,15 @@ title: Assistant Prompt Guide and Examples
 description: Get tips and tricks on how best to prompt Roblox's AI Assistant to get the best results.
 ---
 
-Assistant in Roblox Studio accelerates content creation by helping you get started, supplementing your skills, and assisting with ongoing development.
+<Alert severity="success">
+[Share your prompts and experiences](https://devforum.roblox.com/t/check-out-the-generative-ai-stream-and-let-us-know-your-best-prompts/3215844) in the Roblox forum so that we can make Assistant better!
+</Alert>
 
-Assistant can:
+This document gives guidance on prompting Assistant and provides examples and inspiration on what Assistant can do.
 
-- Explain how to do things and how scripts work
-- Prototype and develop content quickly
-- Automate tedious tasks
-- Add 3D objects to your workspace
-- Add scripts to make things happen
+## Be Specific
 
-## Guidelines and Tips
-
-The following sections describe how to get the most out of the Assistant.
-
-### Be as specific as you can
-
-The more specific you are, the better Assistant can help you. Assistant might fail at fulfilling your request if you're not specific enough.
-
-If Assistant fails, add more details to your prompt and try again.  Use instance names exactly as they're spelled, specify which function you want Assistant to use, and tell Assistant what type it's working with, like a part or a model.
+If Assistant fails, add more details to your prompt and try again. Use instance names exactly as they're spelled, specify which function you want Assistant to use, and tell Assistant which type it's working with, such as a part or a model.
 
 <table>
   <tr>
@@ -36,26 +26,67 @@ If Assistant fails, add more details to your prompt and try again.  Use instance
     <td>Make the part move.</td>
     <td>Add a script to make "my_part" move up and down 10 studs repeatedly using TweenService.</td>
   </tr>
+  <tr>
+    <td>How can I design a core loop?</td>
+    <td>Help me design a fun core loop for my game. I want to build a game where players can hunt treasure as pirates. They can also buy and upgrade pirate ships and battle each other.</td>
+  </tr>
 </table>
 
-### Use your selection
+## Use Your Selection
 
-Selection is a great way of specifying an object or set of objects you want to refer to in your prompt. You can select multiple objects and ask Assistant to modify the selected objects, make duplicates and place them somewhere, or continue a position pattern like maintaining placement in a line.
+Selection is a great way of specifying an object or set of objects you want to refer to in your prompt. Select multiple objects and ask Assistant to modify them, make duplicates and place them somewhere, or continue a position pattern like maintaining placement in a line.
 
-### Edit time vs Run time
+## Edit Time and Run Time
 
-Assistant sometimes confuses the difference between edit time and run time. If you ask Assistant to take an action, it will likely bias towards doing it at edit time. If you want the action to happen during run time, ask Assistant to insert a script to the take action. For example, tell Assistant to "add a script to make the time of day 8am" instead of "make the time of day 8am".
+Assistant sometimes confuses the difference between edit time and run time. If you ask Assistant to take an action, it will likely bias towards doing it at edit time. If you want the action to happen during run time, ask Assistant to insert a script that takes the action. For example, tell Assistant "add a script to make the time of day 8:00 AM" instead of "make the time of day 8:00 AM."
 
-### Keep trying (with tweaks) and don't give up
+## Keep Trying
 
-Don't get discouraged if Assistant doesn't work exactly the way you want the first time. Often, making small tweaks and trying again can lead to better results. Many AI tools are non-deterministic, which means they don't create the exact same output each time you ask them to do something. There's natural variance, which you can tap into and control using tweaks to your prompt.
+Don't get discouraged if Assistant doesn't work exactly the way you want the first time. Often, making small tweaks and trying again can lead to better results. Many AI tools are non-deterministic, meaning they don't create the exact same output each time you ask them to do something. There's some variance, which you can tap into and control using tweaks to your prompt.
 
 AI in its current state requires work. It takes time to understand how to best speak to Assistant, what it can do, and how to get what you want out of it.
 
+## Multi-Step Prompts
+
+Consider using multi-step prompts to encourage Assistant to think. Instead of asking "Can you explain this script to me?" and pasting in the script, ask it to explain step-by-step by separating the question from the script with `###`. This separation helps Assistant deconstruct and organize the information to provide better answers.
+
+<Tabs>
+<TabItem label="Prompt">
+<blockquote>
+
+_Can you explain what this script is doing step by step?_
+
+**\###**
+
+_local part = workspace.Part_
+
+_local function onTouched(otherPart)_<br />
+&nbsp;&nbsp;&nbsp;&nbsp;_print(part.Name .. " collided with " .. otherPart.Name)_<br />
+_end_
+
+_part.Touched:Connect(onTouched)_
+
+**\###**
+
+</blockquote>
+</TabItem>
+<TabItem label="Assistant Response">
+<blockquote>
+
+_Certainly! This script is an example of how to handle collisions between two parts in Roblox. Let's break it down step by step:_
+
+1. `local part = workspace.Part`: _This line of code creates a local variable named `part` and assigns it the value of the `Part` object located in the workspace. You can replace `Part` with the name of the specific part you want to detect collisions with._
+2. `local function onTouched(otherPart)`: _This line of code defines a function named `onTouched` that takes in a parameter `otherPart`. This function will be called whenever the part collides with another part._
+3. `print(part.Name .. " collided with " .. otherPart.Name)`: _This line of code prints a message to the output console, indicating that the `part` has collided with `otherPart`. The `part.Name` and `otherPart.Name` are concatenated using the `..` operator to form the message._
+4. `part.Touched:Connect(onTouched)`: _This line of code connects the `onTouched` function to the `Touched` event of `part`. Whenever the part collides with another part, the `onTouched` function will be called._
+
+</blockquote>
+</TabItem>
+</Tabs>
+
 ## Examples
 
-These examples demonstrate the vast variety of tasks Assistant can help with today.
-Some of these examples might take a few tries for you to reproduce, but give them a try and see what you can come up with yourself.
+These examples demonstrate the vast variety of tasks that Assistant can help with today. Some of them might take a few tries for you to reproduce, but give them a try and see what you can come up with yourself.
 
 ### Game Mechanics - Shooting Fireballs that Explode
 
@@ -75,14 +106,14 @@ Add a script to make a system of teams (red, blue, green, yellow) and assign eac
 ### Game Mechanics - Temple Run Style Constant Running
 
 **Prompt:**
-Make my character run forward constantly like in a temple run game
+Make my character run forward constantly like in a temple run game.
 
 <video controls width="90%" src="/assets/assistant/prompt3.webm" />
 
 ### Game Mechanics - Fire Power Up
 
 **Prompt:**
-Add a script that makes the player light on fire and jump 3 time as high if they press "q". The fire should be attached to the player and move with them. If they press "q" again, turn off the fire and reset the jump power
+Add a script that makes the player light on fire and jump 3 time as high if they press "q". The fire should be attached to the player and move with them. If they press "q" again, turn off the fire and reset the jump power.
 
 <video controls width="90%" src="/assets/assistant/prompt4.webm" />