Export your Amazon Bedrock Studio chat app - Amazon Bedrock Studio

Amazon Bedrock Studio, renamed to Amazon Bedrock IDE, is now available in Amazon SageMaker Unified Studio. Amazon Bedrock Studio will be available until February 28, 2025. You may access existing workspaces in this previous version through February 28, 2025, but you may not create new workspaces. To access the enhanced GA version of Amazon Bedrock Studio with additional features and capabilities, you can create a new Amazon SageMaker Unified Studio domain. To learn about Amazon Bedrock Studio IDE, see the documentation.

Export your Amazon Bedrock Studio chat app

Use the following procedure to export a chat app to a zip file. You can then use the chat app outside of the Amazon Bedrock Studio web app.

Depending on the composition of your app, the zip package contains some or all of the following files:

  • README.md — Instructions for deploying and running your app.

  • function-stack-*.json — AWS CloudFormation template that creates your function component, if any. This includes:

    • An AWS Lambda function for calling the API defined in your OpenAPI schema.

    • An AWS Secret Manager secret for storing credentials to use when calling your API. This secret contains an empty value, and you are expected to update this secret manually.

  • knowledge-base-stack-*.json — AWS CloudFormation template that creates your Knowledge Base data source, if any. This includes an Knowledge Base for Amazon Bedrock configured with your selected data store and vector store. This knowledge base will not have the data you have uploaded in to Bedrock Studio, and you are expected to provide data files manually.

  • guardrails-stack-*.json — AWS CloudFormation template that creates a guardrail for Amazon Bedrock, if any.

  • agent-stack.json — AWS CloudFormation template that creates an Amazon Bedrock Agent, if any.

  • invocation-policy-*.json — AWS CloudFormation template that creates an IAM policy with the runtime permissions that you need to talk to your deployed chat app.

  • br-studio-app-stack-*.json — Parent stack that orchestrates the deployment of all AWS CloudFormation stacks included in the zip package.

  • deploy-app.sh — Helper script that you use to deploy your app infrastructure into your AWS account.

  • code-snippet.mjs — Example code snippet that you embed in your code to invoke the app.

  • br-studio-app.mjs — Standalone Node.js module to quickly test your deployed app.

  • aoss-encryption-policy-*.json — AOSS encryption policy necessary to use a Knowledge Base. This encryption policy is automatically created when your chat app contains an Amazon Bedrock Studio Knowledge Base.

  • provisioning-inline-policy.json — An example of an AWS IAM policy that contains the permissions required to provision the chat app resources. The permissions declared in this policy file are needed when deploying the AWS CloudFormation stacks.

    You can modify this policy to better suit your needs. You may create a new IAM principal with these policies, or attach these policies to an existing IAM principal in your AWS account.

  • kms-key-policy.json — An example of an AWS KMS key policy that contains required permissions for encrypting your chat app resources.

    You can modify this key policy to better suit your needs. You may create a new KMS key with this policy, or attach this policy to an existing KMS key in your AWS account.

  • api-schema*.json — OpenAPI schema files associated with your function components, if any.

Important

  • If you encounter access errors when exporting your chat app, contact your administrator. Workspaces created before the release of the Amazon Bedrock Studio app export feature may be using an outdated permission boundary.

  • Amazon Bedrock Studio needs to update permissions for projects that you created before the release of the app export feature. Amazon Bedrock Studio updates a project when you first try to export an app from the project. The update takes a couple of minutes. After the update completes, you can then export the app.

  • Currently, you can't export apps that you created before June 15th, 2024. Support is coming soon.

To export a chat app

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

  2. In the Project dropdown list, choose the project that contains the app that you want to export.

  3. In the Recent apps section, choose the See all apps hyperlink.

  4. On the apps pane, select the name of the chat app that you want to export.

  5. If you haven't already, choose Save to save the app. You can't export an app unless you first save or test the app.

  6. On the app page, choose Export to export the app. Amazon Bedrock Studio will create and download a zip file with the name br-studio-app-export-*.zip.

  7. Next step: Deploy the chat app.