此页面由 Cloud Translation API 翻译。

更新架构

您可以更新包含支持架构的数据的任何数据的架构，例如结构化数据、包含结构化数据的网站数据或其他包含元数据的非结构化数据。

您可以在 Google Cloud 控制台中更新架构使用 schemas.patch API 方法。只能通过 REST API 更新网站架构。

如需更新架构，您可以添加新字段、更改字段的可编入索引、可搜索和可检索注释，或将字段标记为关键属性（例如 title、uri 和 description）。

更新架构

您可以在 Google Cloud 控制台中或使用 API 更新架构。

控制台

如需在 Google Cloud 控制台中更新架构，请按以下步骤操作：

查看要求和限制部分，检查则表示您的架构更新有效
如果您要更新字段注释（将字段设置为可编入索引、可检索、可动态生成 Facetable、可搜索或可填充），请参阅配置字段设置，了解每种注释类型的限制和要求。
检查您是否已完成数据注入。否则，您可能还无法修改架构。
在 Google Cloud 控制台中，前往 Agent Builder 页面。

Agent Builder
在导航菜单中，点击 Data Stores。
在名称列中，点击具有要更新。
点击 Schema 标签页可查看数据的架构。

如果这是您首次修改这些字段，此标签页可能为空。
点击修改按钮。
更新您的架构：
- 映射关键属性：在架构的关键属性列中，选择要将字段映射到的关键属性。例如，如果名为 details 始终包含文档的说明，映射该字段添加到键属性说明。
- 更新维度数量（高级）：您可以通过自定义矢量嵌入和自定义矢量嵌入， Vertex AI Search。请参阅高级：使用自定义嵌入。
- 更新字段注释：如需更新字段的注释，请选择或取消选择字段的注解设置可用的注释包括可检索、可编入索引、动态分面、可搜索和可填充。某些字段设置存在限制。如需了解每种注释类型的说明和要求，请参阅配置字段设置。
- 添加新字段：在导入包含这些字段的新文档之前，先将新字段添加到架构中，可以缩短 Vertex AI Agent Builder 在导入后重新编制数据索引所需的时间。
  1. 点击添加新字段以展开该部分。
  2. 点击 add_box Add node，然后为新字段指定设置。
    
    如需指明数组，请将数组设置为是。例如，如需添加字符串数组，请将 type 设置为 string，并将 Array 设置为 Yes。
    
    对于网站数据存储区索引，您添加的所有字段都是依据默认值。
点击保存以应用架构更改。

更改架构会触发重新编入索引。对于大型数据存储区，重新编制索引的流程可能需要几小时才能完成。

REST

如需使用 API 更新架构，请按以下步骤操作：

查看要求和限制以及限制示例（仅限 REST）部分，用于检查架构是否发生更改都有效。

如需更新包含网站或非结构化数据的数据存储区的架构，请使用请跳到第 5 步以调用 schema.patch 方法。
如果您要更新字段注解（将字段设置为可编入索引，可检索、动态分面或可搜索），查看配置每种注解类型的限制和要求。
如果您要修改自动检测的架构，请确保您已已完成数据注入。否则，该架构可能不可用修改。
查找数据存储区 ID。如果您已经有数据存储区 ID，请跳至下一步。
1. 在 Google Cloud 控制台中，前往 Agent Builder 页面，然后在导航菜单中点击数据存储区。
  
  转到“数据存储区”页面
2. 点击您的数据存储区的名称。
3. 在数据存储区的数据页面上，获取数据存储区 ID。

使用 schemas.patch 以 JSON 对象形式提供新 JSON 架构的 API 方法。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/schemas/default_schema" \
-d '{
  "structSchema": JSON_SCHEMA_OBJECT
}'

替换以下内容：

PROJECT_ID：您的 Google Cloud 项目的 ID。
DATA_STORE_ID：Vertex AI Search 数据存储区的 ID。

JSON_SCHEMA_OBJECT：您的新 JSON 架构（作为 JSON 对象）。例如：

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "keyPropertyMapping": "title"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "keyPropertyMapping": "category"
      }
    },
    "uri": {
      "type": "string",
      "keyPropertyMapping": "uri"
    }
  }
}

命令和结果示例

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/schemas/default_schema" -d '{
"structSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"title": {
"type": "string",
"keyPropertyMapping": "title"
},
"categories": {
"type": "array",
"items": {
"type": "string",
"keyPropertyMapping": "category"
}
},
"uri": {
"type": "string",
"keyPropertyMapping": "uri"
}
}
}
}'

{
"name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/schemas/default_schema/operations/update-schema-10569824819404198922",
"metadata": {
"@type": "type.googleapis.com/google.cloud.discoveryengine.v1.UpdateSchemaMetadata"
}
}

可选：按照查看架构定义中的步骤查看架构。