clean up limitations/known issues page

Author: leemthompo

solutions/search/agent-builder/limitations-known-issues.md

@@ -14,47 +14,53 @@ These pages are currently hidden from the docs TOC and have `noindexed` meta hea
 
 # Limitations and known issues in {{agent-builder}}
 
-## Model selection
+## Limitations
 
-Initially, {{agent-builder}} only supports working with the [Elastic Managed LLM](kibana://reference/connectors-kibana/elastic-managed-llm.md) running on the Elastic Inference Service, on {{ech}} and {{serverless-full}}. 
+### {{agent-builder}} is not enabled by default
 
-Locally this picks the first AI connector available.
+While in private technical preview, {{agent-builder}} is not enabled by default. Refer to [Get started](get-started.md#enable-agent-builder) for instructions.
+
+### Model selection
+
+Initially, {{agent-builder}} only supports working with the [Elastic Managed LLM](kibana://reference/connectors-kibana/elastic-managed-llm.md) running on the [Elastic Inference Service](/explore-analyze/elastic-inference/eis.md) {applies_to}`serverless: preview` {applies_to}`ess: preview 9.2`.
+
+Learn about [pricing](https://www.elastic.co/pricing/serverless-search) for the Elastic Managed LLM.
 
 ## Known issues
 
+### Default agent can misinterpret SQL syntax as ES|QL
+
+The `.execute_esql` tool is designed only for [{{esql}}](elasticsearch://reference/query-languages/esql.md) syntax, not other query languages.
+
+When using SQL syntax with the default agent, it attempts to use the `.execute_esql` tool instead of recognizing the input as SQL.
+
+This results in parsing errors like this:
+```console-response
+[
+  {
+    "type": "error",
+    "data": {
+      "message": "parsing_exception\n\tCaused by:\n\t\tinput_mismatch_exception: null\n\tRoot causes:\n\t\tparsing_exception: line 1:15: mismatched input 'WHERE' expecting {<EOF>, '|', ',', 'metadata'}",
+      "stack": "ResponseError: parsing_exception\n\tCaused by:\n\t\tinput_mismatch_exception: null\n\tRoot causes:\n\t\tparsing_exception: line 1:15: mismatched input 'WHERE' expecting {<EOF>, '|', ',', 'metadata'}\n    at KibanaTransport._request (Desktop/Dev/kibana/node_modules/@elastic/elasticsearch/node_modules/@elastic/transport/src/Transport.ts:591:17)\n    at processTicksAndRejections (node:internal/process/task_queues:105:5)\n    at Desktop/Dev/kibana/node_modules/@elastic/elasticsearch/node_modules/@elastic/transport/src/Transport.ts:697:22\n    at KibanaTransport.request (Desktop/Dev/kibana/node_modules/@elastic/elasticsearch/node_modules/@elastic/transport/src/Transport.ts:694:14)"
+    }
+  }
+]
+```
+
+### Not all LLMs are compatible
+
+While Elastic offers LLM connectors for many different vendors and models, not all LLMs are robust enough to be used with {{agent-builder}}.
+
+The following errors suggest your selected model may not be compatible with {{agent-builder}}:
+
+```console-response
+Error: Invalid function call syntax
+```
+
+```console-response
+Error executing agent: No tool calls found in the response.
+```
 
-- **Default agent can misinterpret SQL syntax as ES|QL**
-  - The `.execute_esql` tool is designed only for [{{esql}}](elasticsearch://reference/query-languages/esql.md) syntax, not other query languages
-  - When using SQL syntax with the default agent, it attempts to use the `.execute_esql` tool instead of recognizing the input as SQL
-  - This results in parsing errors like this:
-    ```console-response
-    [
-      {
-        "type": "error",
-        "data": {
-          "message": "parsing_exception\n\tCaused by:\n\t\tinput_mismatch_exception: null\n\tRoot causes:\n\t\tparsing_exception: line 1:15: mismatched input 'WHERE' expecting {<EOF>, '|', ',', 'metadata'}",
-          "stack": "ResponseError: parsing_exception\n\tCaused by:\n\t\tinput_mismatch_exception: null\n\tRoot causes:\n\t\tparsing_exception: line 1:15: mismatched input 'WHERE' expecting {<EOF>, '|', ',', 'metadata'}\n    at KibanaTransport._request (Desktop/Dev/kibana/node_modules/@elastic/elasticsearch/node_modules/@elastic/transport/src/Transport.ts:591:17)\n    at processTicksAndRejections (node:internal/process/task_queues:105:5)\n    at Desktop/Dev/kibana/node_modules/@elastic/elasticsearch/node_modules/@elastic/transport/src/Transport.ts:697:22\n    at KibanaTransport.request (Desktop/Dev/kibana/node_modules/@elastic/elasticsearch/node_modules/@elastic/transport/src/Transport.ts:694:14)"
-        }
-      }
-    ]
-    ``` 
-
-- **Not all LLMs are compatible**
-  - While Elastic offers LLM connectors for many different vendors and models, not all LLMs are robust enough to be used with {{agent-builder}}.
-  - Errors such as:
-    ```console-response
-    Error: Invalid function call syntax
-    ```
-    or
-    ```
-    Error executing agent: No tool calls found in the response.
-    ```
-    may indicate that your selected model is ill-equipped for the precise response structure necessary for {{agent-builder}}.
-  - We recommend using the [Elastic Managed LLM](kibana://reference/connectors-kibana/elastic-managed-llm.md) 
-
-- **{{agent-builder}} is not accessible**
-  - {{agent-builder}} was added in a private preview in September, 2025 for Serverless, and in 9.2.0 for Elastic Cloud.
-  - While in this preview stage, {{agent-builder}} is not enabled by default.
-  - To enable it, you must go to Stack Management -> Kibana -> Advanced Settings -> Elastic Agent Builder, and enable it.
+We recommend using the [Elastic Managed LLM](kibana://reference/connectors-kibana/elastic-managed-llm.md).