Skip to main content
バグ報告や機能要望、質問が届いたら、すぐに Microsoft Teams で @Devin をメンションしてください。タグ付けされると、Devin がスレッド内で更新内容や確認事項を返信します。

​
はじめに

​
インストール

  1. Settings > Connections に移動し、Microsoft Teams を選択します
  2. 「Connect」をクリックします
  3. テナントや対象のTeamに Devin アプリをインストールするよう求められます
  4. 必ず自分のユーザーを連携してください。組織内のすべてのユーザーが Devin を利用するには、この手順を各自で完了する必要があります
  5. Teamのチャネルまたはチャットで @Devin とメンションしてセッションを開始します
注: Devin を各ユーザーに対して動作させるには、すべてのユーザーが Devin ダッシュボード (Settings > Connections) で自分のアカウントを連携する必要があります。これにより、Devin はそのユーザーの Microsoft Teams のユーザー ID と Devin ユーザーを関連付けることができます。

​
Microsoft Teams から Devin を使う方法

Microsoft Teams 連携をインストールしたら、任意の Teams チャンネルで @Devin とメンションするだけで Devin を呼び出せます。 Devin は、そのスレッド内であなたのセッションに返信します。通常の Devin チャットインターフェースと同様に、双方向にやりとりできます。 なお、Devin が誤った回答をする可能性があります。必ず回答内容を再確認してください。

​
Teams インラインキーワードと機能

​
料金

まだDevinアカウントをお持ちでない場合は、料金とプランの詳細をこちらからご確認いただけます。

​
プライバシー

当社のプライバシーポリシーはこちらをご覧ください。

​
認証フロー

以下の図は、Microsoft Teams 連携における認証アーキテクチャの全体像を示しており、Teams から各レイヤーを通って Devin の認証済みセッションが確立されるまでの認証フローを表しています。

​
権限の詳細

以下は、本連携で必要となる Microsoft Teams および Microsoft Graph の権限の概要です。それぞれが何を許可するのか、なぜ必要なのか、どこで使用されるのかを示します。
概要
  • Graph（アプリケーション権限、テナント全体）：検出およびインストールのオーケストレーションに使用します。
  • Teams ボット RSC（チーム／チャット単位）：ボットがインストールまたは参加している場所に限定して、メッセージ／メンバー／設定へのアクセスを許可します。

​
テナント全体の Microsoft Graph (アプリケーション) 権限

これらには Microsoft Entra ID での管理者の同意が必要です。アプリケーション専用の権限であり、ユーザーによる委任はありません。
注: テナント全体スコープの Graph を使用してメッセージ内容を読み取ることはありません。メッセージへのアクセスは、ボットがインストールされ存在しているチームに対してのみ、RSC によって付与されます。
これらの権限は、インストール時にチーム / チャットごとに付与されます（テナント全体には適用されません）。
RSC の制限事項: アクセスは、アプリがインストールされている、または参加している特定のチーム / チャットに限定されます。チーム / チャットからアプリを削除すると、そのアクセスは失効します。

​
例: Teams 検出のための証明書ベースの認証

下の図は、Microsoft Graph に対するアプリケーション専用の証明書ベース認証を示しています。X.509 クライアント証明書を使用してサービスがアクセストークンを取得し、その後 Graph を呼び出して Teams の一覧を取得します (GET /v1.0/teams)。この例は、Devin がユーザー コンテキストなしでテナント検出を安全に行う方法を示しています。
資格情報に関する注意: サービス間認証にはクライアント シークレットではなく、X.509 証明書（クライアント アサーション）を使用します。これは、Microsoft Graph への呼び出し、Bot Framework アダプターとのボット通信、この連携から行われるアプリ単独（app-only）の API 呼び出しに適用されます。

​
メッセージ処理フロー全体（Teams → Cognition）

次の図は、ユーザーが Microsoft Teams から Devin にメッセージを送信した際の、トークン検証およびボット処理を含むエンドツーエンドのメッセージ処理フローを示しています。
認証情報に関する注意: サービス間認証では、クライアント シークレットではなく X.509 証明書（クライアント アサーション）を使用します。これは、Microsoft Graph の呼び出し、Bot Framework アダプターとのボット通信、およびこの連携からのアプリのみの API 呼び出しすべてに適用されます。
  1. 管理者同意 (テナント全体)
    • Entra ID の管理者が、上記の Graph Application 権限を付与します。
  2. アプリ検出
    • この連携機能が Teams アプリ カタログをクエリし、当社アプリを特定して teamsAppId を取得します。
  3. 対象指定インストール
    • ダッシュボードから、特定の Team にボットをインストールします。
    • インストール時、RSC スコープはその Team（またはチャットで呼び出された場合はその特定の Chat）にのみ付与されます。
  4. 運用
    • 検出処理（組織 / Teams / チャネル / アプリ カタログ）は Graph Application 権限を使用します。
    • メッセージの読み取り / 送信、およびメンバー / 設定の読み取りは、インストール先サーフェス内での RSC に依存します。

​
最小権限に関する注意事項

  • 基本リーダーのみ: User.ReadBasic.All（テナント全体のメッセージは読み取りません）。
  • メッセージコンテンツへのアクセスは、RSC を通じてのみ行われ、ボットがインストールされている／存在する場所に限定されます。
  • メールボックス、ファイル、カレンダーの権限は一切要求しません。

​
取り消しとアンインストール

  • 管理者同意の取り消し: テナント管理者は、Entra ID でこのアプリのエンタープライズ アプリ権限を削除できます。
  • Teams からのアンインストール: 対象のリソースに対する RSC を取り消すには、その Team/Chat からアプリを削除します。
  • データ処理: アンインストール時、当社の連携機能はその Team/Chat に対するイベントの処理を停止し、関連するサブスクリプションやリンクを削除します。