Getting Started

Suger Insulin is an AI-powered workspace built into the Suger console for ISVs selling through cloud marketplaces.

Insulin gives you conversational AI, reusable agents, Custom Apps, knowledge bases, connected third-party tools, and automated jobs. Whether you need help drafting offers, analyzing revenue data, managing co-sell opportunities, coordinating across Gmail, Salesforce, HubSpot, Slack, or Teams, or building a lightweight internal app, Insulin brings AI assistance directly into your marketplace workflow.

Key Capabilities

• Chat — Have multi-turn conversations with AI, complete with streaming responses, extended thinking, model selection, and tool execution. See Chat.
• Agents — Install catalog agents or create your own. Each agent can have its own instructions, model, integration allowlist, skills, and knowledge bases. See Agents.
• Channels — Create group chats with team members for collaborative AI-assisted conversations. See Channels.
• Jobs — Set up manual, scheduled, or event-triggered automations that run agents with optional filter expressions. See Jobs.
• Marketplace — Browse and install pre-built agents and skills from the catalog. See Marketplace.
• Custom Apps — Build interactive apps with AI, connect them to approved integrations, preview them, and share them with your team. See Custom Apps.
• Knowledge Bases — Add files, websites, connectors, and pasted content so agents can retrieve trusted context. See Knowledge Bases.
• Inbox — Triage email with AI: classify and tag incoming messages, draft replies in your voice, and review them in an approvals queue before anything sends. See Inbox.
• Workspace Tools — Use Files, Preview, Browser, and Git apps when an agent or app needs a working environment. Preview renders files (PDFs, images, video, Markdown, HTML, and code) opened from Files or an agent.

Who It’s For

Insulin is designed for ISVs and their teams who use Suger to manage cloud marketplace listings across AWS, Azure, GCP, and Snowflake. It helps sales, operations, engineering, and product teams work faster by bringing AI assistance into daily marketplace workflows.

Adoption Path

Most teams adopt Insulin in this order:

1. Connect systems — Open the Settings app and connect the tools agents and apps should use. Organization integrations live under Settings → Integrations (Organization group): any member can view the list, but only an org ADMIN can connect or disconnect them, and they power organization-level resources. Personal connections (such as Gmail, Google Calendar, Google Drive, and Gong) are per-user and are available only to your own user-level agents and apps.
2. Start with chat — Open a conversation with the built-in Insulin assistant or a catalog agent. Ask it to explain what it can access before asking it to act.
3. Install or create agents — Use Marketplace to install a specialized agent, or create a custom agent with a focused system prompt, allowed integrations, and optional knowledge bases.
4. Build Custom Apps — Use Custom Apps when a workflow needs a reusable interface, dashboard, or form instead of a one-off chat answer.
5. Collaborate and automate — Use Channels for shared conversations and Jobs for repeatable or event-triggered work.

Accessing Insulin

1. Sign in to the Suger console
2. Click Insulin in the left sidebar
3. You are taken to the standalone Insulin workspace

No additional setup, API keys, or integrations are required.

Switching between the classic console and Insulin

The Suger console has two shells: the classic console and the Insulin desktop. A switch in the top bar toggles between them — it reads New (tooltip “Switch to new insulin desktop”) while you are in the classic console, and Classic (tooltip “Switch to classic console”) while you are in Insulin.

Your choice is remembered. After you switch to Insulin, signing in again takes you straight back to the Insulin desktop; switching back to Classic returns you to the classic console next time. New workspaces start on the classic console by default.

The Interface

Insulin is a desktop-OS workspace, not a single chat page. Every feature is its own app that opens in a resizable, movable window on a full-screen desktop.

• System Bar (top) — Runs across the top of the workspace. It includes the app launcher (a “Search apps…” field): click it, or press Cmd/Ctrl + Space, to search and open any app.
• Desktop (center) — A full-screen wallpaper with desktop icons. Double-click an icon to open that app.
• Dock (bottom) — A row of pinned apps you can open with one click.
• Windows — Each app opens in its own window that you can move, resize, minimize, or maximize. Multiple windows can be open at once.

The Dock comes pinned with these apps:

Chat, Settings, Marketplace, Files, Preview, Browser, Custom Apps, Knowledge Base, Git, and Inbox.

Jobs is also a built-in app, but it is not pinned to the Dock by default — open it from the app launcher.

Keyboard Shortcuts

Settings

Open the Settings app from the Dock. Tabs are split into two groups:

• Personal — Sandboxes, Memory (what agents remember about you and your work), and Preference (theme, accent color, font size, and desktop background). These apply only to you, and the same Personal tabs are also available from the classic console’s Settings. (Older links to the Appearance or Home Page tabs open Preference automatically.)
• Organization — Integrations, Users & Roles, Notification, API Client, and more. Organization tabs are visible to all members, but only an org ADMIN can change them.

Your First Conversation

When you open Insulin for the first time, you start with the default Insulin agent — a general-purpose assistant that acts as your chief of staff for marketplace operations.

1. Type a message in the input bar, such as: “What can you help me with?”
2. Press Enter or click the send button
3. The agent responds with streaming text

You can also attach files, images, or code references as context, or use the microphone control to dictate your message by voice.

That’s it. You’re now having a conversation with Insulin.

Selecting a Model

Click the model selector in the input bar to choose which AI model powers the conversation. Choose Default (auto) to let Insulin pick, or select a specific model — options are grouped by provider (such as Anthropic, OpenAI, and Gemini).

For the built-in Insulin agent in a one-on-one chat, your model choice is saved to your account and reused across sessions — including your Slack and Teams direct messages with Insulin. For other agents, the selection applies to the current conversation.

Extended Thinking

Toggle Extended Thinking in the input bar to enable the agent’s step-by-step reasoning before it responds. When enabled, you can see the agent’s thought process displayed above its final answer. This is useful for complex questions where you want to understand how the agent arrived at its response.

Switching Agents

To use a different agent in your conversation:

1. Click the agent name at the top of the chat area, or start a new conversation
2. Select an agent from the list — you can browse installed catalog agents, custom agents, or agents shared with you
3. The conversation continues with the selected agent’s personality and capabilities

See Agents for the agent catalog model and how to create your own.

Roles and Permissions

Insulin uses role-based access control (RBAC) for agents, channels, Custom Apps, knowledge bases, jobs, sandboxes, skills, and marketplace actions. Understanding these roles helps you collaborate effectively with your team. This section is the canonical reference for Insulin roles — other pages link back here and note only their own differences.

Ownership Levels

Every agent and channel has an ownership level that determines its visibility:

Organization Roles

Every user in your Suger organization has an org-level role that determines what they can do across Insulin:

Resource Roles and Exceptions

When an agent or channel is shared, each participant is assigned a resource-level role. Roles are hierarchical — higher roles inherit all permissions of lower roles.

• OWNER — The creator of the agent or channel. Only the owner can delete the resource — not even a shared ADMIN can. Ownership can be transferred.
• ADMIN — Can manage sharing (invite/revoke members and assign roles) and edit configuration, but cannot delete the resource.
• EDITOR — Can modify the agent’s system prompt, model, knowledge bases, and integration allowlist, or a channel’s settings.
• USER — Can chat with the agent or participate in the channel, but cannot change any configuration.
• VIEWER — Read-only access. Can view resources but cannot send messages or trigger actions.

Sharing Constraints

Not every role can be assigned in every situation:

• Agents cannot be shared as VIEWER — the lowest agent role is USER.
• Org-wide shares can never grant ADMIN to the whole organization, for any resource type.

Important exceptions:

• User-level agents, channels, and Custom Apps are private to their creator unless shared flows explicitly allow otherwise.
• Organization admins do not automatically get elevated access to every organization channel; channel access is controlled by channel membership and org-wide sharing.
• Organization-level agent and Custom App integration changes require organization administrator privileges.
• Organization-level agents can only use organization-level integrations. User-level agents use user-level integrations.

Next Steps

• Learn about Chat features like tool calls, plan approvals, and attachments
• Explore the Agents available to you
• Connect integrations and build a reusable workflow with Custom Apps