Microsoft Teams 用の Rovo を設定する

Microsoft Teams 用の Rovo は、管理者によるセットアップなしで 1 対 1 のダイレクト メッセージで動作します。グループ チャットやチャンネルで Rovo を使用するには、Atlassian 組織管理者が 1 回限りの設定を完了する必要があります。これには、アトラシアン サイトと Microsoft テナントの接続、Microsoft Teams 権限の付与、Microsoft Marketplace からのアプリのインストールの 3 つのステップが含まれます。

はじめる前に

開始する前に、次の前提条件を確認してください。

• Atlassian 組織管理者としてのアクセス権

• アトラシアン サイトでの Rovo の有効化

• admin.atlassian.com へのアクセス権

• テナントの接続に使用する Microsoft 365 アカウント (Microsoft Entra 管理者権限が必要)

• 同意を付与できる Microsoft Teams 管理者 (自分自身または別の担当者)

ユーザーからの Rovo のセットアップ依頼の通知方法

ユーザーが Rovo を追加したグループ チャットまたはチャンネルがまだ設定されていない場合は、Rovo のセットアップが未完了であることをグループに知らせるメッセージがチャットに自動的に送信されます。ユーザーには次の 2 つのオプションが表示されます。

• Notify Admin (管理者に通知) — Rovo は、ユーザーが所属するすべての組織のすべての Atlassian 組織管理者にメールを送信します。ユーザーにはメールの送信後に確認画面が表示されます。

• Admin Setup (管理者によるセットアップ) — 管理者同意フローを直接開始します (ユーザーと管理者を兼ねている場合に便利です)。

管理者通知メールの件名は「Admin setup required — Enable Rovo for Microsoft Teams (管理者によるセットアップが必要 — Microsoft Teams 用の Rovo の有効化)」です。これには、次の 2 つのリンクが含まれています。

• Configure (設定) — Microsoft Teams の管理者同意フローに直接移動します。

• Install for myself (自分用にインストール) — Teams で自身の個人利用のために Rovo アプリをインストールします。

Rovo を設定する

メール内の [Configure (設定)] (または Teams の会話内の [Admin Setup (管理者によるセットアップ)] ボタン) を選択して、管理者同意フローを開始します。自身が管理者であるすべての Atlassian 組織がリストされたホームページが表示されます。設定する組織を選択します。

セットアップ ページが表示され、完了すべき 3 つのステップが示されます。

ステップ 1: アトラシアン サイトを Microsoft テナントに接続する (必須)

このステップでは、Microsoft 365 テナントを Atlassian 組織にリンクし、Rovo がグループ会話内の Jira および Confluence データを読み取るために使用するサービス アカウントをセットアップします。

1a. Microsoft テナントを接続する

1. ステップ 1 で [Start (開始)] を選択します。導入画面には、必要な権限の概要とこのサポート ドキュメントへのリンクが記載されています。

2. [Next (次へ)] を選択します。Microsoft テナントへのサインインを求められます。

   • すでにサインインしている場合は、必要に応じて別のアカウントに切り替えることができます。

   • [Sign in to connect (サインインして接続)] を選択し、 Microsoft のログイン フローを完了して、[Accept (承認)] を選択して接続を承認します。

3. サインインが正常に完了したら、[Next (次へ)] を選択します。

4. 接続するアトラシアン サイトを選択します。Rovo が有効化されているサイトでのみ続行できます。[Next (次へ)] を選択します。

1b. サービス アカウントを作成する

Rovo は、チームに代わって Jira や Confluence から情報を検索して提示するために、チャンネルやグループ チャットでサービス アカウントを使用します。Atlassian 組織でこのアカウントを作成し、その OAuth 認証情報を生成する必要があります。

1. admin.atlassian.com に移動し、組織を選択します。

2. 左側のナビゲーションで、[ディレクトリ] を選択し、[サービス アカウント] を選択します。

3. [サービス アカウントを作成] を選択し、わかりやすい名前を付けます (例:「Rovo Teams Bot」)。

4. [アプリ ロールを選択] で、Rovo にアクセスさせる各 Atlassian アプリについて、サービス アカウントにユーザー ロールを割り当てます (例:Jira、Confluence)。

1c. OAuth 認証情報を作成する

1. [サービス アカウント] から、作成したばかりのサービス アカウントを開きます。

2. [認証情報を作成] を選択し、[OAuth 2.0] を選択します。

3. 認証情報に名前を付けます (例:「rovo-teams」)。

4. [スコープを選択] で、[スコープ タイプ: クラシック] フィルターを選択します。

5. 少なくとも次の 14 個のスコープを有効化する必要があります。

   • read:account

   • read:confluence-content.all

   • read:confluence-content.permission

   • read:confluence-content.summary

   • read:confluence-groups

   • read:confluence-props

   • read:confluence-space.summary

   • read:confluence-user

   • read:jira-user

   • read:jira-work

   • read:me

   • read:servicedesk-request

   • readonly:content.attachment:confluence

   • search:confluence

6. 確認して、[作成] を選択します。

7. クライアント ID とクライアント シークレットを保存します。いずれの値も次のステップで必要になります。これらは一度だけ表示されます。

1d. 同意フローで認証情報を入力する

1. Microsoft Teams の Rovo 管理者同意フローに戻ります。

2. サービス アカウントのメール アドレス、クライアント ID、クライアント シークレットをそれぞれ所定のフィールドに貼り付けます。

3. [完了] を選択します。

認証情報が承認されると、Microsoft テナントとアトラシアン サイトの間のマッピングが作成されます。

ステップ 2: Microsoft Teams の権限を付与する (必須)

For Rovo to summarize chats and perform actions in channels and group chats, it requires additional permissions from Microsoft. The app requires the following Microsoft Teams permissions:

• email

• offline_access

• openid

• profile

• User.Read

• ChannelMessage.Read.All

• Chat.Read

これらはユーザーの委任権限であり、テナント全体に対して Microsoft Teams 管理者が承認する必要があります。

1. ステップ 2 で [Start (開始)] を選択します。Rovo に必要な権限を説明するモーダルが表示されます (例:要約にはチャット メッセージの読み取り権限が必要)。

2. 自身のロールに応じて、適切なオプションを選択します。

権限が付与されると、Rovo はグループ チャットやチャンネルで応答できるようになります。

ステップ 3: インストールする (必須)

セットアップの最後のステップでは、Microsoft Teams 組織全体のユーザーが Rovo アプリを利用できるようにします。

オプション A: 組織全体/グループを対象としたインストール (推奨)

Rovo を組織全体にインストールすると、ユーザーはすぐにアクセスできるようになり、個別のセットアップが不要になり、さらに管理者のサポート負担が軽減されます。セットアップするには、次の手順に従います。

1. Microsoft Teams 管理センターで、[Teams アプリ] に移動し、[アプリの管理] を選択します。

2. [Rovo] を選択し、[ユーザーとグループ] を選択します。

3. [Select to manage who this app... (このアプリが...ユーザーを管理します)] の下で [インストール] を選択します。

4. [アプリのインストール] ボタンを選択します。

5. 表示されるサイド メニューで、インストールの対象として [すべてのユーザー)] (または特定のユーザー/グループ) を選択します。

オプション B: ユーザーごとのインストール

ユーザーによるアプリの個別インストールを希望する場合は、まず Rovo のブロックが解除されていることを確認する必要があります。これを行うには、次の手順に従います。

1. Microsoft Teams 管理センターで、[Teams アプリ] に移動し、[アプリの管理] を選択します。

2. [Rovo] を選択し、[ユーザーとグループ] を選択します。

3. [可用性の編集] を選択します。

4. 可用性を [すべてのユーザー] に変更し、[適用] を選択します。Teams 用 Rovo を特定のユーザーまたはグループのみが利用できるようにする場合は、[特定のユーザーまたはグループ] を選択します。

5. Rovo の可用性が [すべてのユーザーが使用可能] に設定されていることを確認します。

ステップ 4: アプリを固定する (任意)

セットアップに必須ではありませんが、ユーザーが簡単に見つけられるように Rovo をアプリ バーに固定することをお勧めします。これにより、混乱を減らし、ロールアウト後の管理者へのサポート リクエストを最小限に抑えることができます。

ユーザーのアプリ バーに Rovo アプリを固定するには、次の手順に従います。

1. Microsoft Teams 管理センターにログインします。

2. [Teams アプリ] を選択し、[セットアップ ポリシー] を選択します。

3. [グローバル (組織全体の既定値)] を選択してポリシーを編集します。

4. [ピン留めされたアプリ] セクションまでスクロールし、[アプリの追加] を選択します。

5. Rovo を検索し、[追加] を選択します。

6. Rovo アプリを希望の位置にドラッグします。

7. 画面の下部で、[保存] を選択します。

Rovo が機能していることを確認する

3 つのステップをすべて完了したら、Microsoft Teams の任意のグループ チャットまたはチャンネルに移動し、@Rovo をメンションしてメッセージを送信します。Rovo が数秒以内に応答するはずです。

引き続き「未設定」のメッセージが表示される場合は、次の点を確認してください。

• ステップ 1 で選択したアトラシアン サイトで Rovo が有効化されていること。

• クライアント ID とクライアント シークレットが正しく入力されていること (不確かな場合は再入力する)。

• Microsoft Teams の権限が正常に付与されていること。