アプリを作成する

このページでは、Gemini Enterprise app を作成する方法について説明します。

注: ウェブサイトのデータストアを Gemini Enterprise の検索アプリとアシスタント アプリに接続することはできません。

アプリを作成する

コンソール

1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
2. [アプリ] ページで、[アプリを作成] をクリックします。
3. [アプリ名] フィールドに、アプリの名前を入力します。
4. 自動生成されたアプリ ID を更新するには、[編集] をクリックします。アプリ ID は、アプリの作成後に更新できません。
5. [場所を選択] セクションで、[マルチリージョン] を選択します。データを特定の地域に制限する必要がある場合を除き、デフォルトのグローバル（Global）マルチリージョンを使用します。

6. 省略可。[詳細オプション] を開き、次の項目を構成します。

   1. [会社名] フィールドに、会社の表示名を入力します。株式会社や LLC などのサフィックスは省略してください。これにより、LLM はアプリが表す会社を識別できます。

   2. Google ドライブ データストアを接続する場合は、組織外のドキュメントをアプリで検索できるようにすることができます。この機能を有効にするには、[クロスドメインのドキュメントを含めます] チェックボックスをオンにします。

      警告: この機能を有効にすると、外部ドキュメントからのプロンプト インジェクションや検索結果の操作など、セキュリティ リスクが高まります。

7. [作成] をクリックします。

REST

コマンドラインを使用してアプリを作成する前に、既存のデータストアが必要です。データストアがない場合は、Google データソースまたはサードパーティ データソースをアプリに接続する必要があります。

engines.create メソッドを使用してコマンドラインからアプリを作成する手順は次のとおりです。

1. データストア ID を確認します。データストア ID がすでにある場合は、次のステップに進みます。

   1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動し、ナビゲーション メニューで [データストア] をクリックします。

      [データストア] ページに移動

   2. データストアの名前をクリックします。

   3. データストアの [データ] ページで、データストア ID を取得します。

2. アプリを作成し、データストアに接続します。

   重要な用語: Gemini Enterprise では、API のコンテキストで「アプリ」という用語と「エンジン」という用語を同じ意味で使用できます。Gemini Enterprise エンジンは、app_type フィールドが APP_TYPE_INTRANET に設定されている汎用検索エンジンです。

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ENTITY_ID_1", "DATA_STORE_ENTITY_ID_2", "DATA_STORE_ENTITY_ID_3"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   

   次のように置き換えます。

   • PROJECT_ID: 実際のプロジェクトの ID。
   • APP_ID: 作成するアプリの ID。
   • APP_DISPLAY_NAME: 作成するアプリの表示名。
   • DATA_STORE_ENTITY_ID: データストアにエンティティが含まれている場合は、特定のエンティティ ID を使用します。データストアにエンティティが含まれていない場合は、データストア ID を使用します。

   JSON ペイロードには、次のオプション構成を含めることができます。

   • 会社の表示名を入力するには、次の情報を入力します。

     "commonConfig": {
       "companyName": "COMPANY_NAME"
     }
     

     COMPANY_NAME は、会社の表示名に置き換えます。株式会社や LLC などのサフィックスは省略してください。

   • Google ドライブ データストアを接続する場合は、組織外のドキュメントの検索とインデックス登録をアプリに許可できます。この機能を有効にするには、JSON ペイロードに次の内容を含めます。

     "includeCrossDomainDocuments": true
     

     警告: この機能を有効にすると、外部ドキュメントからのプロンプト インジェクションや検索結果の操作など、セキュリティ リスクにさらされる可能性が高まります。

   コマンドの例と結果

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "my-app",
     "dataStoreIds": ["slack_1234567890123_conversation", "slack_1234567890123_file", "slack_1234567890123_message"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "industryVertical": "GENERIC",
     "appType": "APP_TYPE_INTRANET"
   }'
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/operations/create-engine-12345678901234567890",
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.Engine",
       "name": "projects/123456/locations/global/collections/default_collection/engines/my-app",
       "displayName": "my-app",
       "dataStoreIds": [
         "slack_1234567890123_conversation",
         "slack_1234567890123_file",
         "slack_1234567890123_message"
       ],
       "solutionType": "SOLUTION_TYPE_SEARCH",
       "searchEngineConfig": {
         "searchTier": "SEARCH_TIER_STANDARD"
       },
       "industryVertical": "GENERIC",
       "appType": "APP_TYPE_INTRANET"
     }
   }
   

次のステップ

• アプリを既存のデータストアに接続する。アプリを既存のデータストアに接続するをご覧ください。

• データソースを接続する。Google データソースを接続するとサードパーティ データソースを接続するをご覧ください。

• 検索結果をプレビューするには、Google Cloud コンソールの [構成] > [検索 UI] に移動するか、StreamAssist から検索結果を取得するをご覧ください。

• ウェブアプリを構成する（モデル セレクタや画像生成ツールなどの設定をオンまたはオフにするなど）には、ウェブアプリの機能を管理するをご覧ください。