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

# Slack Integration

> SlackからCloudThinker AIオペレーションを直接実行—ワークスペースを離れることなくインフラを管理し、コストを確認し、インシデントを調査します

Slackワークスペースをクラウドオペレーションのコマンドセンターに変えます。CloudThinkerエージェントとのインタラクション・アラートの受信・オペレーションの実行をSlackを離れずに行えます。

<Note>
  **[AgenticOps](/ja/guide/tutorial/agenticops) vs ChatOps**: AgenticOpsはクラウドオペレーションへの会話的アプローチ—自然言語でAIエージェントと対話するより広いパラダイムです。ChatOpsは*Slack・TeamsでAgenticOpsを行う*方法です。同じ `@agent #tool` 構文がCloudThinker Webアプリとチャットでまったくつながっています。
</Note>

***

## コンテキストスイッチングの問題

アラートが発生すると、エンジニアは5つ以上のツールをコンテキストスイッチします：PagerDutyで確認 → AWSコンソールを開く → CloudWatchを確認 → kubectlを起動 → Datadogを開く。全体像が把握できるころには20分が経過し、チームはSlack—全員がすでにいる唯一の場所—で状況更新を求めています。

日常的なオペレーションもコンテキストスイッチングを必要とします：コストを確認するにはCost Explorerを開き、セキュリティの調査結果を確認するにはSecurity Hubを開き、Kubernetesを確認するにはLensを起動するかkubectlコマンドを実行する必要があります。

***

## SlackOpsが異なる理由

| シナリオ             | 従来のアプローチ                                     | CloudThinker SlackOps                                               |
| ---------------- | -------------------------------------------- | ------------------------------------------------------------------- |
| **深夜3時にアラートが発生** | ページング → AWSコンソールを開く → CloudWatch → 手動で相関     | #incidentsで `@CloudThinker alex investigate the spike in errors`    |
| **コストの確認**       | ブラウザを開く → Cost Explorerに移動 → フィルターを作成        | `@CloudThinker alex what's our AWS spend this week?`                |
| **セキュリティ監査**     | Security Hubを開く → 調査結果をフィルタリング → レポートをエクスポート | `@CloudThinker oliver any critical security findings?`              |
| **インシデント調整**     | 異なるダッシュボードの複数エンジニア、手動メッセージによる状況更新            | `@CloudThinker anna coordinate investigation: @alex @tony @kai`     |
| **チームアラート**      | PagerDuty/OpsGenieのルーティングルールを設定              | `@CloudThinker kai #alert pod failures in production → #k8s-alerts` |

SlackOpsが機能するのは、エンジニアがすでにいる場所で機能し、単なる[通知](/ja/guide/notifications)ではなくCloudThinkerエージェントのフル機能を提供するからです。

***

## セットアップ

<Info>
  デフォルトでは、任意のSlackワークスペースメンバーがアプリをインストールできます。ワークスペースで **App Approval** が有効になっている場合、CloudThinkerをインストールする前にWorkspace OwnerまたはアプリマネージャーがCloudThinkerを承認する必要があります。
</Info>

<Steps>
  <Step title="Integrationsに移動する">
    [**Admin Settings → Integrations**](https://app.cloudthinker.io/admin-settings/integrations) に移動して **Slack** を見つけます
  </Step>

  <Step title="Slackで接続する">
    **Add to Slack** をクリックしてSlackのOAuthフローで認証します。

    <Info>
      ワークスペースで **App Approval** が有効になっている場合、このステップを完了する前にWorkspace OwnerまたはアプリマネージャーがCloudThinkerを承認する必要があります。アプリがまだ承認されていない場合は、リクエストの送信を促すメッセージが表示されます。
    </Info>
  </Step>

  <Step title="アプリをインストールする">
    CloudThinkerをインストールするSlackワークスペースを選択してOAuthスコープを確認します。アプリがワークスペースのアプリディレクトリに表示されます。
  </Step>

  <Step title="チャンネルをワークスペースにマッピングする">
    SlackチャンネルをCloudThinkerワークスペースにマッピングして、エージェントが操作するクラウドアカウントを認識できるようにします
  </Step>

  <Step title="通知を設定する">
    オプションで各通知タイプ（コストアラート・セキュリティの調査結果・インシデントの更新）のチャンネルを選択します
  </Step>

  <Step title="テストする">
    チャンネルで `@CloudThinker alex show AWS costs` を試して接続を確認します
  </Step>
</Steps>

***

## 構文

Slackでは、すべてのコマンドに `@CloudThinker` プレフィックスを付けます：

```text theme={null}
@CloudThinker alex analyze EC2 spending trends
@CloudThinker oliver audit security groups for public access
@CloudThinker tony check database performance
@CloudThinker kai review EKS cluster health
```

すべての[CloudThinker Language](/ja/guide/language)構文はSlackで機能します—`@CloudThinker` プレフィックスを追加するだけです。

***

## 使用例

### クイッククエリ

```text theme={null}
@CloudThinker alex what's our AWS spending this week?
@CloudThinker oliver any critical security findings?
@CloudThinker tony why are queries slow on production?
@CloudThinker kai check pod status in payment namespace
```

### ツールを使用する場合

```text theme={null}
@CloudThinker alex #dashboard cost trends by service
@CloudThinker oliver #report weekly security summary
@CloudThinker tony #recommend index optimizations
@CloudThinker kai #alert on pod OOMKilled events
```

### マルチエージェント

```text theme={null}
@CloudThinker anna coordinate investigation of latency spike
@CloudThinker alex and tony analyze database infrastructure costs
```

***

## アラート

エージェントがSlackチャンネルにアラートを送信するよう設定します：

```text theme={null}
@CloudThinker alex #alert daily spend exceeds $5,000 → #cloud-ops
@CloudThinker oliver #alert security group changes → #security
@CloudThinker kai #alert pod failures in production → #k8s-alerts
```

***

## Code Review通知

接続されたリポジトリでAI Code Reviewが完了すると、CloudThinkerはSlackチャンネルにサマリー通知を送信できます。これらの通知はBlock Kitフォーマットを使用し、以下を含みます：

* **重大度インジケーター** — 各重大度レベルのカラーコード付き絵文字（🔴 Critical、🟠 High、🟡 Medium、🟢 Low）
* **重大度の内訳** — 重大度別の調査結果数
* **調査結果の詳細** — タイトル・ファイルパス・行番号付きの未解決調査結果（最大5件）
* **解決済み数** — 以前に特定された調査結果のうち解決された件数
* **View Code Review** ボタン — レビューダッシュボードへの直接リンク
* **クリーンパス** — 問題が見つからない場合の「No issues found」メッセージ

<Info>
  Code Review通知を受信するSlackチャンネルと重大度しきい値は **Settings > Notifications > Code Review / Pipeline Monitoring** で設定します。詳細は[Notifications Center](/ja/guide/notifications)を参照してください。
</Info>

***

## チャンネルパターン

| チャンネル           | ユースケース                    |
| --------------- | ------------------------- |
| `#cloud-ops`    | 一般的なインフラオペレーションとコストアラート   |
| `#security`     | セキュリティの調査結果とコンプライアンスの更新   |
| `#incidents`    | アクティブなインシデントの調査と調整        |
| `#code-reviews` | Code Reviewの調査結果とパイプライン監視 |
| `#reports`      | スケジュールされたレポートとサマリー        |

***

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

<Accordion title="エージェントが応答しない">
  * CloudThinkerアプリがチャンネルに追加されているか確認する
  * `@CloudThinker agent` 構文を使用しているか確認する（`agent` だけでなく）
  * CloudThinkerコンソールでエージェントが設定されているか確認する
  * Slackワークスペースの管理者同意ステータスを確認する
</Accordion>

<Accordion title="アラートが届かない">
  * CloudThinker SettingsのアラートConditionを確認する
  * Slackチャンネルの通知設定を確認する
  * ボットがターゲットチャンネルに投稿するパーミッションを持っているか確認する
  * `/cloudthinker alerts test` でテストする
</Accordion>

<Accordion title="パーミッションエラー">
  * **「Missing required scopes」** — アプリが必要なすべてのOAuthスコープなしにインストールされた可能性があります。ワークスペースからアプリを削除し、CloudThinkerのIntegrationsページから再インストールしてください。
  * **接続は成功しているがボットが応答しない** — OAuthフローが完全に完了しなかった場合に発生することがあります。アプリを削除して再インストールしてみてください。
  * **「not\_allowed\_token\_type」またはスコープエラー** — Slackワークスペースでアプリ承認が有効になっている可能性があります。Workspace OwnerまたはアプリマネージャーにSlackの管理ダッシュボード **Manage Apps** でCloudThinkerを承認するよう依頼してください。
  * その他のパーミッションエラーについては、CloudThinkerのワークスペースパーミッションを確認するか、チャンネルからアプリを削除して再追加してみてください。
</Accordion>

<Accordion title="ワークスペースでApp Approvalが有効—CloudThinkerを承認するには？">
  ワークスペースでアプリ承認が必要な場合、Workspace Ownerまたはアプリマネージャーにこちらを共有してください：

  1. CloudThinkerにサインインする（組織の管理者アクセス権を持つCloudThinkerアカウントが必要）
  2. [**Admin Settings → Integrations → Slack**](https://app.cloudthinker.io/admin-settings/integrations) に移動する
  3. **Add to Slack** をクリックしてSlack OAuthフローを完了する
  4. Slackの **Manage Apps** ダッシュボードでアプリを承認する

  これは**一回限りのセットアップ**です。承認後は、アプリが追加されたチャンネルで `@CloudThinker` をメンションすることで、任意のワークスペースメンバーがCloudThinkerとやり取りできます。
</Accordion>

***

## パーミッション

### Slack OAuthパーミッション

デフォルトでは、任意のワークスペースメンバーがCloudThinker Slackアプリをインストールできます。ワークスペースで **App Approval** が有効になっている場合、メンバーがインストールする前にWorkspace OwnerまたはアプリマネージャーがCloudThinkerを承認する必要があります。この承認は一回限りの操作です—承認後はそれ以上の管理者アクションは不要です。

### CloudThinkerパーミッション

Slack内では、ユーザーはCloudThinkerアカウントが許可するエージェントとクラウド接続にのみアクセスできます。CloudThinkerワークスペースのロールはWebコンソールと同様に適用されます。

***

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="CloudThinker Language" icon="code" href="/ja/guide/language">
    すべてのコマンドの完全な構文リファレンス
  </Card>

  <Card title="Microsoft Teams Integration" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/teams.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=3c0044a0e91d90c33f6aee6c57b8d4aa" href="/ja/guide/teams-integration" width="24" height="24" data-path="images/icons/teams.svg">
    Microsoft TeamsでCloudThinkerをセットアップする
  </Card>
</CardGroup>
