Skip to main content
Settings, Billing & Limits

Workspaces and Members

Manage workspaces, member permissions, and API keys

A workspace is the fundamental unit for resource isolation. Multiple workspaces can be created under a single Alibaba Cloud account, with each workspace maintaining its own independent knowledge base, API key, and member permissions.

Workspaces

ConceptDescription
WorkspaceA resource isolation unit. The main account workspace ID format is llm-xxxxxxxxxxxx, while regular workspace IDs are ws_xxxxxxxxxxxxxxxx.
Main Account WorkspaceThe default workspace associated with the account, marked as Default.
Workspace LimitUp to 30 workspaces per Alibaba Cloud account.

Creating a Workspace

Navigate to the console’s Settings → Workspaces page and click Create Workspace, then enter a name.

Switching Workspaces

Use the dropdown menu in the top-right corner of the console to switch the current workspace. After switching, the left-side knowledge base list, API keys, and other resources will update accordingly.

Members and Permissions

RolePermissions
Alibaba Cloud Main AccountFull access to all operations.
RAM Sub-account / RAM RoleMust first be granted the AliyunBailianDataFullAccess permission policy and added to the target workspace.

Adding Members

On the Settings → Members and Permissions page, click Add User, then enter the RAM username or UID to add the user to the current workspace. The member list displays the display name, login name, RAM ID, and user type.

Permission Management

Permissions for individual members can be configured separately via Permission Management, or multiple members can be selected and their permissions updated collectively using Batch Edit Permissions.

API Key Management

An API key serves as the credential for calling APIs and is isolated per workspace.

Creating an API Key

On the Settings → API Keys page, click Create API Key. The key is displayed only once upon generation—be sure to save it securely. The API key list shows the ID, key value, description, associated account, and creation time.

Security Recommendations

RecommendationDescription
Avoid committing to code repositoriesStore API keys in environment variables (e.g., DASHSCOPE_API_KEY).
Split by applicationAssign a unique API key to each application.
Rotate regularlyPeriodically replace API keys to reduce exposure risk.
Reset immediately upon leakageIf leaked, reset the key immediately on the API Key page.
API keys grant account-level permissions. Leakage may lead to unauthorized resource usage and unexpected charges. Never share API keys publicly or commit them to code repositories.

Relationship with the Bailian Platform

Knowledge Studio shares the Alibaba Cloud account and workspace infrastructure with the Bailian platform:
DimensionDescription
AccountSingle sign-on across both platforms using the same Alibaba Cloud main account.
WorkspaceShared and visible in both platforms.
Knowledge BaseShared and manageable from either platform.
API KeyShared DashScope API key set across both platforms.
Workspaces and Members - 阿里云百炼 Agent Studio