> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/built-in-agents/use.md).

# Use Official Built-in Agents

Choose an official built-in Agent from the Agent Marketplace, upload source material, clarify requirements, and receive downloadable output.

This page is for **all members**. It explains how to find the right official built-in Agent in the <mark style="color:blue;">Agent Marketplace</mark>, how to work with it, and who to contact if you run into an issue.

If you are an organization administrator deciding which Agents to make available to your team, see [Enable and Manage](/maiagent-user-guide/en/built-in-agents/management.md).

## How Official Built-in Agents Work <a href="#how-it-works" id="how-it-works"></a>

Every official built-in Agent follows the same workflow: **you provide source material and requirements, it asks follow-up questions until the details are clear, and then it produces the result.**

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-07d152d3b983893788a7fe0c4b07580ceaa777f8%2Fbuilt-in-agents-flow.png?alt=media" alt="Four-step workflow for official built-in Agents"><figcaption><p>The four-step workflow for official built-in Agents</p></figcaption></figure>

### 1. Follow the Greeting to Enter Your Task or Upload Files <a href="#step-input" id="step-input"></a>

When you start a conversation, the Agent first sends a **greeting** explaining what it can help with and what you need to provide. Follow its instructions: type a description of your request or upload files, such as contracts, résumés, reports, or meeting recordings, depending on the Agent.

### 2. The Agent Offers Options and Recommendations to Clarify the Output <a href="#step-clarify" id="step-clarify"></a>

The Agent does not immediately start working as soon as it receives your material. It asks about key decisions—for example, “How many years of experience should these interview questions target?” or “Should the report use bullets or prose?”—and **provides options directly**, so you can click one or add a short response.

At this stage, some Agents also **retrieve external information through connectors**, such as data from your calendar, cloud drive, or a third-party system. The first time a connector is used, you will be asked to authorize access.

{% hint style="info" %}
Do not skip this step. The extra 30 seconds you spend answering clarification questions directly improves the accuracy of the output.
{% endhint %}

### 3. Generate a Draft <a href="#step-draft" id="step-draft"></a>

Once the details are confirmed, the Agent generates the result. You can continue asking for changes in the conversation—adjust the tone, add sections, or change the structure—without starting over.

### 4. Choose Whether to Export to a Specific File Format <a href="#step-export" id="step-export"></a>

When you are satisfied with the draft, ask the Agent to export it as a file. Supported formats vary by Agent and commonly include Word, Excel, PDF, and presentation files. The generated file appears in the conversation for you to download.

## Choose an Agent from the Agent Marketplace <a href="#browse-marketplace" id="browse-marketplace"></a>

{% stepper %}
{% step %}

### Open the Agent Marketplace

After signing in, select <mark style="color:blue;">Agent Marketplace</mark> from the left sidebar.
{% endstep %}

{% step %}

### Switch to the “Official Built-in” Tab

At the top of the marketplace, switch from the <mark style="color:blue;">Organization-built</mark> tab to <mark style="color:blue;">Official Built-in</mark>.
{% endstep %}

{% step %}

### Search or Filter by Scenario Category

* **Search**: Use the search bar at the top to search by Agent name, description, or scenario keyword
* **Scenario categories**: Narrow the list using category tags such as Human Resources, Legal, Healthcare, or Manufacturing, or select <mark style="color:blue;">All Scenarios</mark> to see everything
  {% endstep %}
  {% endstepper %}

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-e7c5739da0ff636f3b10b32f29e6aee58903a598%2Fbuilt-in-agents-marketplace.png?alt=media" alt="Official Built-in tab in the Agent Marketplace"><figcaption><p>Agent Marketplace → Official Built-in: tabs and scenario categories appear at the top, with the enabled count in the upper-right corner</p></figcaption></figure>

Cards are divided into two sections:

| Section                                      | Meaning                                                                | Available on the Card                                                                                        |
| -------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| <mark style="color:blue;">Enabled</mark>     | Your organization has enabled the Agent, so you can use it immediately | <mark style="color:blue;">Preview</mark> and <mark style="color:blue;">Start Conversation</mark>             |
| <mark style="color:blue;">Not Enabled</mark> | Your organization has not enabled the Agent                            | <mark style="color:blue;">Preview</mark> only; no <mark style="color:blue;">Start Conversation</mark> option |

The upper-right corner of the page shows the number of Agents currently <mark style="color:blue;">Enabled</mark> by your organization and its limit. This allowance is managed by the organization administrator.

## Preview Before You Decide <a href="#preview" id="preview"></a>

Not sure what an Agent actually does? Select <mark style="color:blue;">Preview</mark> (the eye icon) in the upper-right corner of its card. **You can preview it without enabling it.**

The window is titled <mark style="color:blue;">Conversation × Guide Sync</mark> and plays two synchronized columns:

* **Left column**: Replays one <mark style="color:blue;">Example Scenario</mark>, from the greeting and the user's request through each step completed by the Agent
* **Right column—**<mark style="color:blue;">**Guide · What This Step Does**</mark>: As the conversation advances, the corresponding <mark style="color:blue;">STEP 01</mark>, <mark style="color:blue;">STEP 02</mark>, and so on is highlighted, explaining what happens and which capabilities are used

After playback finishes, the right column changes to <mark style="color:blue;">Guide · Select Each Step for Details</mark>. Select any step to expand it, or choose <mark style="color:blue;">Replay</mark> to watch again.

Two more details appear at the bottom of the window:

* <mark style="color:blue;">**Connectors**</mark>: The third-party services used by this Agent, such as Microsoft 365 or Google Workspace
* **Enablement status**: Agents that are not enabled display <mark style="color:blue;">Must Be Enabled by an Organization Administrator</mark>; enabled Agents offer <mark style="color:blue;">Start Conversation</mark>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-e6b437a8d9e5ce5053cc4b75af755c55a1bb2416%2Fbuilt-in-agents-preview.png?alt=media" alt="Preview window for an official built-in Agent"><figcaption><p>Preview window: the left column replays an example conversation while the right column highlights the corresponding guide step</p></figcaption></figure>

## Start a Conversation <a href="#start-conversation" id="start-conversation"></a>

Select <mark style="color:blue;">Start Conversation</mark> on a card in the <mark style="color:blue;">Enabled</mark> section to open a new conversation, then follow the four steps under [How Official Built-in Agents Work](#how-it-works).

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-e6c49722b3142666d8d3b41acf034df93873a6ae%2Fbuilt-in-agents-chat-greeting.png?alt=media" alt="Greeting from an official built-in Agent"><figcaption><p>Step 1: The greeting tells you exactly what to provide; use the paper clip in the lower-left corner to upload files</p></figcaption></figure>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-11c5c23f061ab5d1fcf6a0def45732f89557f53b%2Fbuilt-in-agents-chat-confirm.png?alt=media" alt="Agent asks follow-up questions to clarify details"><figcaption><p>Step 2: The Agent asks follow-up questions using option cards; the upper-right corner shows how many questions remain</p></figcaption></figure>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-9115e38c12d1c624667c4f206dc281aecdf77474%2Fbuilt-in-agents-chat-output.png?alt=media" alt="Draft generated by an Agent"><figcaption><p>Step 3: After confirming the details, the Agent generates a structured draft</p></figcaption></figure>

## Return to Recently Used Agents <a href="#recently-used" id="recently-used"></a>

After you have **had a conversation with at least one official built-in Agent**, a <mark style="color:blue;">Recently Used</mark> row appears at the top of the marketplace, ordered from most to least recent conversation. Select <mark style="color:blue;">Continue Conversation</mark> to resume your previous work without browsing through the categories again.

{% hint style="info" %}
This row includes only Agents that are **enabled** and that **you have personally used**. It is normal for the row not to appear when you have just joined an organization and have not started using any Agents.
{% endhint %}

## When an Official Built-in Agent Is Unavailable <a href="#unavailable-cases" id="unavailable-cases"></a>

These three situations look similar but have different causes:

| What You See                                                                                                                                                                                | What It Means                                                                                                        | What to Do                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| The Agent is in the <mark style="color:blue;">Not Enabled</mark> section and has <mark style="color:blue;">Preview</mark> but no <mark style="color:blue;">Start Conversation</mark> option | Your organization has not enabled this Agent                                                                         | Ask your organization administrator to enable it                                                                                   |
| The Agent is in the <mark style="color:blue;">Enabled</mark> section but displays <mark style="color:blue;">No Permission to Use</mark>                                                     | Your organization enabled it, but you are not in this Agent's <mark style="color:blue;">Authorized Users</mark> list | Ask your organization administrator to add your role/group to the authorized users                                                 |
| The <mark style="color:blue;">Official Built-in</mark> tab does not appear in the marketplace                                                                                               | Your plan does not include official built-in Agents                                                                  | Contact the sales team to upgrade your plan. See [Trial and Subscription Plans](/maiagent-user-guide/en/others/trial-and-plans.md) |

{% hint style="info" %}
If a search returns no results, select <mark style="color:blue;">Clear Search</mark> to view every Agent in the category, or select <mark style="color:blue;">Clear Selected</mark> to remove the category filter.
{% endhint %}

If a category has no enabled Agents, it displays <mark style="color:blue;">No Enabled Agents in This Category</mark> and a <mark style="color:blue;">Request Enablement</mark> button. This button takes you to [Built-in Agent Management](/maiagent-user-guide/en/built-in-agents/management.md), but an organization administrator with the required permission must still enable the Agent.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/built-in-agents/use.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.