> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# Frames v2 (beta)

> Build interactive reports, dashboards, and small apps with Ruby agents.

> [!WARNING]
>
> 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](https://docs.ruby.ad/docs/user-documentation/pods/frames.md).

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.

> [!NOTE]
>
> Frames v2 is in beta. Features and limits may change. See the [Frames overview](https://docs.ruby.ad/docs/user-documentation/agents/frames/overview.md) for general guidance.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.