- If you choose to build an agent with no capability or knowledge: The agent uses only the model to generate an answer.
- If you build an agent with several capabilities: The agent evaluates the user request and deploys an appropriate combination of tools
- If you upload files: The agent evaluates the user request and, based on the file types, deploy an appropriate combination of dynamic tools
What tools can you choose from?
Default tools are already available in your Ruby workspace, they do not require any Data Source to run, and will augment your agents:
Tools can also perform actions in third-party platforms, based on Personal or Workspace credentials. These tools must be configured at the Admin level.
If a request needs a tool that isn’t connected, Ruby can show a tool setup card in chat. Workspace admins can configure the tool from that card. The Tools page also offers starter suggestions that open a new chat with a request ready to review and send.
| YouTube | Publish videos, manage playlists, captions and channel branding, and answer comments. | Personal or Workspace (Google account) |
| YouTube Analytics | Report on views, watch time, audience, retention and revenue; download bulk reports. | Personal or Workspace (Google account) |
| YouTube Live | Schedule and run broadcasts, moderate live chat and read Super Chats. | Personal or Workspace (Google account) |
| TikTok | Post videos and photos, send drafts to the TikTok app, and report on your account and videos. | Personal or Workspace (TikTok account) |
| TikTok Ads | Report on TikTok ads and manage campaigns, creatives, audiences and budgets. | Selected TikTok for Business ad accounts |
Meta tools are in preview and enabled per workspace by Ruby. See Meta overview for setup and access.
Tips & tricks to maximize capabilities’ performance
Here are the things you can check as you go through the agent building flow, fromInstructions to Tools & Knowledge:
Instructions screen
Clear and detailed instructions will ensure that your agent selects the appropriate tools for each situation. Consider describing potential scenarios your agent might encounter and specifying which action should be used in each case, even when it feels obvious. If you’ve enabled the Github connections and want to allow your agent to access the code:If someone asks you a question that requires understanding our internal codebase, you must search our internal codebase before answering.If you’ve enabled some Data sources tools and Websearch:
If someone asks you about information related to the company (i.e., information that is not public knowledge that you already know about, or that is available on the public internet), you must retrieve it from the internal data sources. If someone asks about general/public knowledge that might require information that is more recent than your knowledge cutoff date, it is very important that you execute a Google search first.If you’ve enabled the Browse action:
You may use your ‘Browse’ action to read the actual content of web pages to gain more information. It is usually a good idea to read content from several relevant pages before attempting to reply. You should browse several pages simultaneously.
Tools & Knowledge screen
Choose data sources judiciously for each action to ensure high-quality, relevant results, and provide a thorough description of the data you selected. The agent will provide better results if you carefully select the exact data it might need vs a large amount of data. For example if you’re working on a customer service related agent, you can add a “Search” action and select the Customer Service documentation from your Notion Connection, and describe the data as is:“This is the customer service documentation. Every thing here is the ground truth and this documentation is kept up to date. If you found some information here to answer a request, you can answer with confidence.”And then add another “Search” action and select your Intercom Connection to give it access to some specific categories of conversations, and say:
“This contains the closed Intercom conversations with your members. Keep in mind that especially if the conversation is old our process might have changed, and it concerns only a single member. The data in the Intercom notes are usually relevant, it’s usually that the customer service person asked help from a more experience colleague.”
What use cases do Capabilities support?
Here are a couple of examples of agents using multiple tools to execute complex tasks. You can start from scratch or from a template; Sidekick will guide the setup either way.Examples of agents using multiple tools
- @salesOutboundDraft an agent able to dig through internal documentation and browse the web for the latest news to help draft the perfect outreach email
- @postmortemDraft an agent that can parse through incident threads, extract key information and present it in a predefined template
Examples of Ruby Apps (deprecated)
Please refer to our Developer Platform overview if you want to learn more about Ruby Apps.- Creating Google Calendar events from a Ruby agent
- Allowing an agent to send an email
Overview
Tools in Ruby let your agents interact with services like GitHub, GitLab, and many more to come. Tool management is available to workspace administrators through the Spaces > Tools menu.Adding and configuring Tools
You can add predefined tools by doing the following :- Navigate to the Tools page in your workspace settings
- Click the ”+ Add Tools” button
- Select your desired tools from the available options
- Complete any required configuration:
Some tools need authentication credentials. You’ll have to login to the
external service.
Managing Access
By default, tools are workspace-wide and available to all users. You can control access in two ways: Workspace-wide tools (those in Company Space) won’t appear in individual spaces’ “Add Tools” dropdown, this is expected behavior. The tool IS accessible to all users; it doesn’t need to be added again. If you want a tool to be available only in specific spaces rather than workspace-wide:- First remove the tool from Company Space
- Then add it to the specific spaces where you want it available
Space-Based Restrictions
- Click the “Sharing” tab on any tool.
- Enable “Restricted Access”.
- Select which spaces can use the tool.
- Only members of those spaces will be able to use the tool.