> ## 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.

# Google Sheets Add-on

> [!TIP]
>
> **The Ruby Google Sheets Add-on is officially available on Google Workspace
> Marketplace.** Connect Ruby to your spreadsheets in just a few clicks:
> Install from
> Marketplace

## About the Add-on

The Ruby Google Sheets Add-on lets you call your Ruby agents directly from your spreadsheets. Process data, analyze information, and automate tasks, all without leaving Google Sheets.

## Getting Started

### Step 1: Install the Add-on

From any spreadsheet, visit the Google Workspace Marketplace by navigating to **Extensions > Add-ons > Get add-ons**.

* Click **Install**
* Follow the authorization prompts
* Done! The add-on is now available in all your spreadsheets

### Step 2: Set up the connection

Navigate to **Extensions > Ruby > Setup**.

When prompted, fill in this information to connect the Add-on to your Ruby workspace:

**Workspace ID**

This information is found in your Ruby URL. Example: `https://app.app.ruby.ad/w/your-workspace-id/agent/new`. Copy the part after `/w/`.

**API Key**

In Ruby, navigate to **Admin > API Keys**:

* Click **Create an API Key**
* Copy and paste the generated key

> [!NOTE]
>
> API Keys must be created by a workspace admin.

**Region**

Region is optional: leave empty for US, or enter `eu` if you usually use Ruby on eu.ruby.ad.

## Using the Add-on

Select the cells you want to process, then click **Ruby > Call an Agent**.

Use the sidepanel to:

* Choose the agent that should answer the question
* Verify input range (or use "Use Selection")
* Specify target column (e.g., 'B')
* Add optional instructions
* Click **Run**

## Best Practices

**Do:**

* Start with small test batches
* Use clear, specific instructions
* Save templates for repeated tasks

**Avoid:**

* Processing thousands of rows before testing small batches
* Vague or overly complex prompts

### Performance & Limits

Agents must respond within 30 seconds. Keep queries concise and specific to avoid timeouts.


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