Overview
A workspace (Namespace) is the basic unit for resource isolation in AI Registry (AI Registry). Each workspace has its own independent collection of AI assets such as Prompts and Skills. Data in different workspaces is fully isolated and does not affect each other.
Common workspace scenarios:
Isolation by environment: Create a separate workspace for each environment (development, testing, staging, and production) to prevent cross-environment misoperations.
Isolation by business or team: Assign independent workspaces to different business lines or development teams for clear responsibility division and access control.
Isolation by platform integration: Use the
sourceidentifier to distinguish integration sources (such as AgentLoop, AgentScope, and other third-party platforms) for traceability and centralized management.
This topic walks you through creating, querying, and editing workspaces in the AI Registry console.
Prerequisites
You have an Alibaba Cloud account and have activated the AI Registry service.
The current account has the required permissions to perform workspace operations. To grant permissions to a RAM user, see Configure RAM Permissions for AI Registry.
1. Access the workspace management page
Log on to the AI Registry console.
In the left-side navigation pane, choose Workspace to enter the workspace list page.
2. Create a workspace
Procedure
On the workspace list page, click the Create Workspace button in the upper-right corner.
In the dialog box that appears, configure the following items:
Item | Description | Required |
Name | The display name of the workspace on the console. Chinese characters, English letters, digits, underscores, and hyphens are supported. | Yes |
Description | A brief description of the workspace purpose for easier maintenance. | No |
Tag | Custom tags for filtering and querying workspaces. | No |
After confirming that the information is correct, click Create to complete the creation.
After the workspace is created, it appears in the workspace list with a globally unique workspace ID. Both the client SDK and RAM policies reference the workspace by this ID.
Limits
During public preview, each user can create up to 50 workspaces.
The workspace ID cannot be modified after creation.
3. Edit a workspace
To modify the name, description, or business tags of a workspace, use the edit feature.
Procedure
On the workspace list page, find the target workspace and click Edit.
In the edit dialog box that appears, modify configuration items as needed.
After making the changes, click the Save button.
4. Use cases for the workspace ID
The workspace ID is the core identifier for accessing a workspace. It is required in the following scenarios:
Scenario | Purpose |
Client SDK integration | Specify the resource scope by workspace ID when initializing the SDK. |
RAM policy configuration | Use |
API calls | Specify the target workspace by setting |
Cross-platform integration | Platforms such as AgentLoop reference AI Registry resources via the workspace ID. |
You can copy the workspace ID from the workspace list or workspace details page.
FAQ
Q: How many workspaces can each account create?
A: During public preview, each user can create up to 50 workspaces. To request a higher quota, contact AI Registry technical support.
Q: Can I customize the workspace ID?
A: No. The workspace ID is automatically generated by the system to ensure global uniqueness.
Q: Can resources between different workspaces access each other?
A: No. Resources in different workspaces are completely isolated. Even workspaces under the same account cannot access each other. To share a Prompt or Skill, you must recreate it in the target workspace.
Q: How can a RAM user be authorized to access a specific workspace?
A: In a custom permission policy, set the Resource to the specific workspace ID, for example: acs:airegistry:*:*:instance/saas/{WorkspaceId}/*. For more information, see Configure RAM Permissions for AI Registry.