> 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/ja/built-in-agents/use.md).

# 公式組み込み Agent を使用する

Agent マーケットプレイスで公式組み込み Agent を選び、データのアップロード、追加確認、ダウンロード可能な成果物の取得までを行う方法をご紹介します。

このページでは、**すべてのメンバー**を対象に、<mark style="color:blue;">Agent マーケットプレイス</mark>で適切な公式組み込み Agent を見つける方法、Agent との作業方法、問題がある場合の問い合わせ先をご説明します。

組織管理者としてチームに提供する Agent を選ぶ場合は、[有効化と管理](/maiagent-user-guide/ja/built-in-agents/management.md)をご覧ください。

## 公式組み込み Agent の仕組み <a href="#how-it-works" id="how-it-works"></a>

どの公式組み込み Agent も、**素材と要件を提示すると、必要な詳細を確認してから成果物を作成する**という共通の流れで動作します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-07d152d3b983893788a7fe0c4b07580ceaa777f8%2Fbuilt-in-agents-flow.png?alt=media" alt="公式組み込み Agent の 4 ステップの作業フロー"><figcaption><p>公式組み込み Agent の 4 ステップの作業フロー</p></figcaption></figure>

### 1. 最初のメッセージに従い、作業内容を入力するかファイルをアップロードします <a href="#step-input" id="step-input"></a>

対話を開始すると、Agent はまず**最初のメッセージ**で、対応できることと必要な情報を案内します。その案内に従い、要件を直接入力するか、ファイル（契約書、履歴書、レポート、会議録音など。Agent によって異なります）をアップロードしてください。

### 2. Agent の選択肢や提案をもとに、出力の詳細を明確にします <a href="#step-clarify" id="step-clarify"></a>

Agent はデータを受け取ってすぐに作業を始めるのではなく、「この面接問題は何年の経験がある人を対象にしますか？」「レポートは箇条書きと文章のどちらにしますか？」など、重要な判断事項を確認します。**選択肢も提示される**ため、選択するか短い説明を追加するだけで回答できます。

一部の Agent は、この段階で**コネクタから外部情報を取得**します。たとえば、カレンダー、クラウドドライブ、外部システムのデータを読み取ります。初回利用時には認証が求められます。

{% hint style="info" %}
この手順は省略しないでください。確認に 30 秒ほどかけることで、出力の精度を高められます。
{% endhint %}

### 3. 草案を作成します <a href="#step-draft" id="step-draft"></a>

詳細の確認が終わると、Agent が成果物を作成します。対話内でそのまま、文体の変更、段落の追加、構成の変更などを依頼できます。最初からやり直す必要はありません。

### 4. 必要に応じて特定のファイル形式で出力します <a href="#step-export" id="step-export"></a>

草案に問題がなければ、Agent にファイル出力を依頼できます。対応形式は Agent によって異なりますが、一般的には Word、Excel、PDF、プレゼンテーションに対応しています。作成されたファイルは対話内に表示され、クリックしてダウンロードできます。

## Agent マーケットプレイスで選ぶ <a href="#browse-marketplace" id="browse-marketplace"></a>

{% stepper %}
{% step %}

### Agent マーケットプレイスを開きます

ログイン後、左側の<mark style="color:blue;">Agent マーケットプレイス</mark>をクリックします。
{% endstep %}

{% step %}

### 「公式組み込み」タブに切り替えます

マーケットプレイス上部には、<mark style="color:blue;">公式組み込み</mark>と<mark style="color:blue;">組織作成</mark>の 2 つのタブがあります。<mark style="color:blue;">公式組み込み</mark>を選択します。
{% endstep %}

{% step %}

### 検索または利用シーンで絞り込みます

* **検索**：上部の検索欄で Agent 名、説明、利用シーンのキーワードを検索できます
* **利用シーン**：分類タグ（人事、法務、医療、製造業など）で絞り込むか、<mark style="color:blue;">すべての利用シーン</mark>を選択して全件を表示します
  {% endstep %}
  {% endstepper %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-e7c5739da0ff636f3b10b32f29e6aee58903a598%2Fbuilt-in-agents-marketplace.png?alt=media" alt="Agent マーケットプレイスの公式組み込みタブ"><figcaption><p>Agent マーケットプレイス → 公式組み込み：上部にタブと利用シーン、右上に有効化数が表示されます</p></figcaption></figure>

カードは 2 つのエリアに分かれます。

| エリア                                    | 意味                  | カードに表示される項目                                                                             |
| -------------------------------------- | ------------------- | --------------------------------------------------------------------------------------- |
| <mark style="color:blue;">有効化済み</mark> | 組織で有効化されており、すぐに利用可能 | <mark style="color:blue;">プレビュー</mark>と<mark style="color:blue;">対話を開始</mark>           |
| <mark style="color:blue;">未有効化</mark>  | 組織でまだ有効化されていない      | <mark style="color:blue;">プレビュー</mark>のみ。<mark style="color:blue;">対話を開始</mark>は表示されません |

ページ右上には、組織で現在<mark style="color:blue;">有効化済み</mark>の Agent 数と上限が表示されます。この枠は組織管理者が管理します。

## 有効化する前にプレビューする <a href="#preview" id="preview"></a>

Agent で何ができるか分からない場合は、カード右上の<mark style="color:blue;">プレビュー</mark>（目のアイコン）をクリックしてください。**有効化しなくても確認できます**。

ウィンドウのタイトルは<mark style="color:blue;">対話 × ガイド同期</mark>で、左右 2 列が同時に進行します。

* **左列**：<mark style="color:blue;">デモシナリオの一例</mark>を再生します。最初のメッセージ、ユーザーの要件提示から、Agent が段階的に作業を完了するまでを確認できます
* **右列の**<mark style="color:blue;">**ガイド · このステップで行うこと**</mark>：対話の進行に合わせて、<mark style="color:blue;">STEP 01</mark>、<mark style="color:blue;">STEP 02</mark>などの該当ステップが強調表示され、作業内容と使用する機能を確認できます

再生終了後、右列は<mark style="color:blue;">ガイド · 各ステップをクリックして説明を表示</mark>に変わります。各ステップをクリックして詳細を確認でき、<mark style="color:blue;">もう一度再生</mark>をクリックすると再生し直せます。

ウィンドウ下部には次の情報も表示されます。

* <mark style="color:blue;">**コネクタ**</mark>：Agent が使用する外部サービス（Microsoft 365、Google Workspace など）
* **有効化ステータス**：未有効化の Agent には<mark style="color:blue;">組織管理者による有効化が必要</mark>と表示され、有効化済みの場合は<mark style="color:blue;">対話を開始</mark>できます

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-e6b437a8d9e5ce5053cc4b75af755c55a1bb2416%2Fbuilt-in-agents-preview.png?alt=media" alt="公式組み込み Agent のプレビューウィンドウ"><figcaption><p>プレビューウィンドウ：左列でデモ対話を再生し、右列で該当するガイド手順を強調表示します</p></figcaption></figure>

## 対話を開始する <a href="#start-conversation" id="start-conversation"></a>

<mark style="color:blue;">有効化済み</mark>のカードで<mark style="color:blue;">対話を開始</mark>をクリックすると、新しい対話が開きます。その後は、前述の[公式組み込み Agent の仕組み](#how-it-works)にある 4 つのステップに従います。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-e6c49722b3142666d8d3b41acf034df93873a6ae%2Fbuilt-in-agents-chat-greeting.png?alt=media" alt="公式組み込み Agent の最初のメッセージ"><figcaption><p>ステップ 1：最初のメッセージで必要な情報が案内されます。左下のクリップアイコンからファイルをアップロードできます</p></figcaption></figure>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-11c5c23f061ab5d1fcf6a0def45732f89557f53b%2Fbuilt-in-agents-chat-confirm.png?alt=media" alt="Agent が詳細を追加確認"><figcaption><p>ステップ 2：Agent が選択肢カードで詳細を確認し、右上に残りの質問数が表示されます</p></figcaption></figure>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9115e38c12d1c624667c4f206dc281aecdf77474%2Fbuilt-in-agents-chat-output.png?alt=media" alt="Agent が作成した草案"><figcaption><p>ステップ 3：詳細の確認後、Agent が構造化された草案を作成します</p></figcaption></figure>

## 最近使用した Agent に戻る <a href="#recently-used" id="recently-used"></a>

**少なくとも 1 つの公式組み込み Agent と対話した後**は、マーケットプレイス上部に<mark style="color:blue;">最近使用</mark>の行が追加され、最後に対話した日時の新しい順に表示されます。<mark style="color:blue;">対話を続ける</mark>をクリックすると前回の作業を再開でき、分類から探し直す必要はありません。

{% hint style="info" %}
この行には、**有効化済み**かつ**ご自身が対話したことのある** Agent のみが表示されます。組織に参加した直後など、まだ利用していない場合に表示されないのは正常です。
{% endhint %}

## 公式組み込み Agent を利用できない場合 <a href="#unavailable-cases" id="unavailable-cases"></a>

次の 3 つは似ていますが、それぞれ原因が異なります。

| 表示内容                                                                                                                                  | 意味                                                                      | 対応方法                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Agent が<mark style="color:blue;">未有効化</mark>エリアにあり、<mark style="color:blue;">プレビュー</mark>のみで<mark style="color:blue;">対話を開始</mark>がない | 組織でこの Agent が有効化されていません                                                 | 組織管理者に有効化を依頼してください                                                                                         |
| Agent が<mark style="color:blue;">有効化済み</mark>エリアにあるが、<mark style="color:blue;">利用権限がありません</mark>と表示される                                | 組織では有効化されていますが、この Agent の<mark style="color:blue;">公開対象</mark>に含まれていません | 組織管理者に、ロール／グループを公開対象へ追加するよう依頼してください                                                                        |
| マーケットプレイスに<mark style="color:blue;">公式組み込み</mark>タブがない                                                                                | 組織のプランに公式組み込み Agent が含まれていません                                           | アップグレードについて営業チームへお問い合わせください。[トライアルとサブスクリプションプラン](/maiagent-user-guide/ja/others/trial-and-plans.md)もご覧ください |

{% hint style="info" %}
検索結果がない場合は、<mark style="color:blue;">検索をクリア</mark>をクリックして分類内のすべての Agent を表示するか、<mark style="color:blue;">選択をクリア</mark>をクリックして分類の絞り込みを解除してください。
{% endhint %}

分類内に有効化済みの Agent が 1 つもない場合は、<mark style="color:blue;">この分類に有効化済みの Agent はありません</mark>と<mark style="color:blue;">有効化を申請</mark>ボタンが表示されます。このボタンをクリックすると、[組み込み Agent 管理](/maiagent-user-guide/ja/built-in-agents/management.md)ページに移動します。実際の有効化は、権限を持つ組織管理者が行う必要があります。


---

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