From ba56754c9347ab7046e01a071c78944add23006a Mon Sep 17 00:00:00 2001 From: Kathleen DeRusso Date: Wed, 6 Aug 2025 09:47:12 -0400 Subject: [PATCH] Add inference fields to semantic text docs (#132471) --- .../mapping-reference/semantic-text.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/reference/elasticsearch/mapping-reference/semantic-text.md b/docs/reference/elasticsearch/mapping-reference/semantic-text.md index 88190d096e27e..69215662557e7 100644 --- a/docs/reference/elasticsearch/mapping-reference/semantic-text.md +++ b/docs/reference/elasticsearch/mapping-reference/semantic-text.md @@ -445,6 +445,29 @@ PUT test-index } ``` +## Troubleshooting semantic_text fields [troubleshooting-semantic-text-fields] + +If you want to verify that your embeddings look correct, you can view the +inference data that `semantic_text` typically hides using `fields`. + +```console +POST test-index/_search +{ + "query": { + "match": { + "my_semantic_field": "Which country is Paris in?" + }, + "fields": [ + "_inference_fields" + ] + } +} +``` + +This will return verbose chunked embeddings content that is used to perform +semantic search for `semantic_text` fields. + + ## Limitations [limitations] `semantic_text` field types have the following limitations: