> 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/work/built-in-agents/management.md).

# 有効化と管理

組織管理者が公式組み込み Agent を有効化し、公開対象やナレッジベースを設定する方法と、有効化数、クールダウン期間、無効化のルールをご説明します。

{% hint style="info" %}
このページは**組織管理者**向けです。一般メンバーの利用方法については、[公式組み込み Agent を使用する](/maiagent-user-guide/ja/work/built-in-agents/use.md)をご覧ください。
{% endhint %}

## 組み込み Agent 管理を開く <a href="#open-management" id="open-management"></a>

<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組み込み Agent 管理</mark>に進みます。

<mark style="color:blue;">Agent マーケットプレイス</mark>で<mark style="color:blue;">組み込み Agent 管理へ移動</mark>をクリックして直接開くこともできます。

{% hint style="warning" %}
メニューに<mark style="color:blue;">組み込み Agent 管理</mark>がない場合、組織のプランには公式組み込み Agent が含まれていません（画面には<mark style="color:blue;">現在のプランでは組み込み Agent を有効化できません。プランをアップグレードしてください</mark>と表示されます）。アップグレードについては営業チームへお問い合わせください。

ページは表示されてもスイッチがロックされている場合、有効化の管理権限がありません。組織管理者にお問い合わせください。
{% endhint %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-cff86351c877067619721d61899a925a50616b79%2Fbuilt-in-agents-management.png?alt=media" alt="組み込み Agent 管理ページ"><figcaption><p>組み込み Agent 管理：上部に有効化数と絞り込みがあります。各行のバージョンの後ろのカプセルは使用するモデルを示し、有効化済みの Agent の右側には操作アイコンと有効化スイッチが表示されます</p></figcaption></figure>

各行には Agent 名、利用シーン、バージョン、使用するモデル（バージョンの後ろのカプセル。詳しくは[モデルが未開放の場合は有効化できません](#model-availability)をご覧ください）、現在の<mark style="color:blue;">公開：{ロール名}</mark>が表示されます。無効化済みの場合は<mark style="color:blue;">無効化済み、ナレッジベースを保持</mark>、クールダウン中の場合は<mark style="color:blue;">クールダウン 残り N 日</mark>と表示されます。

Agent のステータスに応じて、行の右側に次の操作アイコンと有効化スイッチが表示されます。

| アイコン                                           | 用途                                       |
| ---------------------------------------------- | ---------------------------------------- |
| <mark style="color:blue;">公開対象を設定</mark>       | 利用できるロール／グループを指定します                      |
| <mark style="color:blue;">ナレッジベースを消去</mark>    | インポート済みのドキュメントと FAQ をすべて削除します（復元不可）      |
| <mark style="color:blue;">ナレッジベースをインポート</mark> | この Agent 専用のナレッジベースに移動してドキュメントをアップロードします |

上部ではキーワード検索のほか、ステータス（<mark style="color:blue;">すべて</mark> / <mark style="color:blue;">有効化済み</mark> / <mark style="color:blue;">未有効化</mark> / <mark style="color:blue;">ナレッジベースを保持</mark>）や利用シーンで絞り込めます。

{% hint style="info" %}
アイコン以外の行部分をクリックすると、その Agent の<mark style="color:blue;">プレビュー</mark>ウィンドウが開きます。実際の動作を確認してから有効化するかを判断できます。
{% endhint %}

## 有効化／無効化は「変更を適用」をクリックすると反映されます <a href="#apply-changes" id="apply-changes"></a>

{% hint style="warning" %}
スイッチを切り替えただけでは**すぐに反映されません**。すべての変更は保留状態になり、画面下部の<mark style="color:blue;">変更を適用</mark>をクリックすると一括で送信されます。
{% endhint %}

{% stepper %}
{% step %}

### 有効化／無効化する Agent のスイッチを切り替えます

一覧でスイッチを<mark style="color:blue;">有効化</mark>または<mark style="color:blue;">無効化</mark>に切り替えます。切り替えると、その行に<mark style="color:blue;">有効化待ち</mark>または<mark style="color:blue;">無効化待ち</mark>と表示されます。
{% endstep %}

{% step %}

### 画面下部の変更概要を確認します

画面下部には操作バーが固定表示されます。保留中の変更がある場合、<mark style="color:blue;">有効化待ち</mark>と<mark style="color:blue;">無効化待ち</mark>の件数、適用後の<mark style="color:blue;">有効化済み</mark>件数／上限、<mark style="color:blue;">有効化後 7 日間は無効化できません</mark>という注意事項が表示されます。この時点で<mark style="color:blue;">変更を適用</mark>をクリックできるようになります。
{% endstep %}

{% step %}

### 「変更を適用」をクリックします

<mark style="color:blue;">変更を適用</mark>をクリックして一括送信します。破棄する場合は<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-e311e13a5a971b5e98cbf5d01eaa4ffa66e9692a%2Fbuilt-in-agents-apply-changes.png?alt=media" alt="画面下部の変更適用操作バー"><figcaption><p>スイッチをオフにすると行に「無効化待ち」と表示され、画面下部にも件数とクールダウンの注意事項が表示されます</p></figcaption></figure>

適用後に一部の項目が失敗した場合は、上限到達、クールダウン中、権限不足などの理由が項目ごとに表示されます。成功した項目には影響しません。

## モデルが未開放の場合は有効化できません <a href="#model-availability" id="model-availability"></a>

公式組み込み Agent は、いずれも言語モデルを使用して動作します。一覧の各行のバージョンの後ろにあるカプセルには、その Agent が使用するモデルが表示されます。有効化済みの Agent には現在実際に使用しているモデル、未有効化の Agent には有効化後に使用するモデルが表示されます。このモデルが組織に開放されていないと、有効化後にメンバーが正常に対話できません。そのため、有効化する前にカプセルに表示されたモデルをご確認ください。

### 利用例 <a href="#model-availability-scenario" id="model-availability-scenario"></a>

組織管理者が、コンプライアンスチーム向けに<mark style="color:blue;">AML 疑わしい取引の届出書ドラフト作成</mark>を有効化しようとしています。<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組み込み Agent 管理</mark>で該当する行を見つけると、バージョンの後ろの白いカプセルに `Claude 4.8 Opus` と表示されており、このモデルが組織に開放されていることを確認できます。スイッチを有効にして<mark style="color:blue;">変更を適用</mark>をクリックし、続けて公開対象を設定すると、コンプライアンスチームはマーケットプレイスで対話を開始できます。対話を始めてからモデルが使えないと気づくことはありません。

### モデルが未開放の場合の画面表示 <a href="#model-unavailable-signals" id="model-unavailable-signals"></a>

Agent が使用するモデルが現在組織に開放されていない場合、管理ページでは次のように表示されます。

| 場所                   | 表示内容                                                                                                                                                      |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| その行のモデルのカプセル         | オレンジ色に変わり、ブランドアイコンが鍵アイコンに置き換わります。マウスを重ねると<mark style="color:blue;">このモデルは本組織に開放されていません。先にモデル設定で有効化してください</mark>と表示されます                                    |
| 未有効化の Agent の有効化スイッチ | スイッチがロックされて切り替えられません。マウスを重ねると同じく<mark style="color:blue;">このモデルは本組織に開放されていません。先にモデル設定で有効化してください</mark>と表示されます                                             |
| ページ上部                | オレンジ色の通知バーが表示されます。「**N 個の Agent** が使用するモデルが本組織に開放されていません。有効化する前に次のモデルを有効にしてください：」の後に有効にする必要があるモデル名が並び、右側に<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-a27265a445d43d9cc5b399ef5fe8968db4fc96f0%2Fbuilt-in-agents-management-model-locked.png?alt=media" alt="組み込み Agent 管理の 1 行：バージョンの後ろのモデルのカプセルがオレンジ色で、ブランドアイコンが鍵アイコンに置き換わり、右側の有効化スイッチはオフになっている"><figcaption><p>モデルが未開放の場合、モデルのカプセルがオレンジ色に変わってブランドアイコンの代わりに鍵アイコンが表示され、有効化スイッチは切り替えられません</p></figcaption></figure>

<mark style="color:blue;">モデル設定へ移動</mark>をクリックすると、[モデル利用権限](/maiagent-user-guide/ja/org/model-access.md)に移動します。組織オーナーがそのモデルを有効にした後、組み込み Agent 管理に戻ると、スイッチを通常どおり有効にできます。

{% hint style="info" %}

* 上部の通知バーは、現在の一覧にある「未有効化で、かつモデルが未開放」の Agent のみを集計します。キーワード検索や利用シーンでの絞り込みを行うと件数も変わりますが、ステータスの絞り込み（<mark style="color:blue;">有効化済み</mark> / <mark style="color:blue;">未有効化</mark> / <mark style="color:blue;">ナレッジベースを保持</mark>）を切り替えても影響を受けません。
* モデル利用権限ページでモデルが<mark style="color:blue;">未開通</mark>と表示される場合、MaiAgent が組織向けにまだ開通していません。組織側では有効にできないため、MaiAgent にお問い合わせください。
* スイッチが複数の理由でロックされている場合でも、表示されるのは 1 つだけです。優先順位は、有効化の管理権限なし → クールダウン中 → 有効化数が上限に到達 → モデル未開放の順です。
  {% endhint %}

### 有効化済み Agent のモデルが無効化された場合 <a href="#model-closed-after-activation" id="model-closed-after-activation"></a>

Agent の有効化後に、その Agent が使用するモデルが無効化された場合、該当する行のモデルのカプセルはオレンジ色の鍵アイコンに変わりますが、**有効化スイッチはロックされません**。通常のルールに従って無効化できます（この場合も[7 日間のクールダウン期間](#cooldown)が適用されます）。このような Agent は、ページ上部の通知バーの件数には含まれません。

元の状態に戻すには、組織オーナーが[モデル利用権限](/maiagent-user-guide/ja/org/model-access.md)でそのモデルを再度有効にしてください。

## 有効化数とクールダウン期間 <a href="#seats-and-cooldown" id="seats-and-cooldown"></a>

### 同時有効化数の上限 <a href="#seat-limit" id="seat-limit"></a>

ページ上部の<mark style="color:blue;">有効化数</mark>には、現在の利用数と上限が表示されます。上限はプランによって異なります。詳しくは[トライアルとサブスクリプションプラン · 機能の違い](/maiagent-user-guide/ja/others/trial-and-plans.md#feature-differences)をご覧ください。

上限に達すると、未有効化の Agent のスイッチがロックされ、<mark style="color:blue;">有効化数の上限に達しました。先に別の Agent を無効化するか、プランをアップグレードしてください</mark>と表示されます。

### 7 日間のクールダウン期間 <a href="#cooldown" id="cooldown"></a>

**Agent を有効化するたびに、その後 7 日間は無効化できません。** この期間中は一覧に<mark style="color:blue;">クールダウン 残り N 日</mark>と表示され、スイッチがロックされて<mark style="color:blue;">クールダウン中です。N 日後に無効化できます</mark>と案内されます。

{% hint style="info" %}
クールダウン期間は、**有効化するたびに最初から計算されます**。無効化後に再度有効化した場合も、無効化できるまで 7 日間待つ必要があります。

有効化する Agent を決める前に、[プレビュー](/maiagent-user-guide/ja/work/built-in-agents/use.md#preview)で適しているかをご確認ください。有効化後、短期間で別の Agent に変更することはできません。
{% endhint %}

### プランをダウングレードする場合 <a href="#downgrade" id="downgrade"></a>

{% hint style="warning" %}
現在有効化している数が**新しいプランの上限を超える**場合、プラン変更はシステムによってブロックされます。新しいプランの上限以下になるまで Agent を無効化してから、ダウングレードしてください。

無効化には 7 日間のクールダウン制限があるため、**ダウングレードを計画する際はクールダウン期間を考慮してください**。
{% endhint %}

## 無効化するとどうなるか <a href="#what-deactivation-does" id="what-deactivation-does"></a>

{% hint style="danger" %}
無効化は、**Agent を非表示にするだけではありません**。この Agent と対話チャネルがシステムから削除されます。

* <mark style="color:blue;">AI アシスタント</mark>一覧から消え、メンバーは対話できなくなります
* 対話チャネル（Web Chat など）とグループ権限も削除されます
* エージェントスケジュールの実行が停止します
* **インポート済みのナレッジベースは保持され**、<mark style="color:blue;">無効化済み、ナレッジベースを保持</mark>と表示されます
  {% endhint %}

後日再度有効化すると、公式の最新設計に基づいて**新しい Agent**が作成され、**元のナレッジベースに自動的に再接続されます**。ドキュメントを再度アップロードする必要はありません。ただし、無効化前の対話記録は新しい Agent には表示されません。

## 公開対象を設定する <a href="#group-permissions" id="group-permissions"></a>

**有効化しても、社内全員が利用できるわけではありません。** 有効化後、この Agent を利用できるロール／グループを指定する必要があります。

該当する行の<mark style="color:blue;">公開対象を設定</mark>をクリックし、ドロワーで利用可能なロール／グループにチェックを入れて<mark style="color:blue;">保存</mark>します。

* 設定済みの場合、一覧に<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-f1d800472e70407ee1380547361a828bf4658729%2Fbuilt-in-agents-group-permission.png?alt=media" alt="公開対象設定ドロワー"><figcaption><p>ドロワーで、この Agent を利用できるロール／グループにチェックを入れます</p></figcaption></figure>

{% hint style="info" %}
メンバーが<mark style="color:blue;">Agent マーケットプレイス</mark>で有効化済みの Agent を見たときに<mark style="color:blue;">利用権限がありません</mark>と表示される場合、そのメンバーは公開対象に含まれていません。このページで追加してください。
{% endhint %}

## 専用ナレッジベースをインポートする <a href="#knowledge-base" id="knowledge-base"></a>

公式組み込み Agent のロール指示とツールは変更できませんが、**組織独自のドキュメントを追加できます**。有効化済みの各 Agent には専用のナレッジベースがあります。

該当する行の<mark style="color:blue;">ナレッジベースをインポート</mark>をクリックすると、その Agent のナレッジベース設定ページに移動します。通常のナレッジベースと同じように、ドキュメントのアップロード、FAQ の作成、タグの設定を行えます。詳しくは[ナレッジベース総覧](/maiagent-user-guide/ja/build/knowledge-base/km.md)をご覧ください。

{% hint style="info" %}
たとえば「契約リスク審査」には自社の契約書テンプレートや審査基準を、「社内手続き Q\&A」には社内規程をインポートできます。これにより、公式 Agent の回答を実際の社内ルールに沿った内容にできます。
{% endhint %}

## ナレッジベースを消去する <a href="#purge-knowledge-base" id="purge-knowledge-base"></a>

該当する行の<mark style="color:blue;">ナレッジベースを消去</mark>をクリックすると、その Agent にインポート済みのドキュメントと FAQ をすべて削除できます。

{% hint style="danger" %}
**この操作では、インポート済みのすべてのドキュメントと FAQ が完全に削除され、復元できません。** 実行前に、ドキュメントと FAQ の内容が別の場所にバックアップされていることをご確認ください。

確認ウィンドウでも削除範囲が再度表示されます。バックアップが不完全な場合は、<mark style="color:blue;">キャンセル</mark>をクリックして既存の内容を保持してください。
{% endhint %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ca82fc1d27d4083dd5758ec879ef8698d3d7b68d%2Fbuilt-in-agent-purge-confirm-prod.png?alt=media" alt="ナレッジベース消去の確認ウィンドウ：インポート済みのすべてのドキュメントと FAQ が削除され、復元できないことを知らせ、下部にキャンセルと確定のボタンがある"><figcaption><p>消去する前に、ドキュメントと FAQ がバックアップされていることを確認してください。準備ができていない場合は「キャンセル」をクリックします。</p></figcaption></figure>

結果は Agent の現在のステータスによって異なります。

| Agent のステータス                                      | 消去後                                                                           |
| ------------------------------------------------- | ----------------------------------------------------------------------------- |
| <mark style="color:blue;">有効化済み</mark>            | ナレッジベースの**内容のみ**を削除します。ナレッジベース自体とこの Agent との関連付けは保持され、引き続き新しいドキュメントをインポートできます |
| <mark style="color:blue;">無効化済み、ナレッジベースを保持</mark> | **ナレッジベース全体が削除され、関連付けも解除されます**。後日再度有効化した場合は、新しい空のナレッジベースが作成されます               |

## コネクタ：事前設定が必要なもの <a href="#connectors" id="connectors"></a>

一部の公式組み込み Agent は、データを取得するために外部サービス（Google Workspace、Microsoft 365、Notion など）へ接続する必要があります。認証には次の 2 種類があり、カードに表示されます。

| 表示                                               | 意味                    | 対応者                              |
| ------------------------------------------------ | --------------------- | -------------------------------- |
| <mark style="color:blue;">管理者による事前接続設定が必要</mark> | 組織レベルの認証情報を使用するコネクタです | **組織管理者**が先に接続を設定すると、メンバーが利用できます |
| 上記表示なし                                           | ユーザー個人による認証です         | **各メンバー**が初回利用時に対話内で認証します        |

{% hint style="info" %} <mark style="color:blue;">管理者による事前接続設定が必要</mark>とは、各メンバーを個別に認証するという意味ではありません。組織レベルで一度だけ設定します。この表示がないコネクタは、各メンバーが自分のアカウントを個別に認証するため、管理者による対応は不要です。
{% endhint %}

詳しくは[コネクタ](/maiagent-user-guide/ja/work/maigpt/connectors.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/work/built-in-agents/management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.