Freshservice Microsoft 365 Copilot コネクタを使用すると、organizationで Freshservice ソリューションの記事データにインデックスを付け、Microsoft 365 Copilotおよび Microsoft Search で使用できるようにします。 この記事では、Freshservice コネクタをデプロイしてカスタマイズする手順について説明します。
前提条件
コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。
- Microsoft 365 管理者である必要があります。
- Freshservice アプリケーションで管理者権限を持つ Freshservice アカウントが必要です。
- Freshservice ユーザー プロファイル設定から API キーにアクセスできる必要があります。 詳細については、「 API キーの検索場所」を参照してください。
コネクタをデプロイする
organizationの Freshservice コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ コネクタ ] タブに移動し、左側のウィンドウで [ ギャラリー] を選択します。
- 使用可能なコネクタの一覧から [ Freshservice] を選択します。
表示名を設定する
表示名は、関連付けられたファイルまたはアイテムをユーザーが認識するのに役立つ Copilot 応答の参照を識別するために使用されます。 表示名は信頼されたコンテンツも示し、コンテンツ ソース フィルターとして使用されます。
既定の Freshservice 表示名をそのまま使用することも、値をカスタマイズして、organizationのユーザーが認識する表示名を使用することもできます。
コネクタの表示名と説明の詳細については、「 コネクタ コンテンツの Copilot 検出を強化する」を参照してください。
インスタンス URL の設定
Freshservice アカウントのドメイン URL を入力します。 一般的な構造は https://<yourdomain>.freshservice.com。
認証の種類を選択する
使用可能な認証の種類を選択し、Freshservice ユーザー プロファイル設定ページから取得した API キーを入力します。 使用可能な認証オプションは次のとおりです。
- API キー認証 (推奨)
ロールアウト
制限付き対象ユーザーにロールアウトするには、[制限対象ユーザー へのロールアウト] の横にあるトグルを選択し、コネクタをロールアウトするユーザーとグループを指定します。 詳細については、「 Copilot コネクタの段階的ロールアウト」を参照してください。
[ 作成] を 選択して接続をデプロイします。 Freshservice Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | 既定値 |
|---|---|
| ユーザー | すべての Microsoft 365 ユーザー (フォルダーの可視性が [すべて] に設定されているパブリック ソリューション記事の場合) |
| コンテンツ | [すべて] に表示されるフォルダーに格納されているソリューション記事 |
| 同期 | フル クロールスケジュール日 (既定値);スケジュールは必要に応じて調整できます |
これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションで状態を確認できます。
設定のカスタマイズ (省略可能)
Freshservice コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
フォルダーの可視性が [すべて ] に設定されているパブリック ソリューション記事のみが、Freshservice Copilot コネクタを使用してインデックスが作成されます。 これらのソリューション記事は、Microsoft Search または Copilot から、テナント内のすべての Microsoft 365 ユーザーに表示されます。
ID のマッピング
パブリック ソリューションの記事では、ID マッピングは必要ありません。 インデックス付きコンテンツはすべてユーザーがアクセスできます。
コンテンツ設定をカスタマイズする
クエリ文字列
既定のクエリ文字列は、可視性が [すべて] に設定された Freshservice フォルダーからすべてのパブリック ソリューションアーティクルを取得します。 必要に応じて、クエリ文字列をカスタマイズしてコンテンツをさらにフィルター処理できます。
プロパティの管理
Freshservice データ ソースからインデックスを作成するプロパティを管理できます。 次の表は、コネクタが既定でインデックスを作成するプロパティの一覧です。
| プロパティ | セマンティック ラベル | 説明 | スキーマ属性 |
|---|---|---|---|
| ID | 該当なし | ソリューション記事の一意の ID。 | 検索可能、取得可能 |
| url | url |
ソリューション記事の URL。 | 検索可能、取得可能 |
| タイトル | title |
ソリューション記事のタイトル。 | 検索可能、取得可能 |
| CreatedOn | createdDateTime |
ソリューションアーティクルが作成された時刻。 | 検索可能、取得可能 |
| LastModifiedOn | lastModifiedDateTime |
ソリューション記事が最後に変更された時刻。 | 検索可能、取得可能 |
| LastModifiedUser | lastModifiedBy |
ソリューション記事を最後に変更したユーザーの名前。 | 検索可能、取得可能 |
| FolderUrl | containedUrl |
ソリューション記事を含むフォルダーの URL。 | 検索可能、取得可能 |
| FolderName | containerName |
ソリューションアーティクルを含むフォルダーの名前。 | 検索可能、取得可能 |
| 設定元 | createdBy |
ソリューション記事を作成したユーザーの名前。 | 検索可能、取得可能 |
| CategoryName | フォルダーが属するカテゴリ。 | 検索可能、取得可能 | |
| DescriptionText | ソリューション記事の内容。 | 検索可能、取得可能 | |
| キーワード | ソリューション記事のキーワード。 | 検索可能、取得可能 | |
| タグ | ソリューション記事に関連付けられているタグ。 | 検索可能、取得可能 |
同期間隔をカスタマイズする
Freshservice コネクタでは、フル クロールのみがサポートされます。 フル クロールの既定のスケジュールは、毎日に設定されます。 これらのスケジュールは、データ更新のニーズに合わせて調整できます。
詳細については、「 同期設定のガイドライン」を参照してください。