Google Cloud

GCPプロジェクトを接続して、CloudThinkerエージェントがコスト分析、リソース最適化、セキュリティ監査、Google Cloudサービス全体のインフラ管理を実行できるようにします。 GCPの認証はサービスアカウントキー（JSONファイル）で行います。サービスアカウントのIAMロールが各エージェントのアクセス範囲を決定します。

前提条件

IAM管理者アクセス権を持つGCPプロジェクト。
プロジェクト内でサービスアカウントを作成しIAMロールを割り当てる権限。
ブラウザでGoogle Cloud Consoleへのアクセス。

ビューアーレベルのサービスアカウントで、コスト分析、セキュリティ監査、リソース検査が可能です。書き込み機能が必要な場合にのみロールを拡張してください。

セットアップ

サービスアカウントを作成

Google Cloud Consoleでプロジェクトを選択し、IAM & Admin → Service accounts に移動します。Create Service Account をクリックして次の情報を入力します：

名前：cloudthinker-readonly
説明：CloudThinker監視用の読み取り専用アクセス

ロールを割り当て

必要なビューアーロールを付与します：

Viewer（基本的な読み取りアクセス）
Monitoring Viewer（監視データ用）
Security Reviewer（セキュリティ分析用）

JSONキーを生成

リストから作成したサービスアカウントをクリックし、Keys タブ → Add key → Create new key に移動します。JSON 形式を選択して Create をクリックします。キーファイルをダウンロードして安全に保管してください。

CloudThinkerに接続を追加

Connections → GCP に移動してJSONキーファイルをアップロード（またはその内容を貼り付け）します。Connect をクリックします。CloudThinkerが認証情報を確認し、Connected ステータスに変わります。

JSONキーファイルは安全に保管してください。バージョン管理システムにコミットしたり、公開したりしないでください。

マルチプロジェクトのセットアップ

複数のGCPプロジェクトを持つ組織向け：

組織レベルのアクセスを付与

サービスアカウントに組織またはフォルダレベルでロールを付与し、すべてのターゲットプロジェクトにアクセスできるようにします。

請求アカウントのアクセスを追加

クロスプロジェクトのコスト分析のために Billing Account Viewer を追加します。

プロジェクトを追加

接続後、CloudThinkerはアクセス可能なプロジェクトを自動的に検出します。

接続詳細

フィールド	説明	例
サービスアカウントキー（JSON）	接続ダイアログにアップロードまたは貼り付けるGCPサービスアカウントキーのJSON全体	`{"type": "service_account", "project_id": "your-project-id", ...}`

キーファイルには次の構造が含まれます：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "cloudthinker-readonly@your-project.iam.gserviceaccount.com",
  "client_id": "123456789012345678901",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token"
}

必要な権限

最小（読み取り専用分析）

roles/viewer                    # Basic read access
roles/monitoring.viewer         # Cloud Monitoring access
roles/logging.viewer            # Cloud Logging access

推奨（完全分析）

# All of the above, plus:
roles/compute.viewer            # Compute Engine details
roles/container.viewer          # GKE cluster access
roles/cloudsql.viewer           # Cloud SQL access
roles/bigquery.dataViewer       # BigQuery analysis
roles/billing.viewer            # Billing and cost data
roles/securitycenter.viewer     # Security Command Center

最小ロールから始め、必要に応じて追加します。プロジェクトレベルのビューアーロールで、コスト分析とほとんどのセキュリティ監査が可能です。

エージェントの機能

接続後、エージェントはGCPリソースの分析と最適化を実行できます。

エージェント	GCPの機能
Alex	コスト分析、VMの適正サイズ調整、コミット使用量の推奨、リソース最適化
Oliver	Security Command Centerのファインディング、IAM監査、コンプライアンスチェック
Tony	Cloud SQLパフォーマンス、BigQuery最適化、Spannerチューニング
Kai	GKEクラスター管理、ワークロード最適化、Autopilot分析

接続を確認する

@alex run a GCP account check and list connected projects and active services

プロンプト例

@alex analyze Compute Engine costs over the last 30 days and #recommend right-sizing opportunities
@oliver audit GCP IAM bindings and flag any over-permissioned service accounts
@kai inspect GKE cluster health and #report any pod failures or resource pressure

トラブルシューティング

権限拒否エラー

サービスアカウントに必要なロールがあることを確認します。プロジェクトレベルのIAMバインディングを確認し、APIが有効になっていること（Compute、Monitoringなど）、JSONキーが有効で期限切れでないことを確認してください。

無効なキーファイル

JSONファイルが完全で適切にフォーマットされていることを確認します。秘密鍵が切り詰められていないこと、余分な空白や文字が追加されていないことを確認してください。GCPコンソールからキーを再生成してみてください。

請求データがない

Billing Account Viewer ロールが割り当てられていることを確認します。Cloud Billing APIを有効にし、BigQueryへの請求エクスポートが設定されていることを確認してください。

GKEアクセスの問題

Kubernetes Engine Viewer ロールが割り当てられていることを確認します。クラスターがアクセス可能なプロジェクトにあることを確認し、クラスターがWorkload Identityを使用しているかどうかを確認してください。

セキュリティ

最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。

プロジェクトスコープ — サービスアカウントのIAMロールを、CloudThinkerがアクセスする必要があるGCPプロジェクトのみに制限します。
キーの保管 — サービスアカウントJSONをシークレットマネージャーに保管し、CloudThinkerへのアップロード後はローカルのコピーを削除します。

AWS接続

Amazon Web Servicesを接続

Kaiエージェント

GKE向けKubernetesエージェント

組織

エージェント

自動化と自律性

接続

プラットフォーム設定

セキュリティ

請求

前提条件

セットアップ

マルチプロジェクトのセットアップ

接続詳細

必要な権限

最小（読み取り専用分析）

推奨（完全分析）

エージェントの機能

接続を確認する

プロンプト例

トラブルシューティング

セキュリティ

関連

AWS接続

Kaiエージェント

​前提条件

​セットアップ

​マルチプロジェクトのセットアップ

​接続詳細

​必要な権限

​最小（読み取り専用分析）

​推奨（完全分析）

​エージェントの機能

​接続を確認する

​プロンプト例

​トラブルシューティング

​セキュリティ

​関連

AWS接続

Kaiエージェント

前提条件

セットアップ

マルチプロジェクトのセットアップ

接続詳細

必要な権限

最小（読み取り専用分析）

推奨（完全分析）

エージェントの機能

接続を確認する

プロンプト例

トラブルシューティング

セキュリティ

関連