For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.
Docs Menu

AI Cluster Assistant

The AI Cluster Assistant is an AI-powered helper embedded in the Atlas UI. You can use it while creating a cluster or editing a cluster's configuration to answers natural-language questions about cluster configuration. The AI Cluster Assistant can then recommend settings based on your workload and needs and apply those settings directly to your cluster.

To use the AI Cluster Assistant in Atlas, first ensure that you enable generative AI features in the Organization Settings page.

To enable this organization-level setting:

1
  1. If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.

  2. In the sidebar, click Organization Settings.

The Organization Settings page displays.

2

Set the Enable Atlas features that use generative AI toggle to On.

To learn more, see Generative AI FAQs.

If generative AI features are enabled at the organization level, the AI Cluster Assistant is enabled for all projects by default. You can change this per project using the Atlas Administration API. To do so, update your project settings to toggle isClusterAiAssistantEnabled to false. If generative AI features are disabled at the organization level, the AI Cluster Assistant will be unavailable for all projects, even if isClusterAiAssistantEnabled is set to true for a project.

You can access the AI Cluster Assistant in the Atlas UI while creating a cluster or editing a cluster's configuration. To access the AI Cluster Assistant while creating a cluster:

1
  1. If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.

  2. If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

  3. In the sidebar, click Clusters under the Database heading.

The Clusters page displays.

2

If you already have one or more clusters, click Create to display the Deploy your cluster page.

If this is your first cluster, click Build a Cluster to display the Deploy your cluster page.

3

Navigate to the bottom of the page and click Go to Advanced Configuration.

The AI Cluster Assistant chat window appears on the right side of the page.

To access AI Cluster Assistant while editing a cluster, simply click Edit additional configuration while on the Upgrade <yourClusterName> page.

To close the assistant, click the in the top right of the chat window. To reopen the assistant, click the . Closing the panel doesn't change your configuration or delete your chat history from that session. You can reopen the chat window at any time during the same session.

1

Follow the steps in Access the AI Cluster Assistant.

2

Submit a prompt looking for advice on your cluster configurations. You can discuss your workload, use case, or current pain points to have the AI Cluster Assistant suggest new configurations to best accommodate your needs.

3

The AI Cluster Assistant provides a response discussing your needs and suggesting cluster configurations. Review the response and suggested configurations and evaluate if they are satisfactory.

4

If needed, you can submit follow-up prompts to the AI Cluster Assistant to get more information on the suggested configurations, or to request new configurations that are better suited to your needs.

5

Click Apply these suggestions to accept the configurations suggested by the AI Cluster Assistant. This does not finalize your configurations and you can still make changes.

6

You can use the or button under the AI Cluster Assistant response in the chat window to provide feedback on the response and your experience using the AI Cluster Assistant.

7

Once satisfied, save your cluster configurations.

If you are creating a cluster, click Create Cluster at the bottom of the page to create your cluster with the suggested configurations.

If you are modifying a cluster, click Review Changes at the bottom of the page to see a summary of your changes. Then, click Accept Changes to save the new configurations.

This closes the AI Cluster Assistant.

While chatting with you, the AI Cluster Assistant offers links out to different Atlas UI pages, depending on your next task. The AI Cluster Assistant may link to one of these Atlas UI pages:

The following scenarios show some ways you can use the AI Cluster Assistant while creating or editing a cluster in Atlas.

Describe your use case and needs and ask the AI Cluster Assistant to suggest what cluster configurations could be best suited for you.

For example, if you are developing an application, you can tell the AI Cluster Assistant the purpose of your application and the expected amount of users.

I’m setting up a development cluster for a restaurant rating app with
100 users in NYC. What’s the best cluster configuration?

After the AI Cluster Assistant suggests a configuration, you can accept and save it or continue discussing your needs until you reach a configuration you are satisfied with.

You can also tell the AI Cluster Assistant the size of data you're expecting to need support for and the where your project is based.

I’m looking to migrate an existing project to Atlas. We currently
have 100GB of data that we need to move over. The project is currently
deployed in Europe and we want to maintain that. How should I configure
my cluster?

Again, you can accept and save the suggested configuration or continue working towards a configuration that better meets your needs with the AI Cluster Assistant.

Describe changes in your use case and needs and have the AI Cluster Assistant suggest how to best modify your cluster configurations.

For example, you can discuss budget constraints with the AI Cluster Assistant.

My cluster costs more than expected. Is there a setup that keeps
us under $500/mo?

The AI Cluster Assistant suggests a new configuration.

You can also discuss increased workloads with the AI Cluster Assistant.

Suggest a cluster setup as I'm expanding to India and expect 20,000
new users and the associated data.

The AI Cluster Assistant suggests a configuration that can accommodate your scaled needs.