在网站上搜索图片

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

准备工作

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

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

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

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

      前往“应用”

    2. 在应用页面上，找到应用的名称，并从以下位置获取应用 ID： ID 列中的值。

  2. 调用 engines.servingConfigs.search 方法，为 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/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 图片的文件格式