Skip to main content
Frames v2 is in beta. Saved data and server functions require additional workspace access. Contact Ruby support through your usual support channel to request access.

What is a Frame?

A Frame is interactive content that an agent creates for you: a report, dashboard, presentation, calculator, or small app. It opens beside the conversation, responds to clicks and other input, and can be shared by link. Ask the agent to improve it later, and the same Frame continues to show the updated version.

Create a Frame

  1. Open Add capabilities in the Agent Builder.
  2. Select the Create Frames skill.
  3. Save the agent.
Then describe what you need. For example: Build a dashboard of last quarter’s sales by region, with a filter for product line. Give the agent your audience, preferred layout, and brand assets when those details matter.

Find and update your Frames

  • In a conversation: The Frame opens in a side panel. The folder icon lists the conversation’s other Frames.
  • In a Pod: Frames appear in the Pod’s Files tab. Pod editors can pin a Frame as the Pod banner or add it as a tab. See Frames in Pods.
To change a Frame, describe the edit in the conversation. If you need to undo an agent’s latest change, use Revert the last change in the Frame panel. You can also ask the agent to restore an earlier version.

Save data in a Frame

An interactive Frame can show charts and controls without storing what viewers enter. For a tracker, form, or other app that must retain changes, ask the agent to make its data persistent. This capability requires the additional Frames v2 functions access for your workspace. A Frame can have up to four databases, each with a 1 GiB size limit. It can also keep uploaded or generated files in its own persistent storage. A single function call can transfer up to 5 MB of file data. Data stored for a Frame remains available when the agent updates that Frame. For example, ask: Build a launch tracker where my team can add, assign, and close tasks. If you already have a Frame, ask the agent to add saved data to it.

Use tools and control access

With Frames v2 functions enabled, a Frame can call available workspace tools or external services through server functions. Tool approvals and personal authentication still apply. Tool calls from Frames are experimental and may change during beta. Only signed-in members of the owning workspace can use a Frame’s saved data and functions. Someone outside the workspace may be able to view a shared Frame, depending on its sharing settings, but cannot use its protected backend. For actions limited to an author or Pod editor, the Frame must enforce that restriction in its server function, not only hide the control in its interface.

Share and export

Use the Frame’s sharing settings to choose who can view it. Your workspace’s Frame sharing policy controls which options are available. People with access to a shared Frame see its latest version. To save a copy of a Frame, click Export at the top of the Frame (the download icon on mobile) and choose:
  • PDF: pick Portrait or Landscape.
  • PNG: an image of the Frame. This option doesn’t work for Frames that display images from external websites: choose PDF instead, or ask the agent to export the Frame as a PNG.
  • Source (.zip): all the Frame’s source files.
Export is also available when you open a Frame from a Pod’s Files tab. You can also ask the agent to export the Frame as a PDF or PNG.
Frames v2 is in beta. Features and limits may change. See the Frames overview for general guidance.