Guide

Choose Your Usage Path

The documentation now has beginner, detailed-learning, and operations tracks. Start with Quickstart, then use Learning Path and module guides for depth.

Path A: Quickstart

Use this if you are setting up Mosaic for the first time or validating a new machine.

• Install and verify mosaic --help.
• Run setup with one profile.
• Validate with models list and health.
• Run ask and chat.

Path B: Operations

Use this after quickstart when you need channels, gateway control, policy enforcement, and team-level diagnostics.

• Add and test delivery channels.
• Operate gateway lifecycle and probe status.
• Apply approvals + sandbox policy.
• Use status/health/doctor/logs/dashboard for day-2 operations.

Path C: Detailed progression + modules

Use this when you want full learning depth and module-specific walkthroughs.

• Follow Learning Path stage by stage.
• Use Models & Profiles to lock model routing and profile hygiene.
• Use Sessions Guide for reproducible conversation state control.
• Use TUI Guide when you need a chat-first terminal UI with inspector and shortcut workflow.
• Use Policy Guide for approvals/sandbox safety baseline.
• Use Azure Ops Playbook to run a full production baseline in one sequence.
• Use Agents Guide for full agents workflow.
• Use module guides for Channels, Memory, Knowledge, Plugins, Skills, Gateway, and Gateway Call API.

Suggested order

1. Finish Quickstart.
2. Follow Learning Path to build depth.
3. Complete Agents Guide for agent routing mastery.
4. Set up real channel + gateway in Operations.
5. Run release checks from Regression Guide.
6. Keep Troubleshooting as runbook fallback.