Modes
The Copilot supports four application modes. Each mode is optimized for a different use case and ships with sensible defaults for panel visibility and navigation.
Panel visibility defaults
| Panel | embed | preview | link_preview | widget |
|---|---|---|---|---|
showConversations | Yes | Yes | Yes | No |
showActivity | No | Yes | No | No |
Override either default explicitly by passing showConversations or showActivity as a prop.
embed - production
Full-featured mode for production applications. Includes conversation history, worker switching, and complete navigation.
Use when: building customer-facing applications with full Copilot functionality.
- Conversation sidebar enabled
- Full header with navigation
- Worker / agent switching enabled
- Activity panel disabled (clean UX for end users)
preview - development and testing
Developer-focused mode with debugging capabilities. Shows activity traces and tool calls for inspecting worker behavior.
Use when: testing workers during development, debugging API responses, or viewing execution traces.
- Conversation sidebar enabled
- Activity / trace panel enabled
- Worker / agent switching enabled
- No header (minimal UI to focus on debugging)
link_preview - shareable links
URL-based mode for demos, presentations, and shared links.
Use when: sharing a worker via URL or creating demos.
- Conversation sidebar enabled
- Worker / agent switching enabled
- No header
- Activity panel disabled
widget - minimal embedding
Minimal mode for embedding in constrained spaces - modals, sidebars, or third-party integrations.
Use when: embedding in modals, sidebars, or any space-constrained UI.
- Minimal header (title only, no navigation)
- No conversation sidebar
- No worker switching
- No activity panel
Decision matrix
| Scenario | Recommended mode |
|---|---|
| Customer-facing app with full features | embed |
| Testing worker behavior during development | preview |
| Need to see execution traces and tool calls | preview |
| Sharing a worker via URL link | link_preview |
| Demo with auto-starting voice call | link_preview |
| Embedding in a modal or sidebar | widget |
| Minimal UI with no navigation | widget |
| Third-party integration with space constraints | widget |
| Debugging API responses and traces | preview |