Tutorials

Tutorials provide complete exercises based on real business goals, helping you consolidate your product skills after completing the quickstart.

Use cases

  • A workspace is the primary boundary for resources, members, and permissions.

  • AI Studio entries vary with account permissions, deployment mode, and feature flags.

  • We recommend starting with the shortest path: connect data, process it, build a knowledge base, and then use an agent.

Prerequisites

  • Sign in with the intended account and switch to the target workspace.

  • Confirm that the account can view the target resources and perform the required actions.

  • For external systems, prepare network access, a least-privilege account, and valid credentials.

Product entry and core objects

Item

Current implementation

Page entry

Workspace home at /$workspaceId/; account flows are served by the account center or built-in pages according to AUTH_MODE.

Service contract

AUTH_MODE supports sso, builtin, and cloudsigma; the workspace ID is part of page routes and backend request context.

Core objects

Account session, Workspace, Effective roles, Feature flags, Product entries

Procedure

  1. Complete the quickstart and verify the account, workspace, and basic data path.

  2. Choose the tutorial closest to the business goal and prepare isolated test data.

  3. Follow the tutorial sequence without skipping prerequisite or authorization checks.

  4. Record object IDs, execution results, and failures for reproducibility.

  5. Continue with the relevant guide for production configuration and governance.

State model

State or signal

Interpretation and action

Signed in / signed out

Determines whether the account or workspace surface is shown.

Workspace selected

Scopes resource lists, authorization, and downstream routes.

Entry visible / hidden

Depends on authorization, deployed products, and runtime feature flags.

Result validation

  • The page shows a successful state with the expected object name, workspace, and update time.

  • The result persists after refresh, and downstream operations can read the latest configuration.

  • On failure, retain the error and request ID, then check permissions, networking, credentials, and dependency state.

Troubleshooting

Symptom

Recommended action

Redirect loop after sign-in

Check the account URL, callback URI, cookies, and system clock.

No workspace is available

Confirm workspace membership and effective-role synchronization.

A menu entry is missing

Check feature flags first, then resource authorization and deployed version.

Production readiness

  • Identity and authorization: use a least-privilege account in the target workspace and verify read, write, run, and delete separately.

  • Change and rollback: record object IDs, versions, execution IDs, and timestamps; prepare rollback for delete, overwrite, and reindex operations.

  • Capacity and reliability: validate timeouts, concurrency, quotas, retries, and downstream impact on a representative small batch first.

  • Observability: correlate UI state with service logs, task timelines, or operation logs instead of relying on a single success toast.

Authorization and limitations

Note

These pages follow the current MOI 5.0 product model. If an entry is missing, check the workspace, permissions, and feature flags.