次の方法で共有

Azure DevOps 作業項目 Microsoft 365 Copilot コネクタをデプロイする

Azure DevOps Work Items コネクタは、ユーザー ストーリー、タスク、バグ、機能などの作業項目を、Azure DevOps Services organizationから Microsoft 365 にインデックスを付けます。 このガイドでは、コネクタをデプロイおよびカスタマイズする手順について説明します。

DevOps の構成情報Azureについては、「コネクタ インジェスト用に Azure DevOps 環境を設定する」を参照してください。

前提条件

Azure DevOps Work Items コネクタをデプロイする前に、Azure DevOps 環境がorganizationで構成されていること、および次の前提条件を満たしていることを確認してください。

  • Microsoft 365 管理者である必要があります。
  • インデックスを作成するAzure DevOps organizationを特定しました。
  • インデックスを作成するすべてのプロジェクトとエリア パスに対して少なくとも必要な読み取りアクセス許可を持つクロール アカウントを DevOps Azureで構成しました。
  • DevOps REST API の委任されたアクセス許可を持つアプリケーションAzure Microsoft Entra IDで作成しました。
  • OAuth ベースの認証用のMicrosoft Entra アプリのクライアント シークレットを生成しました。

コネクタをデプロイする

organizationの Azure DevOps Work Items コネクタを追加するには:

  1. Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
  2. [ ギャラリー ] タブを選択します。
  3. 使用可能なコネクタの一覧から、[DevOps 作業項目Azure選択します。

表示名を設定する

表示名は、関連付けられているコンテンツ ソースをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 DevOps 作業項目の既定Azure表示名をそのまま使用することも、organizationに応じてカスタマイズすることもできます。

インスタンス URL の設定

Azure DevOps organization名を指定します。 Azure DevOps organization名は、https://dev.azure.com/後のセグメントです。 例:

  • URL: https://dev.azure.com/contoso
  • 組織： contoso

organization名のみが必要です。完全な URL は指定しないでください。

認証の種類を選択する

DevOps から作業項目Azure同期するには、サポートされている認証方法のいずれかを選択し、必要なセットアップを完了します。

  • フェデレーション資格情報 (推奨) - サービス プリンシパルを使用してコンテンツをクロールします。
  • Microsoft Entra ID OAuth - サインインしている Microsoft 365 管理者アカウントを使用します。

フェデレーション資格情報は、クロール サービス アカウントとして Microsoft 発行のエンタープライズ アプリケーションを使用します。 このサービス プリンシパルには、DevOps で必要なアクセス許可Azure付与する必要があります。

サービス プリンシパル アプリがプロビジョニングされていることを確認する
  1. Microsoft Entra 管理センターに移動します。
  2. Graph Connector フェデレーション資格情報アプリを検索するか、アプリ ID: 933838e2-bec1-440f-a634-9363c82e5b6dを使用します。
  3. アプリがプロビジョニングされていない場合は、Microsoft 365 管理センターで Copilot コネクタ ページを開きます。 プロビジョニングには数時間かかることがあります。
Microsoft Entra アプリにAzure DevOps プロジェクトへのアクセス権を付与する

インデックスを作成する DevOps プロジェクトAzureへのアクセス権をサービス プリンシパルに付与します。

  1. [Azure DevOps] に移動し、organizationを選択します。
  2. [ 組織の設定] を選択します。
  3. 左側のウィンドウの [ 全般] で、[ ユーザー] を選択します。
  4. [ ユーザーの追加] を選択します。
  5. [ ユーザーまたはサービス プリンシパル] に、アプリ ID 933838e2-bec1-440f-a634-9363c82e5b6dを入力します。
  6. Basic アクセス レベルを割り当て、インデックスを作成するプロジェクトを選択し、アプリを Project Administrators グループ (または同等のグループ) に追加します。 招待メールを送信するオプションをオフにします。
フェデレーション資格情報認証を構成する

認証の種類として [ フェデレーション資格情報] を選択し、メッセージが表示されたら認証します。

OAuth のMicrosoft Entra ID

Microsoft Entra ID OAuth では、クロール サービス アカウントとしてサインインしている Microsoft 365 管理者アカウントが使用されます。 コネクタが DevOps Azureアクセスし、作業項目を更新できるようにするには、必要なアクセス許可を付与します。

Azure DevOps organizationが Microsoft Entra に接続されていることを確認します

コネクタは、テナントのMicrosoft Entra IDにリンクされているAzure DevOps organizationからの作業項目にのみインデックスを作成できます。

  1. [Azure DevOps] に移動し、organizationを選択します。
  2. [ 組織の設定] を選択します。
  3. 左側のウィンドウの [全般] で、[Microsoft Entra] を選択します。
  4. organizationがテナントのMicrosoft Entra アカウントに接続されていることを確認します。

注:

接続を作成する管理者は、関連するプロジェクトへの 読み取り アクセス権を持っている必要があります。

Microsoft Entra IDでアプリを作成する
  1. 管理者の資格情報を使用してAzure portalにサインインします。
  2. [Microsoft Entra ID>Identity>Applications>アプリの登録 に移動し、[新しい登録] を選択します。
  3. アプリの名前を入力し、[登録] を選択 します。
  4. アプリケーション (クライアント) ID をメモします。これを使用して、DevOps Azureプロジェクトへのアクセス権を付与します。
  5. API のアクセス許可を開き、[アクセス許可の追加] を選択します。
  6. [DevOps>Delegated アクセス許可Azure選択します。
  7. 次の vso アクセス許可を追加します。
    • vso.analytics – Analytics (読み取り)
    • vso.graph – Microsoft Graph (読み取り)
    • vso.identity – ID (読み取り)
    • vso.project – プロジェクトとチーム (読み取り)
    • vso.variablegroups_read – 変数グループ (読み取り)
    • vso.work – 作業項目 (読み取り)
  8. [<TenantName に管理者の同意を付与する] を選択し>確認します。
  9. すべてのアクセス許可が [許可] として表示されることを確認します。
  10. [認証] を開き、[プラットフォームの追加>Web] を選択します。 次のいずれかのリダイレクト URI を追加します。
    • Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback
  11. [ 暗黙的な許可とハイブリッド フロー] で 、ID トークンを 有効にし、[構成] を選択 します。
  12. [証明書とシークレット] に移動し、[新しいクライアント シークレット] を選択します。 有効期限を選択し、生成されたシークレット値を保存します。
  13. コネクタを構成するときは、 クライアント シークレット と アプリケーション ID を 使用します。

クロール アカウントを使用してMicrosoft Entra アプリを認証する

アプリでは、シングル サインオンを使用して、サインインしている Microsoft 365 管理者アカウントで認証を行います。 Microsoft Entra IDは、ユーザーに付与された委任されたアクセス許可を含むアクセス トークンを発行します。 コネクタは、データにのみアクセスし、認証されたユーザーが実行を許可されているアクションを実行できます。

ロールアウト

制限付き対象ユーザーにコネクタをロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーまたはグループを指定します。 これにより、完全なデプロイの前にコネクタを検証できます。 詳細については、「 Copilot コネクタの段階的ロールアウト」を参照してください。

[ 作成] を 選択して接続をデプロイします。 Azure DevOps Work Items コネクタは、コンテンツのインデックス作成を直ちに開始します。

次の表に、設定される既定値を示します。

カテゴリ 既定値
ユーザー データ ソース内のコンテンツにアクセスできるユーザーのみ。 Microsoft Entra ID を使用してマップされたデータ ソース ID。
コンテンツ すべてのプロジェクトにインデックスが作成されます。
同期 毎日フル クロール。 増分クロールは 15 分ごとに行われます。

これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。

接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。

設定のカスタマイズ (省略可能)

Azure DevOps Work Items コネクタの既定の設定をカスタマイズするには、コネクタ ページで [カスタム セットアップ] を選択します。

ユーザー設定をカスタマイズする

アクセス許可

Azure DevOps Work Items コネクタでは、次の検索アクセス許可がサポートされています。

  • すべてのユーザーに表示
  • このデータ ソースにアクセスできるユーザーのみ

[すべてのユーザー に表示] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。

注:

アクセス許可を管理するグループへのUpdatesは、フル クロールでのみ同期されます。 増分クロールでは、アクセス許可に対する更新プログラムの処理はサポートされていません。

ID のマッピング

ID マッピングにより、Azure DevOps ID がMicrosoft Entra ID ユーザーに正しくマップされます。 コネクタは委任されたアクセスを使用し、サインインしている Microsoft 365 管理者アカウントを通じて ID を自動的に調整します。

コンテンツ設定をカスタマイズする

プロパティの管理

Azure DevOps データ ソースのプロパティの追加または削除、プロパティへのスキーマの割り当て (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルの変更、プロパティへのエイリアスの追加を行うことができます。 次の表は、既定でインデックスが作成されるプロパティの一覧です。

プロパティ セマンティック ラベル 説明 スキーマ属性
AreaPath 作業項目への領域パス クエリ、取得、検索
AssignedTo 作業項目が割り当てられているユーザーの名前 クエリ、取得、検索
ブロック ブロック 取得
ChangedBy 最終更新者 作業項目を最後に変更したユーザー名 クエリ、取得
ChangedDate 最終更新日時 クエリ、取得
CreatedBy 作成者 作業項目を作成したユーザー名 クエリ、取得、検索
CreatedDate 作成日時 作業項目が作成されたときのタイムスタンプ クエリ、取得
説明 コンテンツ 作業項目の説明 検索
IconUrl IconUrl 取得
ID 作業項目 ID クエリ、取得、検索
優先度 作業項目の優先順位 クエリ、取得
ReproSteps 作業項目で説明されている条件を再現する手順
状態 作業項目の現在の状態 クエリ、取得、検索
タグ クエリ、取得、検索
TeamProject 取得
タイトル タイトル 作業項目のタイトル 取得、検索
URL url 作業項目の URL 取得
WorkItemType クエリ、取得、検索

同期間隔をカスタマイズする

コネクタが Azure DevOps organizationをクロールする頻度を調整できます。 次の同期間隔を使用できます。

  • フル クロール:DevOps データセットAzure全体を再クロールします。
  • 増分クロール: 再クロールは、更新された項目のみです。

既定の同期設定は、ほとんどの組織向けに最適化されています。

詳細については、「 同期設定のガイドライン」を参照してください。

関連コンテンツ

  • Last updated on