创建搜索应用

本页面介绍了如何创建搜索应用。

创建应用

控制台

如需使用 Google Cloud 控制台创建搜索应用，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，前往 AI Applications 页面。

    AI Applications

  2. 在应用 页面上，点击 创建应用 。

  3. 在 创建 应用 页面上，点击 在 AI 模式下搜索网站 下方的 创建。

  4. 确定是否要为此应用使用企业功能，然后点击相应开关以开启或关闭。您必须开启企业版功能，才能使用网站搜索和为应用选择区域等功能。企业版功能会产生额外费用。如需了解详情，请参阅 企业版功能。

  5. 确定是否要为此应用使用具有高级 LLM 功能的生成式回答，然后点击相应开关以开启或关闭。您必须启用 生成式回答 选项，才能使用 搜索摘要 或 跟进搜索 等功能。如需了解详情，请参阅 生成式回答。

  6. 在您的应用名称 字段中，为应用输入一个名称。

  7. 在贵公司或组织的外部名称 字段中，输入贵公司或组织的常用名称。请避免使用 Inc 或 LLC 等后缀。 此字段有助于 LLM 识别应用所代表的公司。

  8. 为应用选择位置。您必须开启企业功能才能选择位置。Google 建议您使用默认的 全球 (Global)，除非您有理由将数据限制在特定 地理位置。

  9. 点击继续 。

  10. 如需连接到数据存储区，请在数据存储区 页面上选择您之前创建的数据存储区，或创建一个新的数据存储区。

    请从下列选项中选择一项：

    • 选择现有数据存储区：如果您仅关联一个数据存储区，则以后无法移除该数据存储区或向应用添加其他数据存储区。关联多个数据存储区后，您可以稍后更新关联的数据存储区，但应用始终需要至少两个数据存储区。
    • 创建新的数据存储区并向其中注入数据：
      1. 点击 创建 数据存储区 ，然后按照创建新的数据存储区 页面中的步骤操作。
      2. 选择新的数据存储区，然后点击选择 。如需了解详情，请参阅创建搜索数据存储区。

REST

在通过命令行创建应用之前，您必须已有数据存储区。如果您没有数据存储区，请按照 创建数据存储区并为 Agent Search 注入数据中的步骤创建一个。

如需使用 engines.create 方法通过 命令行创建搜索应用，请按以下步骤操作：

  1. 查找您的数据存储区 ID。如果您已有数据存储区 ID，请跳至下一步。

    1. 在 Google Cloud 控制台中，前往 AI Applications 页面，然后 在导航菜单中点击 数据存储区。

      前往“数据存储区”页面

    2. 点击您的数据存储区的名称。

    3. 在数据存储区的数据 页面上，获取数据存储区 ID。

  2. 创建搜索应用并将其关联到数据存储区。一个数据存储区只能关联到一个应用，并且以后无法从应用中移除。

    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_ID"],
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "industryVertical": "GENERIC",
  "searchEngineConfig": {
     "searchTier": "SEARCH_TIER",
     "searchAddOns": ["SEARCH_ADD_ON"]
   }
}'

    替换以下内容：

    • PROJECT_ID：您的 Google Cloud 项目的 ID。
    • APP_ID：您要创建的 Agent Search 应用的 ID。
    • APP_DISPLAY_NAME：您要创建的 Agent Search 应用的显示名称。
    • DATA_STORE_ID：您要添加到 Agent Search 应用的现有 Agent Search 数据存储区的 ID。
    • SEARCH_TIER：搜索层级可以是 SEARCH_TIER_STANDARD 或 SEARCH_TIER_ENTERPRISE。 您必须使用 SEARCH_TIER_ENTERPRISE，才能使用网站搜索和为应用选择区域等功能。企业版功能会产生额外费用。如需了解详情，请参阅企业 版功能。

    • SEARCH_ADD_ON：如果您希望此应用使用具有高级 LLM 功能的生成式回答，请指定 SEARCH_ADD_ON_LLM。生成式回答包括 搜索摘要和 跟进搜索。

      如果您不希望使用生成式回答，请指定 SEARCH_ADD_ON_UNSPECIFIED 作为搜索插件，或移除 searchAddOns 字段。

      如需了解详情，请参阅 生成式回答。

Python

如需了解详情，请参阅 Agent Search Python API 参考文档。

如需向 Agent Search 进行身份验证，请设置应用默认凭据。如需了解详情，请参阅 为本地开发环境设置身份验证。 

from typing import List

from google.api_core.client_options import ClientOptions
from google.cloud import discoveryengine_v1 as discoveryengine

# TODO(developer): Uncomment these variables before running the sample.
# project_id = "YOUR_PROJECT_ID"
# location = "YOUR_LOCATION" # Values: "global"
# engine_id = "YOUR_ENGINE_ID"
# data_store_ids = ["YOUR_DATA_STORE_ID"]


def create_engine_sample(
    project_id: str, location: str, engine_id: str, data_store_ids: List[str]
) -> str:
    #  For more information, refer to:
    # https://cloud.google.com/generative-ai-app-builder/docs/locations#specify_a_multi-region_for_your_data_store
    client_options = (
        ClientOptions(api_endpoint=f"{location}-discoveryengine.googleapis.com")
        if location != "global"
        else None
    )

    # Create a client
    client = discoveryengine.EngineServiceClient(client_options=client_options)

    # The full resource name of the collection
    # e.g. projects/{project}/locations/{location}/collections/default_collection
    parent = client.collection_path(
        project=project_id,
        location=location,
        collection="default_collection",
    )

    engine = discoveryengine.Engine(
        display_name="Test Engine",
        # Options: GENERIC, MEDIA, HEALTHCARE_FHIR
        industry_vertical=discoveryengine.IndustryVertical.GENERIC,
        # Options: SOLUTION_TYPE_RECOMMENDATION, SOLUTION_TYPE_SEARCH, SOLUTION_TYPE_CHAT, SOLUTION_TYPE_GENERATIVE_CHAT
        solution_type=discoveryengine.SolutionType.SOLUTION_TYPE_SEARCH,
        # For search apps only
        search_engine_config=discoveryengine.Engine.SearchEngineConfig(
            # Options: SEARCH_TIER_STANDARD, SEARCH_TIER_ENTERPRISE
            search_tier=discoveryengine.SearchTier.SEARCH_TIER_ENTERPRISE,
            # Options: SEARCH_ADD_ON_LLM, SEARCH_ADD_ON_UNSPECIFIED
            search_add_ons=[discoveryengine.SearchAddOn.SEARCH_ADD_ON_LLM],
        ),
        # For generic recommendation apps only
        # similar_documents_config=discoveryengine.Engine.SimilarDocumentsEngineConfig,
        data_store_ids=data_store_ids,
    )

    request = discoveryengine.CreateEngineRequest(
        parent=parent,
        engine=engine,
        engine_id=engine_id,
    )

    # Make the request
    operation = client.create_engine(request=request)

    print(f"Waiting for operation to complete: {operation.operation.name}")
    response = operation.result()

    # After the operation is complete,
    # get information from operation metadata
    metadata = discoveryengine.CreateEngineMetadata(operation.metadata)

    # Handle the response
    print(response)
    print(metadata)

    return operation.operation.name

Terraform

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。 如需了解详情，请参阅 Terraform 提供方参考文档。

如需使用 Terraform 创建搜索应用，请参阅 discovery_engine_search_engine。

后续步骤