New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« 语义搜索 教程：使用 semantic_text 进行混合搜索 »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›搜索您的数据 ›语义搜索

教程：使用 semantic_text 进行语义搜索

编辑

教程：使用 semantic_text 进行语义搜索

编辑

此功能处于 Beta 测试阶段，可能会发生更改。其设计和代码不如正式 GA 功能成熟，并且按“原样”提供，不提供任何保证。Beta 功能不受官方 GA 功能的支持 SLA 的约束。

本教程将向您展示如何使用语义文本功能对您的数据执行语义搜索。

语义文本通过在摄取时提供推理和自动提供合理的默认值来简化推理工作流程。您无需定义模型相关设置和参数，或创建推理摄取管道。

在 Elastic Stack 中使用语义搜索的推荐方法是遵循 semantic_text 工作流程。当您需要更多地控制索引和查询设置时，您仍然可以使用完整的推理工作流程（请参阅此教程以查看该过程）。

本教程使用 elasticsearch 服务进行演示，但您可以使用任何服务及其推理 API 提供的支持模型。

要求

编辑

本教程使用 elasticsearch 服务进行演示，该服务会在需要时自动创建。要将 semantic_text 字段类型与 elasticsearch 服务以外的推理服务一起使用，您必须使用创建推理 API创建推理端点。

创建索引映射

编辑

必须创建目标索引的映射，该索引包含推理端点将根据您的输入文本生成的嵌入。目标索引必须有一个字段，其字段类型为 semantic_text，用于索引所用推理端点的输出。

const response = await client.indices.create({
  index: "semantic-embeddings",
  mappings: {
    properties: {
      content: {
        type: "semantic_text",
      },
    },
  },
});
console.log(response);
PUT semantic-embeddings
{
  "mappings": {
    "properties": {
      "content": { 
        "type": "semantic_text" 
      }
    }
  }
}
Copy as curlTry in Elastic 

包含生成的嵌入的字段名称。

包含嵌入的字段是一个 semantic_text 字段。由于未提供 inference_id，因此使用 elasticsearch 服务的默认端点 .elser-2-elasticsearch。要使用不同的推理服务，您必须首先使用创建推理 API创建一个推理端点，然后在 semantic_text 字段映射中使用 inference_id 参数指定它。

如果您使用网络爬虫或连接器来生成索引，则必须更新这些索引的索引映射，以包含 semantic_text 字段。更新映射后，您需要运行完整的网络爬网或完整的连接器同步。这可确保重新处理所有现有文档并使用新的语义嵌入进行更新，从而在更新后的数据上启用语义搜索。

加载数据

编辑

在此步骤中，您加载稍后用于从中创建嵌入的数据。

使用 msmarco-passagetest2019-top1000 数据集，该数据集是 MS MARCO Passage Ranking 数据集的子集。它包含 200 个查询，每个查询都附带一个相关文本段落列表。所有唯一的段落及其 ID 都已从该数据集中提取并编译到 tsv 文件中。

下载该文件并使用机器学习 UI 中的数据可视化工具将其上传到您的集群。分析您的数据后，单击覆盖设置。在编辑字段名称下，将 id 分配给第一列，将 content 分配给第二列。单击应用，然后单击导入。将索引命名为 test-data，然后单击导入。上传完成后，您将看到一个名为 test-data 的索引，其中包含 182,469 个文档。

重新索引数据

编辑

通过将数据从 test-data 索引重新索引到 semantic-embeddings 索引，从文本中创建嵌入。content 字段中的数据将被重新索引到目标索引的 content 语义文本字段中。重新索引的数据将由与 content 语义文本字段关联的推理端点进行处理。

resp = client.reindex(
    wait_for_completion=False,
    source={
        "index": "test-data",
        "size": 10
    },
    dest={
        "index": "semantic-embeddings"
    },
)
print(resp)
const response = await client.reindex({
  wait_for_completion: "false",
  source: {
    index: "test-data",
    size: 10,
  },
  dest: {
    index: "semantic-embeddings",
  },
});
console.log(response);
POST _reindex?wait_for_completion=false
{
  "source": {
    "index": "test-data",
    "size": 10 
  },
  "dest": {
    "index": "semantic-embeddings"
  }
}
Copy as curlTry in Elastic 

重新索引的默认批处理大小为 1000。将大小减小为较小的数字可以加快重新索引过程的更新，这使您可以密切关注进度并尽早检测到错误。

该调用返回一个任务 ID 来监控进度

resp = client.tasks.get(
    task_id="<task_id>",
)
print(resp)
const response = await client.tasks.get({
  task_id: "<task_id>",
});
console.log(response);
GET _tasks/<task_id>
Copy as curlTry in Elastic 

重新索引大型数据集可能需要很长时间。您可以使用数据集的子集来测试此工作流程。为此，请取消重新索引过程，并且仅为重新索引的子集生成嵌入。以下 API 请求将取消重新索引任务

resp = client.tasks.cancel(
    task_id="<task_id>",
)
print(resp)
const response = await client.tasks.cancel({
  task_id: "<task_id>",
});
console.log(response);
POST _tasks/<task_id>/_cancel
Copy as curlTry in Elastic 

语义搜索

编辑

使用嵌入丰富数据集后，您可以使用语义搜索查询数据。在 semantic 查询类型中提供 semantic_text 字段名称和查询文本。用于为 semantic_text 字段生成嵌入的推理端点将用于处理查询文本。

resp = client.search(
    index="semantic-embeddings",
    query={
        "semantic": {
            "field": "content",
            "query": "How to avoid muscle soreness while running?"
        }
    },
)
print(resp)
const response = await client.search({
  index: "semantic-embeddings",
  query: {
    semantic: {
      field: "content",
      query: "How to avoid muscle soreness while running?",
    },
  },
});
console.log(response);
GET semantic-embeddings/_search
{
  "query": {
    "semantic": {
      "field": "content", 
      "query": "How to avoid muscle soreness while running?" 
    }
  }
}
Copy as curlTry in Elastic 

您要在其上执行搜索的 semantic_text 字段。

查询文本。

因此，您会收到 semantic-embedding 索引中与查询含义最接近的前 10 个文档

"hits": [
  {
    "_index": "semantic-embeddings",
    "_id": "Jy5065EBBFPLbFsdh_f9",
    "_score": 21.487484,
    "_source": {
      "id": 8836652,
      "content": {
        "text": "There are a few foods and food groups that will help to fight inflammation and delayed onset muscle soreness (both things that are inevitable after a long, hard workout) when you incorporate them into your postworkout eats, whether immediately after your run or at a meal later in the day. Advertisement. Advertisement.",
        "inference": {
          "inference_id": "my-elser-endpoint",
          "model_settings": {
            "task_type": "sparse_embedding"
          },
          "chunks": [
            {
              "text": "There are a few foods and food groups that will help to fight inflammation and delayed onset muscle soreness (both things that are inevitable after a long, hard workout) when you incorporate them into your postworkout eats, whether immediately after your run or at a meal later in the day. Advertisement. Advertisement.",
              "embeddings": {
                (...)
              }
            }
          ]
        }
      }
    }
  },
  {
    "_index": "semantic-embeddings",
    "_id": "Ji5065EBBFPLbFsdh_f9",
    "_score": 18.211695,
    "_source": {
      "id": 8836651,
      "content": {
        "text": "During Your Workout. There are a few things you can do during your workout to help prevent muscle injury and soreness. According to personal trainer and writer for Iron Magazine, Marc David, doing warm-ups and cool-downs between sets can help keep muscle soreness to a minimum.",
        "inference": {
          "inference_id": "my-elser-endpoint",
          "model_settings": {
            "task_type": "sparse_embedding"
          },
          "chunks": [
            {
              "text": "During Your Workout. There are a few things you can do during your workout to help prevent muscle injury and soreness. According to personal trainer and writer for Iron Magazine, Marc David, doing warm-ups and cool-downs between sets can help keep muscle soreness to a minimum.",
              "embeddings": {
                (...)
              }
            }
          ]
        }
      }
    }
  },
  {
    "_index": "semantic-embeddings",
    "_id": "Wi5065EBBFPLbFsdh_b9",
    "_score": 13.089405,
    "_source": {
      "id": 8800197,
      "content": {
        "text": "This is especially important if the soreness is due to a weightlifting routine. For this time period, do not exert more than around 50% of the level of effort (weight, distance and speed) that caused the muscle groups to be sore.",
        "inference": {
          "inference_id": "my-elser-endpoint",
          "model_settings": {
            "task_type": "sparse_embedding"
          },
          "chunks": [
            {
              "text": "This is especially important if the soreness is due to a weightlifting routine. For this time period, do not exert more than around 50% of the level of effort (weight, distance and speed) that caused the muscle groups to be sore.",
              "embeddings": {
                (...)
              }
            }
          ]
        }
      }
    }
  }
]

更多示例和阅读

编辑
  • 如果您想在混合搜索中使用 semantic_text，请参阅此笔记本以获取分步指南。
  • 有关如何优化 ELSER 端点的更多信息，请参阅模型文档中的ELSER 建议部分。
  • 要了解有关模型自动缩放的更多信息，请参阅训练模型自动缩放页面。
« 语义搜索 教程：使用 semantic_text 进行混合搜索 »

On this page

Was this helpful?
Feedback