DOCSP-38132 Compass Generative AI Generally Available Updates (#620)

ianf-mongodb · mdb-ashley · web-flow · commit 58f89aa4cbb8 · 2024-05-02T10:25:33.000-04:00
* DOCSP-38132 Compass Generative AI Generally Available Updates * remove banners * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * IR * * * * * * * * * * * * * remove sample fields * * * * * * * Apply suggestions from code review Co-authored-by: Ashley Brown <98361885+mdb-ashley@users.noreply.github.com> * * * * --------- Co-authored-by: Ashley Brown <98361885+mdb-ashley@users.noreply.github.com>
diff --git a/snooty.toml b/snooty.toml
@@ -51,20 +51,6 @@ value = """
     For more information, see :ref:`7.0-compatibility`.
     """
 
-[[banners]]
-targets = [
-    "query-with-natural-language/enable-natural-language-querying.txt",
-    "query-with-natural-language/prompt-natural-language-query.txt",
-    "query-with-natural-language/prompt-natural-language-aggregation.txt",
-    "query-with-natural-language/query-with-natural-language.txt"
-]
-variant = "tip"
-value = """
-    The MongoDB Compass natural language querying feature is currently \
-    available as a **Public Preview** offering. The product, its features, \ 
-    and the corresponding documentation may change during the Preview stage.
-    """
-
 [substitutions]
 atlas = "MongoDB Atlas"
 compass = "MongoDB Compass"
diff --git a/source/query-with-natural-language/ai-and-data-usage-information.txt b/source/query-with-natural-language/ai-and-data-usage-information.txt
@@ -25,11 +25,12 @@ How Your Data is Used
 ---------------------
 
 When you query with natural language in Compass, the following 
-information is sent to MongoDB’s backend and/or the third party 
+information is sent to MongoDB's backend and/or the third party 
 AI provider: 
 
-The schema of the collection you are querying 
-(including collection name, field names, and types). 
+- The full text of your natural language prompt.
+- The schema of the collection you are querying, 
+  including database name, collection name, field names, and types. 
 
 The information that is sent will not be shared with any other third 
 parties or stored by the AI provider. We do not send database 
@@ -39,9 +40,10 @@ Disable Natural Language Querying
 ---------------------------------
 
 - Natural language querying in Compass is available if you have 
-  enabled the :ref:`Compass Use Generative AI setting 
+  enabled the :ref:`Generative AI setting 
   <enable-natural-language-querying>` and logged into Atlas. 
-- If you no longer want to use the feature, you can ignore it 
-  and no data will be sent to generative AI models. To prevent usage of 
-  this feature entirely, you can disable it in the 
+- If you no longer want to use the feature, uncheck 
+  :guilabel:`Enable AI Features` in the 
+  :guilabel:`Artificial Intelligence` settings. 
+- To prevent usage of this feature entirely, you can disable it in the 
   :ref:`global configuration file <config-file>`.
diff --git a/source/query-with-natural-language/enable-natural-language-querying.txt b/source/query-with-natural-language/enable-natural-language-querying.txt
@@ -39,7 +39,6 @@ you must:
 - Install |compass-short| version 1.40.0 or later. For instructions on 
   downloading and installing the latest version, see :ref:`download-install`.
 
-
 .. note::
 
    You can also enable Natural Language Querying using the configuration 
@@ -49,7 +48,7 @@ Steps
 -----
 
 .. procedure::
-   :style:  connected
+   :style: connected
 
    .. step:: Open settings
 
@@ -69,25 +68,33 @@ Steps
            - In the top menu bar, click :guilabel:`MongoDB Compass`.
            - ``⌘`` + ``,``
 
-   .. step:: Connect to your Atlas account
+   .. step:: Enable AI Features and Log In to Atlas
+
+      You only need to enable AI features if it is your first time 
+      using natural language querying.
 
-      a. Select :guilabel:`Feature preview`.
+      a. Select :guilabel:`Artificial Intelligence`.
+      #. Click the :guilabel:`Enable AI Features` check box.
       #. Click :guilabel:`Log in with Atlas`.
 
          A web browser displays the
          `Atlas login page <https://account.mongodb.com/account/login>`_.
 
       #. Complete the login procedure.
 
-         Once completed a :guilabel:`Logged in with Atlas account`
+         After you log in successfully, a 
+         :guilabel:`You can create queries and aggregations with 
+         generative AI`
          message displays. 
+      #. Click :guilabel:`Save`.
+      
+   .. step:: (Optional) Read MongoDB's GenAI FAQs
 
-   .. step:: Enable the generative AI feature
+      For more information about generative AI usage with MongoDB
+      Compass, see:
 
-      a. The :guilabel:`Data Processing Agreement` displays.
-      #. Read the :guilabel:`Data Processing Agreement`.
-      #. Click :guilabel:`Agree and continue`.
-      #. Click :guilabel:`Save`.
+      - :ref:`compass-ai-data-usage`
+      - `FAQ For MongoDB Generative AI Features <https://www.mongodb.com/docs/generative-ai-faq/>`__
 
 Next Steps
 ----------
diff --git a/source/release-notes.txt b/source/release-notes.txt
@@ -10,6 +10,16 @@ Release Notes
    :depth: 1
    :class: twocols
 
+|compass| 1.43.0
+----------------
+
+*Upcoming*
+
+New Features
+
+- Queries generated by Natural Language Querying have improved 
+  quality and accuracy.
+
 |compass| 1.42.5
 ----------------
 
diff --git a/source/settings/settings-reference.txt b/source/settings/settings-reference.txt
@@ -137,11 +137,6 @@ You can configure the following settings on the |compass| interface:
      - Allow our Product team to occasionally reach out for feedback about 
        |compass-short|.
 
-   * - Enable AI Features
-     - Privacy
-     - Allows the use of AI features in Compass which make requests 
-       to 3rd party services.
-
    * - Browser command to use for OIDC Authentication
      - OIDC
      - Specify the browser that |compass-short| redirects you to when authenticating 
@@ -158,10 +153,10 @@ You can configure the following settings on the |compass| interface:
      - Remain logged in when using the :manual:`MONGODB-OIDC </core/security-oidc/>` 
        authentication mechanism. 
 
-   * - Use Generative AI
-     - Feature Preview
-     - Enables :ref:`natural language querying <query-natural-language>`.
-
+   * - Enable AI Features
+     - Artificial Intelligence
+     - Enables :ref:`natural language querying <query-natural-language>` and allows 
+       the use of AI features in Compass which make requests to 3rd party services.
 
 Learn More
 ----------
