From 1f6b4ccf42aeede02856e69a2038064c70b98597 Mon Sep 17 00:00:00 2001 From: Kathleen DeRusso Date: Tue, 5 Aug 2025 16:06:15 -0400 Subject: [PATCH] Add inference fields to semantic text docs --- .../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 5a7895b0f6d11..15e43278ed7f9 100644 --- a/docs/reference/elasticsearch/mapping-reference/semantic-text.md +++ b/docs/reference/elasticsearch/mapping-reference/semantic-text.md @@ -486,6 +486,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: