Tutorial 3: AI Generation

AI Generation in Coppola is currently only available in Private Beta. If you're interested in the feature, contact us at [e-mail].

In the previous tutorial you authored behaviors by hand in Coppola. In this tutorial you will use our AI Assistance to add additional task methods to your project.

If you prefer to watch a video tutorial, follow the link for the video in the Resources section below this introduction. Each section of this tutorial is marked with time codes that correspond to the parts of the video that cover that section.

You can use the AI Assistance either to generate methods from scratch or to take behaviors and dialogue authored outside of Coppola and format it correctly. Let’s start by looking at that second use case.

Resources you'll need for this tutorial:

1. Coppola Account: Private Beta. For access please contact [e-mail]

2. Sample Script

3. Video Overview

4. Debugging Common Issues

If you have questions that are not answered by our documentation, join our Discord server and post in #support.

Script to Scene [0:00-1:28]

1. Open the sample script in the Resources section of this tutorial. This file contains a dialogue between two bar patrons. Copy the contents of the script.

2. Open Tutorial Project in your Coppola account.

3. Open the Bar Patron | Chit Chat task.

4. Click the blue Generate New Method button in the bottom right.

5. You will be prompted to describe the desired method. Paste the script contents into the window and click generate. The generate new method button will gray out as the generation process takes place. It might take a minute or so for the content to generate.

6. When generation completes, you will see a pop-up with your results for review. You can rename the method in the box at the top or reject the results if they are incorrect. If you like the way the new script looks, click Accept. Your new method will be added to the task.

Create from Scratch [1:29-2:48]

1. Click on the blue Generate New Method button. You will see a check box on the generation window allowing you to include your currently open method as important context in your next generation request. Uncheck it.

2. Delete your first prompt from the generation window and type: Chit chat between the bar patrons. One of the bar patrons is trying to cheer up the other. Click Generate.

3. Wait a minute for the generation to complete and then review the results. Your results will look different than what you see in the screenshot above. Click Accept.

4. Add one more method. Click Generate new Method and describe a new example of chit chat you’d like to see. In this tutorial, we used: Chit chat between the bar patrons. One of the patrons is trying to decide what to order.

5. Wait for your result, review, and accept to add it to the task.

Using Chit Chat as a Subtask [2:49-4:05]

Now we'll add the Chit Chat task as a subtask inside of the Socialize at Bar Task.

1. Click Back to Tasks in the upper left hand corner.

2. Find and open the Bar Patron | Socialize at Bar task.

3. Open the Order a Drink Method.

4. Click Add Step.

5. Change the step type to Subtask. Select the task Bar Patron | Chit Chat. You have a choice with the task parameters: if you keep the defaults either bar patron might get bound to barpatron1 in the Bar Patron | Chit Chat task. If you'd like to specify that the bar patron who goes to get a drink is the same barpatron who dreams about cockroaches, then you'll want to change default to barpatron under the barpatron task parameter drop down.

6. Click Save Changes. You’ll see the subtask added as the last step of your task.

7. Click the six dots on the left hand side of the step and drag your subtask up to be the first step in this task. Your task should now look like the screenshot at the top of this section.

Building and Running Your Domain [4:06-6:38]

1. Click Build Project in the upper right hand corner. Unzip the downloaded folder.

2. Open your Unreal project. In the Content Browser, navigate to Bitpart Archetypes → Tutorial. Look for the data asset called BDA_Tutorial. Open the data asset. In the data asset, select Import From JSON File and choose the JSON you just downloaded from Coppola. Save and close the data asset.

3. Open the data asset called BDS_Tutorial. In this asset, select Refresh Task List, save, and then close it.

4. In the Tutorial folder find and open the data table called DT_TutorialUtterances. As long as the new CSV you generated from Coppola is in the same location on your computer as the old one, clicking Reimport will refresh the table with your new utterances. If the CSV is in a new location, then go to the Data Table Details and point at the correct source file before reimporting. Save and close the table.

5. Right click on the data table asset in the content browser. Under Bitpart Actions, select Import Utterances. In the pop-up choose Tutorial Folder as the Target Folder then Import Utterances. Your existing data assets will now have the updated content.

6. Click play. You should your new socialize at bar task play out: one of your methods of chit chat followed by the drink ordering sequence.

Extra Credit

If you'd like to experiment more with AI Generation and Subtasks, try adding more variation to the Cockroach dream subtask.

1. In the Coppola webtool, go back to the main task list.

2. Click Create Task. Name the task Bar Patron | Deal with the Roaches and click create.

3. Click into your new task.

4. Create two role task parameters: one for each bar patron.

5. Create three prop_type task parameters: broom, broom_hook, rag.

6. Open the Dealing with the Roaches google doc. This document contains three different variations for how barpatron2 might respond to his friend's admission about the cockroach dream. Copy the four lines that make up the subtask variation 1 (beginning with the barpatron2 picking up the broom, and ending with him placing it back on the hook.)

7. Back in Coppola, click on the Generate New Method button at the bottom right hand corner of the Bar Patron | Deal with the Roaches task.

8. Paste your content in and click Generate. Wait for your result, review, and accept to add it to the task. If you get an error about unknown task parameters, refresh and try again.

9. Go back to the Dealing with the Roaches google doc. Copy the contents of subtask variation 2.

10. In Coppola, click Generate New Method. Delete your previous prompt and uncheck Include the Current Method in the Prompt. Paste the contents of subtask variation 2 in. Click Generate.

11. Repeat steps 9 and 10 to add the third and final subtask variation to this task.

12. Click Back to Tasks to return to the main task list.

13. Find and open the Bar Patron | Chit Chat task. Open the Cockroach Dream Method. The AI Generation automatically names the methods so your method may be named something slightly different.

14. Right click on line six and select Insert Step Above.

15. Select subtask → Bar Patron | Deal with the Roaches.

16. In this instance, we really care that there is consistency between the bar patrons in the parent task of chit chat and the deal with the roaches subtask. Under the Barpatron drop down change from default to Barpatron and under Barpatron_2 change from default to Barpatron_2.

17. Save changes.

18. The subtask will appear as the new line six of the task. Hover over line seven and click on the trash icon on the right hand side of the screen to delete the line.

19. Repeat the steps of building and running your domain described in the previous section. Now, when you run your scene, during the socialize at bar task you will see one of your three chit chat task variations play out and if the Cockroach dream is chosen you will see one of three variations for how the barpatrons resolve the conflict at the end of the task.