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

# @ruby Agent

## What is `@ruby` and how to use it?

`@ruby` is the general-purpose agent set up by default in every workspace. Mention it with `@ruby` in the composer to ask a question, or simply send a message without mentioning any agent: Ruby routes unmentioned messages to the workspace's default agent, which is `@ruby` unless an admin has configured a different one.

`@ruby` answers using all the Company Data your account has access to: the connected data sources, tools, and knowledge integrated into your workspace.

> [!NOTE]
>
> Default agents like `@ruby` are provided by Ruby and can't be edited through the Agent Builder. Workspace admins can only enable or disable them; their instructions and tools aren't customizable.

## When to use `@ruby`

Use `@ruby` as your starting point for:

* General questions about your company's internal documentation and connected data sources.
* Quick, single-turn requests that don't need a dedicated custom agent.
* Getting started with Ruby before building specialized agents for your team.

For questions that need extended, multi-step research across many sources, mention [`@deep-dive`](https://docs.ruby.ad/docs/user-documentation/agents/default-agents/deep-dive-agent) instead.

## Choosing a model

By default, `@ruby` runs on the auto-model level configured for your workspace. You can pick a different model for a single conversation from the model picker in the composer, without editing the agent. See [Auto models and the model picker](https://docs.ruby.ad/docs/user-documentation/agents/model-selection.md) for details.

## Admin control

Workspace admins can deactivate `@ruby`, like any other default agent, from workspace settings. If your workspace has `@ruby` disabled, the model picker and your other agents (including custom agents) remain available; an admin can re-enable `@ruby` at any time.


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