> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# エージェントのカスタマイズ

> デフォルトエージェントの会話スタイルやアクセス先を変更し、独自のエージェントを作成します。

5 つのデフォルトエージェントはすぐに使えます。カスタマイズにより、**会話スタイル**（トーン、ルール、言語）と**アクセス先**（接続）を変更できます。デフォルトでは不十分な場合、独自のエージェントを構築できます。

[Agents](https://app.cloudthinker.io/agents) を開いて始めましょう。左パネルでエージェントは **Core Team**（5 つのデフォルト）と **Custom**（独自のエージェント）にグループ分けされています。エージェントをクリックすると設定ダイアログが開き、2 つのタブ（**Identity**、**Connections**）が表示されます。パーソナリティ（Instructions、Language、Learning mode）は **Identity** タブの下部にあります。

<Note>
  エージェントのカスタマイズには**ワークスペース管理者**権限が必要です。メンバーはエージェントとチャットできますが、編集はできません。
</Note>

***

## 変更できること

| フィールド                               | デフォルトエージェント（Alex、Oliver、Tony、Kai、Anna） | カスタムエージェント       |
| ----------------------------------- | -------------------------------------- | ---------------- |
| @メンション                              | ロック済み                                  | 作成時に一度設定、後から変更不可 |
| 名前、役割、目標                            | ロック済み                                  | 編集可              |
| Instructions、Language、Learning mode | 編集可                                    | 編集可              |
| Connections                         | 追加 / 削除（Anna は読み取り専用 — 他エージェントから継承）    | 追加 / 削除          |
| アクティブ状態                             | 自動 — 接続がない場合はオフ（Anna は常時オン）            | 手動               |

デフォルトエージェントは専門タスク（クラウド、セキュリティ、データベース、Kubernetes、コーディネーション担当の Anna）向けに最適化済みです。チューニングが失われないようアイデンティティはロックされています — ワークフローに合わせて **Instructions**、**Language**、**Learning mode**、**Connections** は引き続き調整できます。

***

## プランティア

デフォルトエージェントの編集は**すべてのプラン**で利用できます。変わるのはカスタムエージェントの数だけです。

| プラン        | カスタムエージェント数 |
| ---------- | ----------- |
| Free       | 1           |
| Team       | 5           |
| Scale      | 10          |
| Scale +    | 10          |
| Enterprise | 無制限         |

上限に達した場合は、未使用のエージェントを削除するか[プランをアップグレード](/ja/guide/billing/pricing)してください。

***

## カスタムエージェントを作成する

デフォルトでカバーされていないもの — 請求アナリスト、オンコールサマライザー、ドキュメント専門家 — が必要ですか？独自のエージェントを構築しましょう。

[Agents](https://app.cloudthinker.io/agents) ページの **Custom** の横にある **+** をクリックし、作成方法を選択します。

<Tabs>
  <Tab title="AI で作成">
    **エージェントに何をさせたいかはわかっているが**、すべてのフィールドを自分で入力したくない場合に最適です。

    1 文で何が必要かを説明すると、Anna が引き継ぎます。通常、Anna は以下を確認します：

    * **名前と @メンション** — 説明に基づいて選択肢を提案します。
    * **役割と目標** — 両方の下書きを作成し、承認または微調整できます。
    * **モデルティア** — タスクの複雑さに基づいて Light / Pro / Ultra を推奨します。
    * **Instructions** — 最初の下書きを生成し、後から洗練できます。
    * **Connections** — どれを接続するかを尋ねます（クラウド、データベース、K8s、MCP）。
    * **Learning mode** — Auto または Offer。

    プロンプト例：*「AWS の支出を監視し、日次コストが 20% 以上跳ね上がったときに通知するエージェントが必要です。」*

    その後、エージェントの設定ダイアログから任意のフィールドを編集できます。
  </Tab>

  <Tab title="手動で作成">
    最初からすべてのフィールドを完全に制御したい場合に最適です。ダイアログは 3 つのステップを案内します。ヘッダーには現在のプランのカスタムエージェントクォータが表示されます（例：Scale では「カスタムエージェント 10 のうち 1 使用済み」）。

    <Steps>
      <Step title="Identity">
        * **アバター** — タイルをクリックして変更します（デフォルトはグラデーション上のイニシャル）。
        * **名前** — 例：「Cost Guardian」。
        * **@メンション** — チャットハンドル（例：`@cost-guardian`）。一意である必要があり、`@alex`、`@oliver`、`@tony`、`@kai`、`@anna` は再利用不可。**一度設定すると後から変更不可。**
        * **役割** — 短いタイトル（例：「FinOps Specialist」）。
        * **目標** — このエージェントが何をするかの 1 文。

        **Next** をクリックします。

        <Frame>
          <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/create-custom-agent-dialog-1.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=4ebff25696c53485fb958b013d81461e" alt="カスタムエージェント作成ウィザード、ステップ 1 Identity — アバタータイル、名前、@メンション、役割、目標フィールド" style={{ maxWidth: '400px' }} width="1064" height="1408" data-path="images/agents/create-custom-agent-dialog-1.png" />
        </Frame>
      </Step>

      <Step title="Configuration">
        * **モデルティア** — **Light**（高速、最低クレジットコスト）、**Pro**（バランス型）、**Ultra**（最大性能、最高クレジットコスト）から選択します。現在のクレジット乗数については[料金](/ja/guide/billing/pricing)をご覧ください。
        * **Instructions** — エージェントの振る舞いを記述するテキストエリア：何に集中するか、どのように応答するか、何を避けるか。平易な文章で記述 — ガイドライン、制約、トーン、応答フォーマットすべてをここに記載します。
        * **Language** — 返答言語。
        * **Learning mode** — **Auto** は新しいスキルを自動保存、**Offer** は保存前に確認します。

        **Next** をクリックします。

        <Frame>
          <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/create-custom-agent-dialog-2.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=552c149b155a128882a008db96f0ae99" alt="カスタムエージェント作成ウィザード、ステップ 2 Configuration — モデルティア、Instructions、Language、Learning mode" style={{ maxWidth: '400px' }} width="1002" height="1462" data-path="images/agents/create-custom-agent-dialog-2.png" />
        </Frame>
      </Step>

      <Step title="Connect">
        省略可能。**Builtin** と **MCP** タブを使って、このエージェントがアクセスできる接続を選択します。後からエージェント設定で追加することもできます。

        **Skip and Create** をクリックして完了します。

        <Frame>
          <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/create-custom-agent-dialog-3.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=826b24cfbf405f20e6aebe0dab61fe1a" alt="カスタムエージェント作成ウィザード、ステップ 3 Connect — Builtin と MCP タブおよび接続追加リスト" style={{ maxWidth: '500px' }} width="1010" height="932" data-path="images/agents/create-custom-agent-dialog-3.png" />
        </Frame>
      </Step>
    </Steps>

    エージェントは **Custom** の下に表示され、チャットで @メンションハンドルから呼び出せます。
  </Tab>
</Tabs>

***

## デフォルトエージェントを編集する

トーン、ルール、言語などを変更します。エージェントのアイデンティティ（名前、@メンション、役割、目標）は変わりません — 変わるのは話し方と振る舞いだけです。

<Steps>
  <Step title="エージェントを開く">
    [Agents](https://app.cloudthinker.io/agents) に移動し、**Core Team** のエージェントをクリックします。ダイアログが **Identity** タブで開きます。
  </Step>

  <Step title="編集可能なフィールドを編集する">
    **Identity** タブで、名前、役割、目標は「CloudThinker により設定済み、変更不可」というヒントとともにロックされています。@メンションには「一度設定、後から変更不可」と表示されます。同じタブをスクロールして以下を編集します：

    * **Instructions** — ハウスルール、ハードリミット、トーン、応答フォーマットのテキストエリア。平易な文章で記述します（例：*「簡潔な箇条書きで返答すること。書き込みアクセスが必要な変更は提案しないこと。\$500 を超える異常はエスカレートすること。」*）。
    * **Language** — 返答言語。
    * **Learning mode** — **Auto** は新しいスキルを自動保存、**Offer** は保存前に確認します。
  </Step>

  <Step title="保存する">
    右下の **Save** をクリックします。変更は次のメッセージから適用されます。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/customize-agent-dialog.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=96a5b8a2e737a3f4fa2dec77f6374926" alt="エージェント設定ダイアログ — Identity と Connections タブ、ロックされた名前/@メンション/役割/目標フィールド、Identity タブ下部の編集可能な Instructions/Language/Learning mode" width="2698" height="1366" data-path="images/agents/customize-agent-dialog.png" />
</Frame>

***

## 接続を追加する

接続はエージェントがクラウド、データベース、Kubernetes、MCP サーバーにアクセスするための手段です。Alex、Oliver、Tony、Kai は接続なしで開始します — 各エージェントが何にアクセスできるかはあなたが決めます。

<Steps>
  <Step title="Connections タブを開く">
    エージェントダイアログから **Connections** をクリックします。ヘッダーに接続数が表示されます（例：「3 connections」）。
  </Step>

  <Step title="Builtin または MCP を選択する">
    サブタブを使って **Builtin**（クラウド、データベース、Kubernetes）と **MCP** を切り替えます。
  </Step>

  <Step title="追加または削除する">
    **Add** をクリックして追加、**Remove** をクリックして削除します。Save で適用します。
  </Step>
</Steps>

<Note>
  **接続のないデフォルトエージェントは自動的にオフになります**。有効にするには少なくとも 1 つの接続を追加してください。
</Note>

<Warning>
  **Anna の接続は自動管理されます。** Anna は他のエージェントをコーディネートし、そのアクセス先を継承するため、Anna の Connections タブは読み取り専用です。代わりに Alex、Oliver、Tony、Kai に接続を追加してください。
</Warning>

***

## 使用例

| やりたいこと                               | 実施方法                                                                             |
| ------------------------------------ | -------------------------------------------------------------------------------- |
| Tony がベトナム語で厳密な SQL フォーマットで返答するようにする | **Language** をベトナム語に設定し、Instructions に追加：*「SQL はキーワードを大文字にして、1 行に 1 句ずつ記述すること。」* |
| Oliver が推奨のみ行い、変更を加えないようにする          | Instructions に追加：*「推奨のみ — 書き込みアクセスが必要な変更は提案しないこと。」*                              |
| Alex がコストを EUR で報告し、週次ダイジェストを送るようにする | Instructions に追加：*「コストを EUR で報告すること。週次で支出をまとめること。」* クラウド接続を追加します。                |

***

## 注意事項

* 編集は**次の**メッセージから適用されます — 進行中のチャットは古い設定で完了します。
* カスタムエージェントの @メンションは慎重に選んでください — 一度設定したら変更できません。

***

## 次のステップ

<CardGroup cols={2}>
  <Card title="接続のセットアップ" icon="plug" href="/ja/guide/connections/overview">
    クラウド、データベース、Kubernetes、MCP 接続を設定する
  </Card>

  <Card title="デフォルトエージェントを知る" icon="robot" href="/ja/guide/agents">
    Alex、Oliver、Tony、Kai、Anna のプロファイル
  </Card>

  <Card title="カスタム Skills" icon="brain" href="/ja/guide/skills/custom-skills">
    任意のエージェントにドメイン知識を追加する
  </Card>

  <Card title="CloudThinker language" icon="code" href="/ja/guide/language">
    `@agent #tool` メンション構文
  </Card>
</CardGroup>
