Azure DevOps Wiki Microsoft 365 Copilot コネクタ

Azure DevOps Wiki Microsoft 365 Copilot コネクタを使用すると、Azure DevOps サービスのインスタンスで wiki のインデックスを作成organization。コネクタを構成した後、エンドユーザーは、Microsoft Search および Microsoft 365 Copilot の DevOps Azureからプロジェクト Wiki とコード Wiki を検索できます。

この記事は、Microsoft 365 管理者、または DevOps Wiki Copilot コネクタAzureを構成、実行、監視するユーザーを対象とします。

重要

Azure DevOps Wiki Copilot コネクタでは、Azure DevOps クラウドサービスのみがサポートされます。 Azure DevOps Server 2019、TFS 2018、TFS 2017、TFS 2015、TFS 2013 はサポートされていません。

機能

Azure DevOps からの Wiki のインデックス作成
エンドユーザーがプロジェクト Wiki とコード Wiki に関連する質問を行えるようにします。
Copilot のセマンティック検索を使用して、ユーザーがキーワード、個人の好み、ソーシャル接続に基づいて関連するコンテンツを検索できるようにします。

制限事項

コネクタは、接続ごとに 1 つの ADO organizationのインデックスのみを作成します。

カスタムデータフィルター

Azure DevOps Wiki コネクタには、Copilot Search 用の次のカスタムデータフィルターが含まれています。

エリアパス
割り当て先

前提条件

organizationの Microsoft 365 テナントの Search 管理者である必要があります。
コネクタが Azure DevOps organizationに接続できるようにするには、OAuth 経由でサードパーティ製アプリケーションアクセスを有効にする必要があります。詳細については、セキュリティポリシーの管理に関するページを参照してください。

サービスアカウント: Azure DevOps に接続し、Azure DevOps Wiki Copilot コネクタが Wiki を定期的に更新できるようにするには、次のアクセス許可が付与されたサービスアカウントが必要です。サービスアカウントは、選択した認証方法に応じて、Microsoft 発行のサービスプリンシパル (フェデレーション資格情報認証用) またはサインインしている Microsoft 365 管理者アカウント (Microsoft Entra ID OAuth 認証用) のいずれかです。

アクセス許可名	アクセス許可の種類	以下に必須
プロジェクトレベルの情報を表示する	プロジェクトのアクセス許可	DevOps Wiki Azureクロール。このアクセス許可は、インデックスを作成する必要があるプロジェクトに必須です。

重要

クロールアカウントには Basic アクセスレベルが必要です。 Azure DevOps のアクセスレベルの詳細については、サポートされているアクセスレベルに関するページを参照してください。

はじめに

表示名の選択

表示名は、Copilot 内の各参照を識別するために使用され、ユーザーが関連付けられているファイルまたはアイテムを簡単に認識するのに役立ちます。表示名は、信頼されたコンテンツであることも示します。表示名は、コンテンツソースフィルターとしても使用されます。このフィールドには既定値がありますが、組織内のユーザーが認識しやすい名前にカスタマイズ可能です。

認証の種類を指定する

Azure DevOps から Wiki を認証および同期するには、サポートされている 2 つの方法のいずれかを選択します。

フェデレーション資格情報 (推奨) – クロールサービスアカウントとして Microsoft 発行のMicrosoft Entraサービスプリンシパルを使用します。 Azure DevOps でこのサービスプリンシパルに付与されるアクセス許可によって、コネクタでインデックスを作成できる内容が決まります。

Microsoft Entra ID OAuth – サインインしている Microsoft 365 管理者アカウントがクロールサービスアカウントとして機能する委任された OAuth を使用します。この場合、その管理者アカウントに割り当てられている Azure DevOps アクセス許可によって、コネクタでインデックスを作成できる内容が決まります。

フェデレーション資格情報 (推奨)

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

サービスプリンシパルアプリがプロビジョニングされていることを確認する

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

Microsoft Entra アプリにAzure DevOps プロジェクトへのアクセス権を付与する

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

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

フェデレーション資格情報認証を構成する

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

OAuth のMicrosoft Entra ID

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

Azure DevOps Wiki Copilot コネクタは、テナントのMicrosoft Entraに接続されている ADO organizationからのコンテンツにのみインデックスを付けます。 ADO organizationがアカウントMicrosoft Entra接続されていることを確認するには、次の手順を使用します。

DevOps Azureに移動し、必要なorganizationを選択します。
[ Organization settings] を選択します。
左側のナビゲーションウィンドウで、[全般] ヘッダーの下にある [ Microsoft Entra ] を選択します。
organizationがテナントのMicrosoft Entra アカウントに接続されていることを確認します。

Microsoft Entra ID アプリの登録を作成する

[Azure portal] に移動し、テナントの管理者資格情報でサインインします。
ナビゲーションウィンドウから [Microsoft Entra ID] ->[管理] ->[アプリの登録] に移動し、[新しい登録] を選択します。
アプリの名前を指定して、[登録] を選択します。
アプリケーション (クライアント) ID を書き留めます。この ID は、ADO organization内のプロジェクトへのアクセス権をMicrosoft Entraアプリに付与するために使用されます。
ナビゲーションウィンドウから [API アクセス許可] を開き、[アクセス許可の追加] を選択します。
[Azure DevOps] を選択し、[委任されたアクセス許可] を選択します。
次のアクセス許可を検索し、[ アクセス許可の追加] を選択します。
a. ID (読み取り)
b. コード (読み取り)
c. 権利 (読み取り)
d. プロジェクトとチーム (読み取り)
e. グラフ (読み取り)
f. MemberEntitlement Management (読み取り)
g. Wiki (読み取り)
[TenantName] に [管理者の同意を付与する] を選択し、[はい] を選択して確認します。
アクセス許可が "付与" 状態であることを確認します。
ナビゲーションウィンドウから [認証 ] を開きます。 [ Add a platform ] を選択し、[ Web] を選択します。 [リダイレクト URI] に次のいずれかの URI を追加します。
- M365 Enterprise の場合: https://gcs.office.com/v1.0/admin/oauth/callback
- M365 Government の場合: https://gcsgcc.office.com/v1.0/admin/oauth/callback
[暗黙的な許可とハイブリッドフロー] で、ID tokens (used for implicit and hybrid flows)のオプションをチェックし、[構成] をクリックします。
ナビゲーションウィンドウで、[管理] の [証明書とシークレット] を選択します。
[ 新しいクライアントシークレット ] を選択し、シークレットの有効期限を選択します。生成されたシークレット (Value) をコピーし、再度表示されないため保存します。
このクライアントシークレットとアプリケーション ID を使用して、コネクターを構成します。

ADO organization内のプロジェクトへのアクセス権をMicrosoft Entra アプリに付与する

次の手順を使用して、インデックスを作成する必要があるプロジェクトに必要なアクセス権をMicrosoft Entra アプリに提供する必要があります。

DevOps Azureに移動し、必要なorganizationを選択します。
[ Organization settings] を選択します。
左側のナビゲーションウィンドウで、[全般] ヘッダーの下にある [ Users ] を選択します。
[ Add users] を選択します。
アプリから取得したアプリケーション (クライアント) ID を "ユーザーまたはサービスプリンシパル" にコピーします。
Basicアクセスレベルを付与し、インデックスへのアクセスを許可するプロジェクトを選択します。また、アクセスを確保するために、Project Reader Azure DevOps グループ (または同等のもの) にを追加します。ユーザーに電子メールの招待を送信するオプションの選択を解除します。

[organization] を選択します

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

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

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

限定対象ユーザーに展開する

より幅広い対象ユーザーにロールアウトする前に Copilot やその他の Search サーフェスで検証する場合は、この接続を制限付きユーザーベースに展開します。制限付きロールアウトの詳細については、「段階的なロールアウト」を参照してください。

この時点で、DevOps Wiki のAzure接続を作成する準備ができました。 [作成] をクリックすると、Azure DevOps organizationから接続とインデックス Wiki を発行できます。

アクセス許可、データ包含ルール、スキーマ、クロール頻度などの他の設定については、ADO データに最適な内容に基づいて既定値が設定されています。既定値は次のとおりです。

ユーザー	説明
アクセス許可	データソース内のコンテンツにアクセスできるユーザーのみ。
ID のマッピング	Microsoft Entra ID を使用してマップされたデータソース ID。

コンテンツ	説明
サイトプロジェクト	すべてのプロジェクトにインデックスが作成されます。
プロパティの管理	既定のプロパティとそのスキーマをチェックするには、コンテンツに関するページを参照してください

同期	説明
増分クロール	頻度: 15 分ごと
フルクロール	頻度: 毎日

これらの値のいずれかを編集する場合は、"カスタムセットアップ" を選択する必要があります

カスタムセットアップ

カスタムセットアップは、上記の表に示した設定の既定値を編集する管理者向けです。 [カスタムセットアップ] オプションをクリックすると、[ユーザー]、[コンテンツ]、[同期] の 3 つのタブが表示されます。

ユーザー

アクセス許可

Azure DevOps Wiki Copilot コネクタは、このデータソースへのアクセス権を持つすべてのユーザーまたは唯一のユーザーに表示される検索アクセス許可をサポートします。 [すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックスデータが表示されます。 [このデータソースへのアクセス権を持つユーザーのみ] を選択すると、アクセス権を持つユーザーの検索結果にインデックスデータが表示されます。

注:

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

コンテンツ

プロジェクトの選択

この手順では、Azure DevOps Wiki Copilot コネクタを使用して、インデックスを作成するデータのスコープを指定します。その後、接続を選択して、organization全体または選択したorganization内の特定のプロジェクトにインデックスを作成できます。

organization全体にインデックスを付ける場合、organization内のすべてのプロジェクトの Wiki にインデックスが作成されます。新しいプロジェクトと Wiki は、作成後の次のクロール中にインデックスが作成されます。

個々のプロジェクトにインデックスを作成する場合は、選択したプロジェクト内の Wiki のみがインデックス付けされます。

プロパティを管理する

ここでは、Azure DevOps データソースから使用可能なプロパティを追加または削除したり、プロパティにスキーマを割り当てたり (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティックラベルを変更してプロパティにエイリアスを追加したりできます。既定で選択されているプロパティを次に示します。

Source プロパティ	Label	説明	Schema
ブロック	ブロック	データソース内のアイテムに参加/共同作業を行ったすべてのユーザーに名前を付けます	取得。
CommitId
コンテンツ	コンテンツ	Wiki のコンテンツ本文	検索。
GitItemPath
IconUrl	IconUrl	Wiki を表すアイコン URL	取得。
isParentPage
LastPublishedAuthorEmail	最終更新者		取得。
LastPublishedDate	最終更新日時	データソースでアイテムが最後に変更された日時	取得。
組織			取得。
Path
Project			取得。
ProjectId			取得。
RemoteURL	url	データソース内の Wiki の URL	取得。
タイトル	タイトル	Wiki ページのタイトル	検索、取得。
バージョン			取得。
WikiId			取得。
WikiIdentifier			取得。
WikiType

データのプレビュー

プレビュー結果ボタンを使用して、選択したプロパティのサンプル値を確認します。

同期

更新間隔によって、データソースと DevOps Wiki Copilot コネクタインデックスAzureの間でデータが同期される頻度が決まります。更新間隔には、フル更新とインクリメンタル更新の 2 種類があります。詳細については、「更新設定」を参照してください。

必要に応じて、ここから更新間隔の既定値を変更できます。

検索結果ページを設定する

接続を発行した後、バーティカルや結果の種類を使用して検索結果ページをカスタマイズする必要があります。検索結果のカスタマイズについては、垂直方向と結果の種類を管理する方法に関するページを参照してください。

Azure DevOps Wiki Copilot コネクタのサンプル結果レイアウトを使用することもできます。開始するには、結果レイアウト JSON をコピーして貼り付けます。

トラブルシューティング

接続を公開したら、管理センター の [コネクター] セクションで状態を確認できます。更新と削除を行う方法については、「接続を監視する」をご覧ください。

問題のトラブルシューティングについては、「トラブルシューティング」を参照してください。

Last updated on 2026-03-10