在网站上搜索图片

借助 Vertex AI Search，您可以使用包含网站数据的应用搜索图片。您可以以文本字符串或图片的形式提供查询，default_config.search 方法会针对该查询返回图片。

注意 ：Google Cloud 控制台不支持图片搜索。

准备工作

请确保您满足以下前提条件。具体要求因您是使用文本查询还是图片查询进行搜索而异。

• 如果您要在网站搜索应用中使用文本查询进行搜索，请确保已开启以下功能：企业版功能

• 如果您在网站搜索应用中使用图片查询进行搜索，请确保已开启以下功能：

  • 企业版功能

  • 高级网站索引编制

预览图片搜索

如需使用命令行预览网站的图片结果，请使用 engines.servingConfigs.search 方法：

注意：您可以使用 engines.servingConfigs.search 方法搜索应用，也可以使用 dataStores.servingConfigs.search 方法搜索数据存储区。对于以下过程，Google 建议使用 engines.servingConfigs.search 方法进行搜索。

1. 找到您的应用 ID。如果您已经有应用 ID，请跳至下一步。

   1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

      前往“应用”

   2. 在应用页面上，找到应用的名称，然后从 ID 列中获取应用的 ID。

2. 调用 engines.servingConfigs.search 方法，为 search_type 指定 1。选择方法语法取决于您的查询是文本字节还是图片字节。

   关键字：在 Vertex AI Search 中，应用一词在 API 上下文中可与引擎一词互换使用。

   查询是文本字符串

   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/APP_ID/servingConfigs/default_config:search" \
   -d '{
   "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
   "query": "QUERY",
   "pageSize": "PAGE_SIZE",
   "offset": "OFFSET",
   "params": {"search_type": 1}
   }'
   

   查询是图片

   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/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
   -d '{
   "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
   "imageQuery": {"imageBytes":"IMAGE_BYTES"},
   "pageSize": "PAGE_SIZE",
   "offset": "OFFSET",
   "params": {"search_type": 1}
   }'
   

   • PROJECT_ID：您的项目的 ID。

   • APP_ID：应用的 ID。

   • QUERY：搜索查询文本。例如，“圆形车灯汽车”或“给我展示带条纹的连衣裙”。

   • IMAGE_BYTES：Base64 编码的字节形式的图片。支持的格式包括 JPEG、PNG 和 BMP。

   • PAGE_SIZE：可选。搜索返回的结果数。网站搜索的默认值为 10。

     • 小于 0 的值会导致错误。
     • 大于 100 的值会导致该值被设为 100。

   • OFFSET：可选。结果的起始索引。 默认值为 0。

     例如，如果偏移量为 2 且页面大小为 10，则会返回第 2 条到第 11 条结果。

3. 查看回答。有关字段说明，请参阅下表：

   字段	说明
   title	包含相应图片的网页的纯文本标题
   htmlTitle	包含相应图片的网页的 HTML 标题
   displayLink	此搜索的结果网址的缩写版本，通常是域名，例如 www.example.com
   link	图片的网址
   image.contextLink	背景链接：指向包含图片的网页的网址
   image.byteSize	图片的大小（以字节为单位）
   image.width	图片的宽度（以像素为单位）
   image.height	图片的高度（以像素为单位）
   image.thumbnailWidth	缩略图的宽度（以像素为单位）
   image.thumbnailHeight	缩略图的高度（以像素为单位）
   image.thumbnailLink	缩略图的网址
   mime	图片的 MIME 类型
   fileFormat	图片的文件格式