[DOC-13706] USING AI Limitations

modules/n1ql/pages/n1ql-language-reference/using-ai.adoc

@@ -22,6 +22,9 @@ IMPORTANT: The word `AI` is recognized as a keyword, but only when used as part
 When used by itself as a field name or identifier, you do not need to escape the word `AI` by enclosing it in backticks.
 For example, in a query like `SELECT ai FROM XYZ`, you can use `ai` as a field name without needing to escape it.
 
+CAUTION: If you're using the USING AI statement on Couchbase Capella, we recommend that you use either the cbq shell or SDK.
+For more information about these limitations and workarounds, see <<using-ai-limitations>>.
+
 == Prerequisites
 
 Before using the USING AI statement, make sure you have:
@@ -699,8 +702,19 @@ List the names and cities of hotels with a rating greater than 4;
 ----
 ====
 
+[[using-ai-limitations]]
+== Limitations 
+
+The USING AI statement provides the best results when run from Couchbase Server 8.0 instances (both Enterprise and Community Editions).
+
+When using the statement in Couchbase Capella, consider the following limitations and workarounds.
+
+* The USING AI statement does not work on the Capella UI.
+* To run the statement on Capella, use either the cbq shell or SDK.
+* To generate SQL++ queries from natural language requests on the Capella UI, use xref:get-started:capella-iq/work-with-capellaiq.adoc[Capella iQ] instead.
+
 == Related Links
 
 * xref:cloud:get-started:intro.adoc[Couchbase Capella Operational]
 * xref:n1ql-manage/query-settings.adoc#section_nnj_sjk_k1b[Setting Request-Level Parameters]
-* xref:n1ql-rest-query:index.adoc[Query Service REST API]
+* xref:n1ql-rest-query:index.adoc[Query Service REST API]