Organizations, Projects, and Workspaces

For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

Organizations, Projects, and Workspaces

MongoDB Atlas Agent Engine is in Public Preview and intended for evaluation and prototyping purposes only. We do not recommend production deployments during preview and expect to communicate breaking changes with you periodically. To learn more about preview feature considerations, see Preview Features.

Overview

The MongoDB Atlas Agent Engine uses a three-tier hierarchy to organize your teams and agents: organizations contain projects, and projects contain workspaces. Each tier serves a distinct purpose and scopes user access and configuration to the appropriate level.

Tier Relationships

Every project belongs to exactly one organization, and every workspace belongs to a project in that organization. The following diagram shows this relationship:

Organization
└── Project (one or more per organization)
    └── Workspace (one per deployed agent)

Tier Descriptions

The following table summarizes each tier:

Tier Description Learn More
Organization The top-level container for your teams and resources on the Atlas Agent Engine. Create one organization per company, department, or team that requires shared user management across multiple projects. [View Organizations](https://www.mongodb.com/docs/agentengine/manage/project-org-workspace/manage-project.md#std-label-agent-engine-manage-org
Project A grouping of resources for a specific team or application. Each project has its own service accounts and sharing policy. You can assign roles at the project level, and organization roles also apply within the project. Create one project per team or application area. [View Projects](https://www.mongodb.com/docs/agentengine/manage/project-org-workspace/manage-project.md#std-label-agent-engine-manage-projects
Workspace The runtime environment for a single deployed agent within a project. Each workspace holds the settings specific to one agent, which include the agent framework, LLM model, enabled tools, agent card, GitOps source, and toggles for optional features such as memory and guardrails. [Manage Workspaces](https://www.mongodb.com/docs/agentengine/manage/project-org-workspace/manage-project.md#std-label-agent-engine-manage-workspaces