Genie検索のセットアップ
Genie Searchは、組織がナレッジを保管しているソース(Google Drive、Jira、Confluence、Workday)全体で検索インデックスを構築および維持します。Databricksは、ドキュメントの権限とともにコンテンツを取り込んでインデックスを作成し、変更されるたびに両方を最新の状態に保ちます。
Genie Searchを使用すると、Genieは各ソースを個別にクエリする代わりに、接続されたすべてのソースをカバーするインデックスを検索します。また、Genie Searchは、Genie OntologyをDatabricks以外に拡張し、Genieが質問に回答するときに、ドキュメントやチケットをコンテキストとして利用できるようにします。ユーザーは、ソースで既に開くことができるコンテンツのみを表示できます。
Workdayは、Genie Oneの組織ディレクトリの機能も提供します。「 Genie Oneの人物ソースを接続する」を参照してください。
要件
- Databricksアカウント管理者権限
- 接続する各ソースの管理者(Google ワークスペース 管理者や Atlassian 管理者など)で、アクセスを承認します。これは、Databricksアカウント管理者とは別の人物である可能性があります。
サポートされているソース
Genie検索は、次のソースにインデックスを付けます。
ソース | インデックス作成の対象 | 認証方法 |
|---|---|---|
Google Drive | Google ワークスペース ファイル、Microsoft Office ファイル、PDF、およびテキストファイル。サポートされているファイルタイプについては、制限事項を参照してください。 | ドメイン全体の委任を備えたGoogle Cloudサービスアカウント |
Jira クラウド | 認可ユーザーがアクセスできるすべてのプロジェクト | 独自のAtlassian OAuth 2.0アプリ |
Confluence クラウド | 承認ユーザーが表示可能なすべてのスペース | 独自のAtlassian OAuth 2.0アプリ |
Workday | Genie Oneの組織ディレクトリ用のカスタムWorkday Reports-as-a-Service(RaaS)レポートからのワーカープロファイル | Genie Oneのユーザーソースを接続するを参照してください。 |
ソースの接続
アカウントコンソールから各接続を起動します。
- アカウントコンソールで、 Genieオントロジー をクリックします。
- 「 ソースを接続 」をクリックします。
- ソースを選択します。
- 「 データの場所(Geo) 」で、ソースのインデックスが格納されているGeoを選択します。アカウントにワークスペースがあるGeoのみを選択できます。アカウントに既にソースがある場合は、同じGeoを選択します。ストレージと場所を参照してください。
次に、ソースのステップを完了します。
- Google Drive
- Jira
- Confluence
- Workday
サービスアカウントを作成できる Google Cloudプロジェクトと、Google管理コンソールでドメイン全体の委任を付与できる Google ワークスペース管理者の両方が必要です。
-
サービスアカウントとJSONキーを作成します。
- Google Cloudコンソールで、「 IAM & 管理 > サービスアカウント 」に移動します。
- 「サービスアカウントの作成」 をクリックします。
- サービスアカウントの名前と説明を入力し、 作成して続行 をクリックします。
- 「 完了 」をクリックします。プロジェクトレベルのロールを付与する必要はありません。
- サービス アカウント ページで、作成したサービス アカウントをクリックします。
- キー タブで、 キーの追加 > 新しいキーの作成 をクリックします。
- JSON を選択し、 作成 をクリックします。JSON キー ファイルがマシンに download されます。
-
サービスアカウントが使用するGoogle APIを有効にします。
- Google Cloudコンソールで、 APIs & サービス > ライブラリ に移動します。
- Google Drive API を検索し、それをクリックして、 有効にする をクリックします。
- Admin SDK API を検索してクリックし、 有効化 をクリックします。
-
ドメイン全体の委任を許可する:
-
Google Cloudコンソールの 詳細 tabから、サービスアカウントの 一意のID (クライアントID)をコピーします。
-
Google管理コンソールで、 セキュリティ > アクセスとデータ制御 > APIコントロール に移動します。
-
「ドメイン全体への委任」 で、 「ドメイン全体への委任を管理」 をクリックします。
-
新規追加 をクリックします。
-
クライアント ID に、サービスアカウントの一意の ID を貼り付けます。
-
「 OAuthスコープ 」に、次の読み取り専用スコープをコンマ区切りで入力します。
Texthttps://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.reports.audit.readonly -
許可 をクリックします。
-
-
Databricksの 「Googleドライブを接続」 ダイアログで、開始および終了の括弧を含むJSONキーの内容全体を 「サービスアカウントJSON」 に貼り付けます。
-
「 管理者Eメール 」に、ユーザー、グループ、共有ドライブの閲覧権限を持つGoogle ワークスペース管理者のEメールアドレスを入力します。サービスアカウントはこの管理者として動作します。
-
取り込みを起動 をクリックします。
委任、API、またはスコープのステップをスキップすると、その設定を完了するまで、取り込みが失敗したり、コンテンツを見逃したりする可能性があります。
接続を認証するユーザーは、ADMINISTER JIRA と BROWSE USERS AND GROUPS のグローバル権限を持っている必要があります。Atlassianドキュメントの「グローバル権限」を参照してください。
-
[Jiraの接続] ダイアログで、コールバックURLをコピーします。
-
Atlassian開発者コンソールで、「 Create > OAuth 2.0 integration 」をクリックし、名前を入力して「 Create 」をクリックします。代わりに既存のOAuthアプリを使用するには、それを開いて、以下のステップでスコープとコールバックURLを追加します。
-
権限 > Jira API に移動し( APIスコープ 配下)、 追加 をクリックします。
-
「クラシック スコープ」>「スコープの編集」 をクリックし、
read:jira-workとread:jira-userを追加します。 -
きめ細かなスコープ > スコープの編集 をクリックし、次のスコープを追加します。
read:project-role:jiraread:project-category:jiraread:project:jiraread:user:jiraread:avatar:jiraread:group:jiraread:application-role:jiraread:workflow:jiraread:issue-security-level:jiraread:issue-security-scheme:jiraread:audit-log:jiraread:sprint:jira-softwareread:board-scope:jira-softwareread:board-scope.admin:jira-software
-
「 認可 」に移動し、「 追加 」をクリックして、コピーしたコールバックURLを入力します。
-
設定 に移動し、 クライアント ID と シークレット をコピーします。
-
Jiraの接続 ダイアログで、
https://を含む JiraサイトURL を入力します。たとえば、https://yourcompany.atlassian.netなどです。パスや末尾のスラッシュを追加しないでください。 -
OAuthアプリの クライアントID と クライアントシークレット を入力します。
-
「 認証 」をクリックしてJiraサイトを選択し、「 同意 」をクリックします。
-
取り込みを起動 をクリックします。
接続を許可するユーザーは、 CONFLUENCE ADMINISTRATOR のグローバル権限を持ち、インデックスを作成するすべてのスペースにアクセスできる必要があります。詳細は、 Atlassian のドキュメントにある グローバル権限の管理を参照してください。
-
Confluenceに接続 ダイアログで、コールバックURLをコピーします。
-
Atlassian開発者コンソールで、「 Create > OAuth 2.0 integration 」をクリックし、名前を入力して「 Create 」をクリックします。代わりに既存のOAuthアプリを使用するには、それを開いて、以下のステップでスコープとコールバックURLを追加します。
-
権限 > Confluence API ( API スコープ の下)に移動し、 追加 をクリックします。
-
きめ細かなスコープ > スコープの編集 をクリックし、次のスコープを追加します。
read:page:confluenceread:attachment:confluenceread:space:confluenceread:configuration:confluenceread:label:confluenceread:space.permission:confluenceread:content.permission:confluenceread:content-details:confluenceread:group:confluenceread:user:confluenceread:audit-log:confluence
-
「 認可 」に移動し、「 追加 」をクリックして、コピーしたコールバックURLを入力します。
-
設定 に移動し、 クライアント ID と シークレット をコピーします。
-
Connect Confluence ダイアログで、
https://なしで Confluence サイトドメイン を入力します。たとえば、yourcompany.atlassian.net。 -
OAuthアプリの クライアントID と クライアントシークレット を入力します。
-
承認 をクリックし、Confluenceサイトを選択して、 承認 をクリックします。
-
取り込みを起動 をクリックします。
組織ディレクトリのためにWorkdayを接続するには、Genie Oneのユーザーソースを接続するを参照してください。
インデックスの初回作成には、ソースのコンテンツ量に応じて数時間から数日かかる場合があります。インデックスの作成が完了するまで、ソースのステータスは プロビジョニング中 となり、その後 検索可能 になります。セットアップに失敗した場合、ステータスは 失敗 になります。
インデックス作成済みコンテンツを使用する
ソースが 検索可能 になると、Genie One チャットは質問に回答する際に自動的に Genie Search を使用します。ユーザーは、Genie One Discover でインデックス化されたコンテンツを Databricks アセットとともに見つけることもできます。Genie One で Genie Search を使用するを参照してください。
Genie検索およびMCPコネクタ
Genie Searchと Model Context Protocol (MCP) コネクタは連携して動作するため、Databricksでは、チームが依存しているソースに対して両方を有効にすることを推奨しています。Genie Searchを使用すると、Genieはアカウント管理者がインデックスを作成したすべてを1か所で検索できます。MCPコネクタを使用すると、各ユーザーはGmailやSlackなどのアプリケーションに独自の資格情報で接続できます。これにより、Genie Oneはライブ情報を検索し、Eメールの下書き、Slackチャンネルへの投稿、Jiraチケットの更新などのアクションを実行できるようになります。
両方が有効になっている場合、Genieは各リクエストに適合するアプローチを選択します。たとえば、Genie Searchを使用してリリースに関する設計ドキュメント、Wiki、チケットを検索し、Atlassianコネクタを使用して関連するJiraチケットを更新できます。
観点 | Genie検索 | MCPコネクタ |
|---|---|---|
設定 | アカウント管理者は、アカウント全体で各ソースに1回接続します。 | 各ユーザーは、独自の資格情報で各コネクタにサインインします。 |
検索 | 接続されているすべてのソースにわたって、インデックス化されたすべてのコンテンツを同時に検索します。 | 各ソースをライブでクエリーします。Genieは、各リクエストで呼び出すコネクタを選択します。 |
鮮度 | 次回のインデックス更新後の変更を表示します。 | ソースの現在の状態を返します。 |
アクション | 読み取り専用。 | ユーザーとしてアプリケーション内のコンテンツを作成および更新します。アクションを記述するを参照してください。 |
権限 | 各ドキュメントのソース権限を適用します。権限はコンテンツとともに更新され、非公開ドキュメントはクエリー実行時に再チェックされます。 | アプリケーションでユーザー自身の権限を使用します。 |
ガバナンス | アカウント管理者は、アカウントコンソールの Genie オントロジー ページで各ソースを管理します。 | 管理者は、Unity Gatewayのコネクタ、ツール、ポリシーを制御します。MCPの管理をご覧ください。 |
ソース | Googleドライブ、Jira、Confluence、Workday。 | Databricks が提供するコネクタとカスタム MCP サービス。MCP を使用して Genie One を外部アプリケーションに接続するを参照してください。 |
ソースを管理する
アカウント管理者は、アカウントコンソールの「 Genieオントロジー 」ページで接続されたソースを管理します。
Google ドライブ、Jira、または Confluence ソースの提供を停止し、インデックス化されたコンテンツを削除せずに保持するには、 有効 スイッチをオフにします。Genieはソースの使用を停止します。後でオンに戻すことができます。
Google ドライブ、Jira、または Confluence ソースの資格情報を入れ替えて、インデックス化されたコンテンツを削除せずに保持するには、ソースの行にある ケバブメニューをクリックし、 再承認 をクリックします。資格情報を無効にするには、ソースを削除します。
ソースを削除するには:
- ソース行の
ケバブメニューをクリックします。
- ソースの削除 をクリックします。
- 確認。取り込みが停止され、インデックス付きコンテンツが削除され、再接続には完全な取り込みが必要になります。
Genie検索でデータがどのように処理されるか
Genie Searchは、インデックスが作成されたコンテンツとその権限のコピーをDatabricksに保存します。以降のセクションでは、そのデータの保存場所、ソースの資格情報と権限の処理方法、データの保持期間について説明します。
ストレージとロケーション
各アカウントには専用のカタログがあり、各ソースには独自の検索インデックスがあります。インデックスデータはデータプレーンに保存され、他の顧客から分離されます。
インデックス化されたデータは単一のジオに保持され、アカウント管理者がソースを接続するときにジオを選択します。アカウント内のすべてのソースは同じジオを使用します。ユーザーは、そのジオ内の任意のワークスペースからインデックス化されたデータにクエリーを実行でき、他のジオ内のワークスペースからのクエリーはブロックされます。アカウントレベルの Genie One チャットは、リージョンが同じジオにある場合、インデックス化されたデータを使用できます。
資格情報
ソースを接続するときに指定する認証情報は、Databricks管理アカウントの Unity Catalog 接続に保存されます。Databricksは、お客様が承認したデータを取り込むためだけにそれを使用します。認証情報を置き換えまたは取り消すには、ソースの管理を参照してください。
権限
Databricksは、各ドキュメントのアクセス許可をコンテンツとともに取り込み、Genieが結果を取得する際に適用します。これにより、ユーザーはソースで既にアクセスできるコンテンツのみを表示できるようになります。
権限はコンテンツと同じタイミングで更新されます。スケジュールの間隔はソースによって異なり、ソースAPIの制限やデータ量などの要因によって決定されます。非公開ドキュメントの場合、Genie検索はクエリー実行時に短いキャッシュを使用してソースに対するアクセス権も再確認します。
例外は組織のディレクトリです。アカウントでGenie Oneを使用するすべてのユーザーに、同じプロファイルの詳細が表示されます。「取り込まれるデータ」を参照してください。
保持と削除
ソースで削除されたコンテンツは、次の更新時にインデックスから削除されます。ソースのインデックスデータをすべて削除するには、ソースを削除します。後で再接続すると、完全な取り込みが必要になります。データを削除せずにソースの使用を停止するには、代わりにソースをオフにします。ソースの管理を参照してください。
制限
Genie検索には、次の制限が適用されます。
-
Genie検索はAWS GovCloudリージョンでは利用できません。
-
Genie SearchコンテンツはGenie Oneでのみ利用可能です。Genie Codeはこれを使用しません。
-
特定の Google Drive フォルダ、Jira プロジェクト、Confluence スペースなど、ソースからコンテンツを除外することはできません。
-
Google Drive は以下のファイルタイプのみをインデックス化します。画像や動画など、他のファイルはスキップされます。
- Googleドキュメント、Googleスプレッドシート、Googleスライド
- Microsoft Word (
.docおよび.docx) - Microsoft Excel (
.xlsおよび.xlsx) - Microsoft PowerPoint (
.pptおよび.pptx) - PDF(
.pdf) - プレーンテキスト (
.txt) - Markdown (
.md) - リッチテキスト形式 (
.rtf) - CSV (
.csv)
-
100 MB を超える Google ドライブのファイルはスキップされ、10 MB を超えるファイルのメタデータのみが保持されます。
-
PDF は抽出テキストからインデックス付けされ、光学文字認識 (OCR) は行われません。
-
Jira クラウドとConfluence クラウドのみがサポートされています。オンプレミスのJiraとConfluenceはサポートされていません。
-
JiraおよびConfluenceの結果は各項目のアクセス権限に従いますが、Genie検索はユーザーが現在JiraまたはConfluenceのライセンスを持っているかどうかをチェックしません。
-
ソースを管理するためのAPIはありません。設定はアカウントコンソールで行います。
-
アカウント内のすべてのソースは同じ地理的領域を使用します。地理的領域を変更するには、すべてのソースを削除してから再接続します。
価格
現時点では、顧客はGenie Searchの費用を負担する必要はありません。ただし、Databricksはいつでも通知を行うか、または価格ページを更新することで、この機能の価格を変更する場合があります。