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
API Keys must be created by a workspace admin.
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
- Processing thousands of rows before testing small batches
- Vague or overly complex prompts