自定义和部署 Google 模板

设计画布

1. 在 Google Cloud 控制台中，前往 Google 模板页面。

   前往 Google 模板

2. 在 生成式 AI RAG with Cloud SQL 模板卡片上，点击预览和自定义。

   模板会在设计画布中打开。

3. 点击复制并自定义。

4. 在创建新模板对话框中，输入以下详细信息：

   1. 在模板 ID 字段中，输入 quickstart-custom-gen-ai-rag。

   2. 在模板名称字段中，输入 Quickstart custom Generative AI RAG。

   3. 在说明字段中，输入 A custom template copied from the Generative AI RAG with Cloud SQL template.

   4. 点击创建模板。

   模板会复制到您的空间，并显示在设计画布中。

5. 在设计画布中，点击配置应用。

6. 点击创建新应用，然后输入以下详细信息：

   1. 在名称字段中，输入 quickstart-custom-gen-ai-rag-test。

   2. 在显示名称字段中，输入 Quickstart custom Generative AI RAG test。

   3. 从区域列表中，选择 us-central1 (Iowa)。

   4. 从环境列表中，选择 Test。

   5. 从严重性列表中，选择 Low。

7. 点击创建应用。

   系统会创建应用草稿。

gcloud CLI

1. 过滤 Google 目录中的共享模板，找到 gen-ai-rag-with-sql 模板的修订版本 URI。

   gcloud design-center spaces shared-templates list \
     --google-catalog \
     --location=LOCATION \
     --filter="displayName:gen-ai-rag-cloud-sql"
   

   替换以下内容：

   • LOCATION：您的空间位置。 例如 us-central1。

   从输出中识别修订版本 URI。

2. 根据相应模板修订版本创建应用草稿。

   gcloud design-center spaces applications create quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --source-shared-template-revision-uri=SHARED_TEMPLATE_REVISION_URI \
     --display-name="Quickstart custom Generative AI RAG test" \
     --environment-type=test \
     --criticality-type=low \
     --scope-type=regional \
     --deployment-region=LOCATION
   

   替换以下内容：

   • SPACE：您的空间 ID。例如 default-space。
   • PROJECT：您的项目 ID。
   • SHARED_TEMPLATE_REVISION_URI：模板的修订版本 URI。例如 projects/gcpdesigncenter/locations/us-central1/spaces/googlespace/sharedTemplates/f8ddfbd3-6393-4a1e-942c-aaa7292fa30c/revisions/r-28。

设计画布

1. 在设计画布中，点击 frontend-service，然后在配置区域中执行以下操作：

   1. 在服务名称字段中，输入 custom-rag-frontend。

   2. 点击保存。

2. 在设计画布中，点击 retrieval-service，然后在配置区域中执行以下操作：

   1. 在服务名称字段中，输入 custom-retrieval-service。

   2. 点击保存。

3. 在设计画布中，点击 database-postgresql，然后在配置区域中执行以下操作：

   1. 在名称字段中，输入 custom-rag-database。

   2. 点击保存。

4. 在设计画布中，点击 vertex-ai，然后在配置区域中执行以下操作：

   1. 在项目 ID 列表中，确保已选择您的项目。

   2. 点击保存。

5. 在设计画布中，点击 secret-manager，然后在配置区域中执行以下操作：

   1. 在名称字段中，输入 db-ai-secret。

   2. 点击保存。

画布会在每个组件中显示一个绿色对勾标记，表示所有必需的参数均已配置。

gcloud CLI

1. 描述应用以确定组件参数。

   gcloud design-center spaces applications describe quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --format='yaml(name,componentParameters)'
   

   输出会显示每个组件的参数。

2. 获取组件 URI 的列表。

   gcloud design-center spaces applications describe quickstart-custom-gen-ai-rag-test \
     --space=SPACE \
     --location=LOCATION \
     --project=PROJECT \
     --format='value(serializedApplicationTemplate.components.uri)'
   

3. 在工作目录中创建配置 JSON 文件。

   1. 创建 custom-frontend.json。

      {
         "component": "FRONTEND_COMPONENT_URI",
         "parameters": [
            {
               "key": "service_name",
               "value": "custom-rag-frontend"
            },
            {
               "key": "PROJECT",
               "value": "PROJECT"
            },
            {
               "key": "location",
               "value": "LOCATION"
            }
         ]
      }
      

   2. 创建 custom-retrieval.json。

      {
         "component": "RETRIEVAL_COMPONENT_URI",
         "parameters": [
            {
               "key": "service_name",
               "value": "custom-retrieval-service"
            },
            {
               "key": "project_id",
               "value": "PROJECT"
            },
            {
               "key": "location",
               "value": "LOCATION"
            }
         ]
      }
      

   3. 创建 custom-database.json。

      {
         "component": "DATABASE_COMPONENT_URI",
         "parameters": [
            {
               "key": "name",
               "value": "custom-rag-database"
            },
            {
               "key": "project_id",
               "value": "PROJECT"
            },
            {
               "key": "database_version",
               "value": "POSTGRES_15"
            },
            {
               "key": "region",
               "value": "us-central1"
            },
            {
               "key": "zone",
               "value": "us-central1-a"
            }
         ]
      }
      

   4. 创建 custom-secmanager.json。

      {
      "component": "SECRET_MANAGER_COMPONENT_URI",
      "parameters": [
         {
            "key": "name",
            "value": "db-ai-secret"
         },
         {
            "key": "project_id"