前提条件
必要なAzure ADパーミッション
OAuthフロー中、CloudThinkerは以下のMicrosoft Graph APIパーミッションをリクエストします：
管理者同意とマークされたパーミッションは、Global AdministratorまたはTeams Administratorのみが付与できます。OAuthフロー中、管理者には**「Consent on behalf of your organization」**チェックボックスが表示されます：
- チェック済み — パーミッションはAzure ADテナント内のすべてのユーザーにテナント全体で付与されます。後で接続する他の管理者は再同意する必要がありません。
- 未チェック — パーミッションは管理者自身のアカウントのみに付与されます。管理者はボットを公開するために必要なロールを個人的に持っているため、セットアップの完了には十分です。
セットアップを実行する人
セットアップ
1
Integrationsに移動する
Admin Settings → Integrations に移動して Microsoft Teams を見つけます
2
Teamsで接続する
Connect with Teams をクリックしてMicrosoft OAuthで認証します。
3
ボットをインストールする
CloudThinkerボットを追加するTeamsを選択してインストールを確認します。ボットは組織のTeamsアプリカタログに公開されます—これは一回限りのアクションです。
4
Teamsをワークスペースにマッピングする
Microsoft TeamsをCloudThinkerワークスペースにマッピングして、エージェントが操作するクラウドアカウントを認識できるようにします
5
通知を設定する
オプションで各通知タイプ（コストアラート・セキュリティの調査結果・インシデントの更新）のチャンネルを選択します
6
テストする
チャンネルで
@CloudThinker alex show AWS costs を試して接続を確認します構文
Teamsでは、すべてのコマンドに@CloudThinker プレフィックスを付けます：
@CloudThinker プレフィックスを追加するだけです。
使用例
クイッククエリ
ツールを使用する場合
マルチエージェント
アラート
エージェントがTeamsチャンネルにアラートを送信するよう設定します：Code Review通知
AIのCode Reviewが完了すると、CloudThinkerは設定されたTeamsチャンネルにAdaptive Card通知を送信します。カードには以下が含まれます：- 重大度FactSet — 重大度レベル別の件数を示す構造化テーブル（🔴 Critical、🟠 High、🟡 Medium、🟢 Low）
- 調査結果の詳細 — タイトル・重大度ラベル・ファイルパス・行番号付きの未解決調査結果（最大5件）
- 解決済み数 — 以前に特定された調査結果のうち解決された件数
- View Code Review ボタン — レビューダッシュボードへの直接リンク
- クリーンパス — 問題が見つからない場合の「No issues found」メッセージ
Code Review通知を受信するTeamsチャンネルと重大度しきい値は Settings > Notifications > Code Review / Pipeline Monitoring で設定します。詳細はNotifications Centerを参照してください。
チャンネルパターン
トラブルシューティング
エージェントが応答しない
エージェントが応答しない
- CloudThinkerボットがチームにインストールされているか確認する
@CloudThinker agent構文を使用しているか確認する（agentだけでなく）- CloudThinkerコンソールでエージェントが設定されているか確認する
- Azure ADの管理者同意ステータスを確認する
アラートが届かない
アラートが届かない
- CloudThinker SettingsのアラートConditionを確認する
- Teamsチャンネルの通知設定を確認する
- ボットがターゲットチャンネルに投稿するパーミッションを持っているか確認する
パーミッションエラー
パーミッションエラー
- 「Missing required permissions」 — 接続したユーザーがGlobal AdministratorまたはTeams Administratorのロールを持っていません。代わりにITチームに初期接続を実行するよう依頼してください。
- 「Consent on behalf of your organization」 — OAuth中、管理者はこのボックスにチェックを入れてテナント全体にパーミッションを付与できます。これはオプションです—接続するユーザーがすでに管理者であれば、個人の同意で十分です。
- 接続は成功しているがボットが動作しない — 管理者以外のユーザーがOAuthフローを完了した場合に発生することがあります。ユーザーの個人認証は成功しますが、ボットをアプリカタログに公開する際にサイレントに失敗します。Global AdministratorまたはTeams Administratorに再接続を依頼してください。
- その他のパーミッションエラーについては、CloudThinkerのワークスペース管理者パーミッションを確認するか、チームからボットを削除して再追加してみてください。
管理者でない場合—どうセットアップするか？
管理者でない場合—どうセットアップするか？
初期接続を完了するには、組織の Global Administrator または Teams Administrator が必要です。以下を共有してください：
- CloudThinkerにサインインする（組織の管理者アクセス権を持つCloudThinkerアカウントが必要）
- Admin Settings → Integrations → Microsoft Teams に移動する
- Connect with Teams をクリックしてMicrosoft OAuthフローを完了する
- ボットが組織のTeamsアプリカタログに公開されます
@CloudThinker をメンションすることで、Teamsワークスペースの任意のユーザーがボットとやり取りできます。パーミッション
Azure ADパーミッション
初期接続にはAzure ADの Global Administrator または Teams Administrator が必要です。これはCloudThinkerが組織のTeamsアプリカタログにボットを公開する必要があるためです。これは管理者レベルのアクションです。このセットアップは一回限りの操作です—ボットが公開されると、それ以上の管理者アクションは不要です。 OAuth中、管理者はオプションで**「Consent on behalf of your organization」**にチェックを入れてテナント全体にパーミッションを付与できます。未チェックの場合、パーミッションは管理者自身のアカウントにのみ付与されますが、セットアップの完了には十分です。リクエストされるスコープの完全なリストは上記の必要なAzure ADパーミッションテーブルを参照してください。CloudThinkerパーミッション
Teams内では、ユーザーはCloudThinkerアカウントが許可するエージェントとクラウド接続にのみアクセスできます。CloudThinkerワークスペースのロールはWebコンソールと同様に適用されます。関連ドキュメント
CloudThinker Language
すべてのコマンドの完全な構文リファレンス
Slack Integration
SlackでCloudThinkerをセットアップする