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

# AI エージェント

> CloudThinker の 5 つの専門エージェントを紹介し、コスト、セキュリティ、データベース、Kubernetes の各作業に適したエージェントを選ぶ方法を説明します

CloudThinker は、クラウド環境全体を分析、レポート、操作する 5 つの専門エージェントを備えています。各エージェントはドメインを担当し、インフラの永続的なメモリを保持し、クロスドメインの作業では他のエージェントと連携します。

## エージェント一覧

| エージェント                                | ロール              | 得意な作業                                             |
| ------------------------------------- | ---------------- | ------------------------------------------------- |
| [**Alex**](/ja/guide/agents/alex)     | クラウドエンジニア        | コスト分析、インフラ最適化、マルチクラウドアーキテクチャ、予約キャパシティ             |
| [**Oliver**](/ja/guide/agents/oliver) | セキュリティエンジニア      | コンプライアンス監査、脆弱性評価、IAM レビュー、脅威検出                    |
| [**Tony**](/ja/guide/agents/tony)     | データベースエンジニア      | クエリ最適化、パフォーマンスチューニング、インデックス推奨、キャパシティプランニング        |
| [**Kai**](/ja/guide/agents/kai)       | Kubernetes エンジニア | クラスターヘルス、ポッドの適正サイズ化、オートスケーリング、RBAC 監査、トラブルシューティング |
| [**Anna**](/ja/guide/agents/anna)     | ゼネラルマネージャー       | マルチエージェント調整、クロスドメインプロジェクト、エグゼクティブレポート             |

トーンの変更、アクセス制限、または完全なカスタムエージェントが必要な場合は [エージェントのカスタマイズ](/ja/guide/agents/customize) をご覧ください。

## 適切なエージェントを選ぶ

| 必要な作業                   | 使うエージェント  |
| ----------------------- | --------- |
| クラウドコストが高すぎる            | `@alex`   |
| セキュリティ監査またはコンプライアンスレポート | `@oliver` |
| 遅いデータベースの診断             | `@tony`   |
| Kubernetes クラスターの問題解決   | `@kai`    |
| 複数のドメインにまたがる問題          | `@anna`   |
| どこから始めればいいかわからない        | `@anna`   |

Anna は他のエージェントに作業を割り振るため、インシデント調査やクロスドメインプロジェクトの安全なデフォルトとして機能します。

## エージェントと話す

エージェントには平易な言葉で話しかけてください。基本的なパターンは次のとおりです。

```text theme={null}
@agent #tool your request
```

* **`@agent`** — 担当エージェント: `@alex`（クラウド）、`@oliver`（セキュリティ）、`@tony`（データベース）、`@kai`（Kubernetes）、`@anna`（調整）。
* **`#tool`** *（省略可能）* — 出力の種類: `#dashboard`、`#report`、`#recommend`、`#alert`、`#chart`、`#kb`。
* **リクエスト内容** — 必要なことを自分の言葉で記述します。文脈情報はインラインで追記できます。

構文の詳細については、[CloudThinker 言語リファレンス](/ja/guide/language) を参照してください。

```text theme={null}
@alex #dashboard build an EC2 cost dashboard for the last 30 days
@oliver #report audit security groups open to the internet on ports 22, 3306, and 5432
@anna #report run a quarterly infrastructure review across cost, security, and Kubernetes
```

## エージェントの仕組み

1. **プロンプトを読む** — エージェントがメンション、オプションのツールタグ、指示を解析します。
2. **接続を照会する** — エージェントが設定した [接続](/ja/guide/connections/overview) (AWS、Azure、GCP、Kubernetes クラスター、データベースなど) を読み取ります。
3. **ソース間でデータを照合する** — Alex が CloudWatch の使用率と Cost Explorer のデータを相互参照し、Tony がクエリの頻度とともに実行計画を読み取ります。
4. **要求された出力を提供する** — ダッシュボード、レポート、優先順位付きの推奨事項、またはアラートを返します。
5. **自律モードの範囲内で行動する** — Manual モードではエージェントが変更を実行する前に [承認](/ja/guide/approval) を待ちます。すべてのアクションは監査証跡とともに記録されます。

## 自律性

各エージェントはエージェントごとに設定可能な 2 つのモードのいずれかで動作します:

| モード            | 動作                               |
| -------------- | -------------------------------- |
| **Manual**（手動） | エージェントがアクションを提案し、実行前に人間の承認を待ちます。 |
| **Auto**（自動）   | エージェントが自律的にアクションを実行し、結果を報告します。   |

Auto 実行のスコープ、ガード、監査の方法については [Auto Mode](/ja/guide/auto-mode) をご覧ください。

## メモリとコンテキスト

エージェントは環境について学習した内容を保持するため、時間の経過とともに精度が向上します:

| メモリの種類  | 保持する内容                                            |
| ------- | ------------------------------------------------- |
| エピソード   | 過去の分析と決定 (推奨事項から除外したリソースなど)                       |
| ワーキング   | 現在の会話スレッド内のコンテキスト                                 |
| セマンティック | 時間をかけてインフラについて学習したパターン                            |
| ファイル    | ドキュメント、ランブック、[ナレッジベース](/ja/guide/knowledge) のエントリ |

## エージェントが有効になるタイミング

エージェントは関連する接続を追加すると利用可能になります:

| エージェント     | 有効になる条件                                  |
| ---------- | ---------------------------------------- |
| **Anna**   | 常時 — 接続不要                                |
| **Alex**   | AWS、Azure、または GCP 接続が追加されたとき             |
| **Oliver** | AWS、Azure、または GCP 接続が追加されたとき             |
| **Tony**   | PostgreSQL、MySQL、またはその他のデータベース接続が追加されたとき |
| **Kai**    | Kubernetes クラスター接続が追加されたとき               |

## 次のステップ

<CardGroup cols={2}>
  <Card title="エージェントをカスタマイズする" icon="wand-magic-sparkles" href="/ja/guide/agents/customize">
    パーソナリティを調整し、接続をアタッチし、完全なカスタムエージェントを構築する
  </Card>

  <Card title="CloudThinker Language" icon="code" href="/ja/guide/language">
    `@agent #tool instruction` 構文の完全なリファレンス
  </Card>

  <Card title="接続をセットアップする" icon="plug" href="/ja/guide/connections/overview">
    クラウドプロバイダー、データベース、Kubernetes クラスターを接続する
  </Card>

  <Card title="Auto Mode" icon="bolt" href="/ja/guide/auto-mode">
    自律実行のスコープと監査の仕組みを理解する
  </Card>
</CardGroup>