From 23b624232fa3471ae6fd49de06e15fc05eaaf234 Mon Sep 17 00:00:00 2001
From: Kathleen DeRusso <kathleen.derusso@elastic.co>
Date: Fri, 27 Jun 2025 08:49:02 -0400
Subject: [PATCH] Update docs for knn query on semantic_text fields (#130193)

---
 docs/reference/query-dsl/knn-query.asciidoc | 30 +++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/reference/query-dsl/knn-query.asciidoc b/docs/reference/query-dsl/knn-query.asciidoc
index 445c62bec82b..7a80a02f580e 100644
--- a/docs/reference/query-dsl/knn-query.asciidoc
+++ b/docs/reference/query-dsl/knn-query.asciidoc
@@ -274,6 +274,36 @@ A sample query can look like below:
 ----
 // NOTCONSOLE
 
+[[knn-query-with-semantic-text]]
+==== Knn query on a semantic_text field
+
+Elasticsearch supports `knn` query over a <<semantic-text, semantic_text>> field.
+
+Here is an example using the `query_vector_builder`:
+
+[source,js]
+----
+{
+  "query": {
+    "knn": {
+      "field": "inference_field",
+      "k": 10,
+      "num_candidates": 100,
+      "query_vector_builder": {
+        "text_embedding": {
+          "model_text": "test"
+        }
+      }
+    }
+  }
+}
+----
+// NOTCONSOLE
+
+Note that for `semantic_text` fields, the `model_id` does not have to be provided as it can be inferred from the `semantic_text` field mapping.
+
+Knn search using query vectors over `semantic_text` fields is also supported, with no change to the API.
+
 [[knn-query-aggregations]]
 ==== Knn query with aggregations
 `knn` query calculates aggregations on top `k` documents from each shard.