Build a chat app with Amazon Bedrock Studio

Open your Amazon Bedrock Studio workspace.

Make sure that you are in Build mode, by choosing Build at the top right of the page.

If this is the first time that you've opened the workspace, Amazon Bedrock Studio does the following:

For this procedure, choose Build chat app.

If you have previously open the workspace, do the following:

1. Create a new project by doing the following:

   1. If you are not on the All projects page, choose View all projects in the Projects dropdown list that is at the top of the page.

   2. On the All projects page, choose Create new project.

   3. In the Create new project section, enter Radio station project as the name for your project in Project name.

   4. For Project description, enter a description for your project.

   5. Choose Create. It might take a few minutes to create the project.

   6. In the card for your project, choose Go to project to open your project.

2. Open the navigation pane by choosing the menu ( ) at the top left of the page.

   

3. In App builder choose Chat to open the chat app that Bedrock Studio previously created for you.

   If you have previously used a different app, that app is shown. If you don't want to use that app, create a new app — On the project page, in the Apps section, choose Create app and then Chat app.

4. If the Welcome to build model dialog is shown, choose Build chat app.

In the Configs pane, choose the model that you want your app to use in Model.

In App name, enter Radio show as the name for your app.

For System prompt & examples, enter You are an app that creates 2 hour long playlists for a radio station that plays rock and pop music.

In the UI section, update the user interface for the app by doing the following:

1. In Hint text for empty chat enter Hi! I'm your radio show playlist creator.

2. In Hint text for user input enter Enter a prompt that describes the playlist that you want.

3. In Quick start prompts choose Edit.

4. Choose Reset to clear the list of quick start prompts

5. For Quick-start prompt 1, enter Create a playlist of 10 songs..

6. (Optional). Enter quick start prompts of your choice in the remaining quick start prompt text boxes.

Choose Save to save your app.

In the Quick start prompts section of the Preview pane, run the quick start prompt that you just created by choosing the prompt.

The app shows the prompt and the response from the model in the Preview pane.

In the prompt text box (the text should read Enter a prompt that describes the playlist that you want), enter Create a list of 10 songs where each song on the list is related to the next song, by musician, bands, or other connections. Be sure to explain the connection from one song to the next. Don’t repeat any artists..

Choose the run button (or press Ctrl + Enter on your keyboard) to send the prompt to the model.

Experiment with influencing the model response by changing the inference parameters in the Parameters section. For example, increase the randomness of the songs in the playlist by increasing the Temperature inference parameter.

The inference parameters you can change are Temperature, Top P, and Top K. Not all models support each of these inference parameters. For more information, see Influence model responses with inference parameters.

Choose Reset to clear the conversation.

For System prompt & examples, enter You are an app that creates 3 hour long playlists for a radio station that plays ambient music.. Doing this changes the system prompt to create a playlist of songs for a different genre of music and show length.

In the prompt text box, enter Create a list of 10 songs where each song on the list is related to the next song, by musician, bands, or other connections. Be sure to explain the connection from one song to the next. Don’t repeat any artists..

Choose the run button to send the prompt to the model. Note the response from the model now includes songs from the ambient genre of music.

Choose Save to save your app.

(Optional) Share your project with other by following the instructions at Share an Amazon Bedrock Studio project.

Next step: Add a guardrail to your app by following the instructions at Add a guardrail to your chat app.

Open your Amazon Bedrock Studio workspace.

Make sure that you are in Build mode, by choosing Build at the top right of the page.

Open the app that you created in Create an initial chat app.

In the Configs pane, choose Guardrails and then Create new guardrail.

For Guardrail name, enter prevent_unwanted_songs.

For Guardrail description, enter Prevents inappropriate songs..

In Content filters make sure Enable content filters is selected. For more information, see Content filters.

In Filter for prompts make sure the filter for each category is set to High.

Make sure Apply the same filters for responses is selected.

In Blocked messsaging do the following.

1. For Blocked messaging for prompts, enter Sorry, your prompt contained inappropriate text..

2. Clear Apply the same message for blocked responses.

3. For Blocked messaging for responses, enter Sorry, but I can't respond with information that contains inappropriate text..

Choose Create to create the guardrail.

In the Configs pane, make sure that the selected guardail in Guardrails is the guardrail you just created.

Test the guardrail by entering Create a list of 10 songs where each song has a swear word in the title. In the prompt edit box.

Choose the run button to send the prompt to the model. The model should respond with the message Sorry, but I can't respond with information that contains inappropriate text.

Use a denied topic filter to prevent requests for music from a specific music genere. For information about denied topics, see Denied topics.

To add the filter, do the following.

1. In the Guardrails section of the Configs pane, select the guardrail and choose Preview.

2. Choose Edit to edit the guardrail.

3. In Denied topics, choose Add topic.

4. For Name, enter heavy metal.

5. For Definition for topic, enter Avoid mentioning songs that are from the heavy metal genre of music..

6. For in Sample phrases - optional, enter Create a playlist of heavy metal songs.

7. Choose Add phrase.

8. Choose Save.

9. Om the Edit guardrail page, choose Update to update the guardrail.

10. Test the guardrail by entering Create a list of heavy metal songs. in the prompt edit box.

11. Choose the run button to send the prompt to the model. The model should respond with the message Sorry, but I can't respond with information that contains inappropriate text.

Next step: Add a data source to your app by following the instructions at Add a document data source to your chat app.

Create a CSV file name songs.csv and fill with the following ficticious CSV data.

song,artist,genre,length-seconds
"Celestial Odyssey","Starry Renegades","Cosmic Rock",240
"Neon Rapture","Synthwave Siren","Synthwave Pop",300
"Wordsmith Warriors","Lyrical Legions","Lyrical Flow",180
"Nebula Shredders","Galactic Axemen","Cosmic Rock",270
"Electro Euphoria","Neon Nomads","Synthwave Pop",210
"Rhythm Renegades","Percussive Pioneers","Lyrical Flow",240
"Stardust Rift","Cosmic Crusaders","Cosmic Rock",180
"Synthwave Serenade","Electro Enchanters","Synthwave Pop",300
"Lyrical Legends","Rhyme Royale","Lyrical Flow",240
"Supernova Shredders","Amplified Ascension","Cosmic Rock",300
"Celestial Chords","Ethereal Echoes","Cosmic Rock",240
"Neon Nirvana","Synthwave Sirens","Synthwave Pop",270
"Verbal Virtuoso","Lyrical Maestros","Lyrical Flow",210
"Cosmic Collision","Stellar Insurgents","Cosmic Rock",180
"Pop Paradox","Melodic Mavericks","Synthwave Pop",240
"Flow Fusion","Verbal Virtuosos","Lyrical Flow",300
"Shredding Shadows","Crimson Crusaders","Cosmic Rock",270
"Synth Serenade","Electro Enchanters","Synthwave Pop",180
"Wordsmith Warlords","Lyrical Legionnaires","Lyrical Flow",240
"Sonic Supernova","Amplified Ascension","Cosmic Rock",210
"Celestial Symphony","Ethereal Ensemble","Cosmic Rock",300
"Electro Euphoria","Neon Nomads","Synthwave Pop",180
"Lyrical Legends","Rhyme Royale","Lyrical Flow",270
"Crimson Crescendo","Scarlet Serenaders","Cosmic Rock",240
"Euphoric Tides","Melodic Mystics","Synthwave Pop",210
"Rhythm Renegades","Percussive Pioneers","Lyrical Flow",180
"Cosmic Collision","Stellar Insurgents","Cosmic Rock",300
"Stardust Serenade","Celestial Crooners","Synthwave Pop",240
"Wordsmith Warriors","Lyrical Legions","Lyrical Flow",270
"Sonic Supernova III","Amplified Ascension","Cosmic Rock",180

Open your Amazon Bedrock Studio workspace.

Make sure that you are in Build mode, by choosing Build at the top right of the page.

Open the app that you created in Create an initial chat app.

Disable any guardrails that you have enabled by choosing None selected in Guardrails.

For Data, choose Use single file only.

For Add data sources, choose Click to upload and upload the CSV file you created in step 1. Alternatively, add your source documents by dragging and dropping the CSV from your computer.

Test the data source by entering Create a playlist of songs in the Lyrical Flow genre in the prompt text box.

Choose the run button to send the prompt to the model. The model should respond with a playlist of songs from the Lyrical Flow genre that the CSV file contains.

Create a HTTPS server that implements a TopSongs function. Make sure the function adheres to the following schema.

openapi: 3.0.0
info:
  title: Top Songs API
  description: API to retrieve the top 10 songs played today
  version: 1.0.0

paths:
  /top-songs:
    get:
      summary: Get the top 10 songs played today
      description: >
        This endpoint returns an array of the top 10 songs played today,
        ordered by popularity. The first element in the array (index 0)
        represents the most popular song, and the last element (index 9)
        represents the 10th most popular song.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopSongs'

components:
  schemas:
    TopSongs:
      type: array
      items:
        $ref: '#/components/schemas/Song'
      description: >
        An array containing the top 10 songs played today. The first element
        (index 0) is the most popular song, and the last element (index 9)
        is the 10th most popular song.
      example:
        - title: 'Song Title 1'
          artist: 'Artist Name 1'
          album: 'Album Name 1'
        - title: 'Song Title 2'
          artist: 'Artist Name 2'
          album: 'Album Name 2'
        # ... up to 10 songs

    Song:
      type: object
      properties:
        title:
          type: string
          description: The title of the song
        artist:
          type: string
          description: The name of the artist or band
        album:
          type: string
          description: The name of the album the song is from
      required:
        - title
        - artist
        - album

Open your Amazon Bedrock Studio workspace.

Make sure that you are in Build mode, by choosing Build at the top right of the page.

Open the app that you created in Create an initial chat app.

In Models, choose a model that supports functions, such as Anthropic Claude 2.1.

In Functions, choose Create new function.

Alternatively, if you want to use a function that you have previously created, choose the function in the Functions dropdown list. You don't need to do the next step.

In the Create function pane, do the following.

1. For in Function name, enter Top_ten_songs_today.

2. For Function description (optional), enter Today's top 10 songs..

3. For Function schema, enter the OpenAPI schema from step one.

4. Choose Validate schema to validate the schema.

5. In Authentication method choose the authentication method for your HTTP server. For more information, see Authentication methods.

6. In API servers, enter the URL for your server in Server URL. This value is autopopulated if the server URL is in the schema.

7. Choose Create to create your function.

For System prompt and examples, update the system prompt so that it describes the function. Use the following text: You are an app that creates 2 hour long playlists for a radio station that plays rock and pop music. The function Top_ten_songs_today gets the most popular song played on the radio station..

Test the function by doing the following.

1. Enter What are today's top 10 songs? in the prompt edit box.

2. Choose the run button to send the prompt to the model. The model should respond with the list of today's top 10 songs.