Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion apps/docs/content/docs/agents/skills.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ description: Reusable instruction packages your agents load on demand, managed f
---

import { Callout } from 'fumadocs-ui/components/callout'
import { Image } from '@/components/ui/image'

Agent Skills are reusable packages of instructions that give your AI agents specialized capabilities. Based on the open [Agent Skills](https://agentskills.io) format, skills let you capture domain expertise, workflows, and best practices that agents can load on demand.

Expand Down Expand Up @@ -93,7 +94,7 @@ Tagging a skill loads its full instructions into the conversation, so Sim follow

Open any **Agent** block and find the **Skills** dropdown below the tools section. Select the skills you want the agent to have access to.

![Add Skill](/static/skills/add-skill.png)
<Image src="/static/skills/add-skill.png" alt="Add Skill" width={756} height={428} className="mx-auto h-auto w-full max-w-sm" />

Selected skills appear as cards that you can click to edit or remove.

Expand Down
6 changes: 3 additions & 3 deletions apps/docs/content/docs/knowledgebase/connectors.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Connectors continuously sync documents from external services into your knowledg

## Available Connectors

<Image src="/static/connectors/connectors-sources.png" alt="The current Connect Source picker showing searchable connectors including Airtable, Asana, Ashby, Azure DevOps, Bitbucket, Box, and ClickUp" width={750} height={680} />
<Image src="/static/connectors/connectors-sources.png" alt="The current Connect Source picker showing searchable connectors including Airtable, Asana, Ashby, Azure DevOps, Bitbucket, Box, and ClickUp" width={750} height={680} className="mx-auto h-auto w-full max-w-md" />

Sim ships with 64 built-in connectors:

Expand Down Expand Up @@ -125,7 +125,7 @@ Click **Connect & Sync** to save the connector and trigger the first sync. Docum

Open **Connected Sources** from the knowledge base to see all active connectors. Each card shows the connector's status, the last sync time and document count, and the next scheduled sync:

<Image src="/static/connectors/connectors-sync-history.png" alt="Connected Sources panel showing a Google Docs connector with Active status, last sync details, and a sync history log with dated entries" width={800} height={466} />
<Image src="/static/connectors/connectors-sync-history.png" alt="Connected Sources panel showing a Google Docs connector with Active status, last sync details, and a sync history log with dated entries" width={800} height={466} className="mx-auto h-auto w-full max-w-xl" />

The action buttons on each connector card:

Expand Down Expand Up @@ -159,7 +159,7 @@ The log retains the most recent 10 sync runs.

Sometimes a connector syncs documents you don't want in your knowledge base — drafts, templates, confidential pages, and so on. You can exclude them individually.

<Image src="/static/connectors/connectors-excluded.png" alt="Edit Google Docs modal showing the Documents tab with Active (37) and Excluded (0) filter buttons and a 'No excluded documents' message" width={800} height={774} />
<Image src="/static/connectors/connectors-excluded.png" alt="Edit Google Docs modal showing the Documents tab with Active (37) and Excluded (0) filter buttons and a 'No excluded documents' message" width={800} height={774} className="mx-auto h-auto w-full max-w-md" />

To exclude a document, open the connector's settings modal, go to the **Documents** tab, and click **Exclude** next to any document. Excluded documents are skipped on every subsequent sync even if the source content changes.

Expand Down
4 changes: 2 additions & 2 deletions apps/docs/content/docs/knowledgebase/tags.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,11 +36,11 @@ The type dropdown in the creation form shows current slot usage for each type (e

Tag definitions live at the knowledge base level. To manage them, click the knowledge base name in the header to open the context menu and select **Tags**:

<Image src="/static/tags/tags-kb-menu.png" alt="Knowledge base header showing the dropdown menu with Rename, Tags, and Delete options" width={700} height={346} />
<Image src="/static/tags/tags-kb-menu.png" alt="Knowledge base header showing the dropdown menu with Rename, Tags, and Delete options" width={700} height={346} className="mx-auto h-auto w-full max-w-md" />

This opens the Tags modal, which lists all defined tags and shows how many documents each one is assigned to. Click **Add Tag** to define a new one:

<Image src="/static/tags/tags-create.png" alt="Tags modal showing 0 defined tags, a Tag Name input field, and a Type dropdown set to Text (0/7), with Cancel and Create Tag buttons" width={700} height={471} />
<Image src="/static/tags/tags-create.png" alt="Tags modal showing 0 defined tags, a Tag Name input field, and a Type dropdown set to Text (0/7), with Cancel and Create Tag buttons" width={700} height={471} className="mx-auto h-auto w-full max-w-md" />

Enter a **Tag Name** and pick a **Type**, then click **Create Tag**. The name must be unique within the knowledge base. The type dropdown only shows types that still have available slots. Press Enter to submit or Escape to cancel.

Expand Down
1 change: 1 addition & 0 deletions apps/docs/content/docs/logs-debugging/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ Open a run and **Log Details** shows the trace. The **Trace** tab lists each blo
alt="The current Log Details Trace tab showing workflow, agent, model, and tool spans with their durations"
width={518}
height={540}
className="mx-auto h-auto w-full max-w-md"
/>

This is the level you debug at, because a run fails when one of its blocks fails, and a block usually fails because of the input it received. In this run, one glance at the spans shows where the time went: Agent 1 took 7.84s of the 7.86s total.
Expand Down
4 changes: 2 additions & 2 deletions apps/docs/content/docs/logs-debugging/logging.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Click any entry to open its sidebar: the run's timeline (start/end, total durati
alt="The current Log Details sidebar with run metadata, output, and credit total"
width={518}
height={760}
className="my-6"
className="my-6 mx-auto h-auto w-full max-w-sm"
/>
</div>

Expand All @@ -70,7 +70,7 @@ Click any entry to open its sidebar: the run's timeline (start/end, total durati
alt="Workflow Snapshot"
width={600}
height={628}
className="my-6"
className="my-6 mx-auto h-auto w-full max-w-md"
/>
</div>

Expand Down
4 changes: 4 additions & 0 deletions apps/docs/content/docs/platform/credentials.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ To manage secrets, open your workspace **Settings** and navigate to the **Secret
alt="Secrets tab showing Workspace and Personal sections with inline key-value rows"
width={700}
height={479}
className="mx-auto h-auto w-full max-w-xl"
/>

Secrets are organized into two sections:
Expand Down Expand Up @@ -54,6 +55,7 @@ To reference a secret in any input field, type `{{` to open the variable dropdow
alt="Typing {{ in an input opens a dropdown showing available secrets"
width={400}
height={165}
className="mx-auto h-auto w-full max-w-[400px]"
/>

Select the secret you want to use. The reference appears highlighted in blue and is resolved to its actual value at runtime.
Expand All @@ -63,6 +65,7 @@ Select the secret you want to use. The reference appears highlighted in blue and
alt="A resolved secret reference shown as {{OPENAI_API_KEY}}"
width={400}
height={166}
className="mx-auto h-auto w-full max-w-[400px]"
/>

### Execution log protection
Expand Down Expand Up @@ -114,6 +117,7 @@ Click **Details** on any secret row to open its detail view.
alt="Secret details view showing Key, Value, Description, and Members sections"
width={700}
height={351}
className="mx-auto h-auto w-full max-w-xl"
/>

From here you can:
Expand Down
6 changes: 3 additions & 3 deletions apps/docs/content/docs/platform/enterprise/access-control.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ When a user runs a workflow or uses Chat, Sim reads the resolved group's configu

Go to **Settings → Organization → Permission groups** from any workspace in your organization. Permission groups are defined once at the organization level and apply to every workspace under it. Only organization owners and admins can manage them.

<Image src="/static/enterprise/access-control-groups.png" alt="Access Control settings showing a list of permission groups: Contractors, Sales, Engineering, and Marketing, each with Details and Delete actions" width={900} height={477} />
<Image src="/static/enterprise/access-control-groups.png" alt="Access Control settings showing a list of permission groups: Contractors, Sales, Engineering, and Marketing, each with Details and Delete actions" width={900} height={477} className="mx-auto h-auto w-full max-w-xl" />

### 2. Create a permission group

Expand All @@ -59,7 +59,7 @@ A workspace-scoped group with **no members** applies to everyone in its workspac

Controls which AI model providers members of this group can use.

<Image src="/static/enterprise/access-control-model-providers.png" alt="Model Providers tab showing a grid of AI providers including Ollama, vLLM, OpenAI, Anthropic, Google, Azure OpenAI, and others with checkboxes to allow or restrict access" width={900} height={430} />
<Image src="/static/enterprise/access-control-model-providers.png" alt="Model Providers tab showing a grid of AI providers including Ollama, vLLM, OpenAI, Anthropic, Google, Azure OpenAI, and others with checkboxes to allow or restrict access" width={900} height={430} className="mx-auto h-auto w-full max-w-xl" />

The list shows all providers available in Sim.

Expand Down Expand Up @@ -89,7 +89,7 @@ Expand an integration block to reach its **tool denylist**. Clearing individual

Controls the modules, actions, and credentials available to group members. Every row refuses at the API, not only in the UI — clearing a box revokes the access; it does not merely hide a tab.

<Image src="/static/enterprise/access-control-platform.png" alt="Platform tab showing feature toggles grouped by category" width={900} height={566} />
<Image src="/static/enterprise/access-control-platform.png" alt="Platform tab showing feature toggles grouped by category" width={900} height={566} className="mx-auto h-auto w-full max-w-xl" />

**Modules**

Expand Down
2 changes: 1 addition & 1 deletion apps/docs/content/docs/platform/enterprise/audit-logs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Audit logs record configuration and security events across your organization, in

Go to **Settings → Organization → Audit logs** in your workspace. Logs are displayed in a table with the following columns:

<Image src="/static/enterprise/audit-logs.png" alt="Audit Logs settings showing a table of events with columns for Timestamp, Event, Description, and Actor, along with search and filter controls" width={900} height={830} />
<Image src="/static/enterprise/audit-logs.png" alt="Audit Logs settings showing a table of events with columns for Timestamp, Event, Description, and Actor, along with search and filter controls" width={900} height={830} className="mx-auto h-auto w-full max-w-xl" />

| Column | Description |
|--------|-------------|
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ Click **Save changes**. The block is published immediately and becomes available

In the workflow editor, open the block toolbar. Published custom blocks appear under a **Custom blocks** section. Drag one into your workflow like any other block, fill in its inputs (using the placeholders as a guide), and reference its outputs in downstream blocks.

<Image src="/static/enterprise/custom-blocks-toolbar.png" alt="Workflow editor block toolbar with a Custom Blocks section listing two published blocks below Core Blocks" width={400} height={476} />
<Image src="/static/enterprise/custom-blocks-toolbar.png" alt="Workflow editor block toolbar with a Custom Blocks section listing two published blocks below Core Blocks" width={400} height={476} className="mx-auto h-auto w-full max-w-xs" />

Consumers don't need any access to the source workflow. The block runs on its own, using only the inputs provided, and returns only the outputs you exposed. Its internal steps, models, and intermediate values stay hidden unless the block's publisher turned on **Trace runs in consumer logs**, in which case they appear under the block in the run's trace.

Expand Down
4 changes: 2 additions & 2 deletions apps/docs/content/docs/platform/enterprise/data-drains.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ Drains are independent of [Data Retention](/platform/enterprise/data-retention)

Go to **Settings → Organization → Data drains** in your workspace, then click **New drain**.

<Image src="/static/enterprise/data-drains-list.png" alt="Data Drains settings page showing two configured drains — one exporting workflow logs to Amazon S3 daily, another exporting Chat conversations to an HTTPS webhook hourly" width={900} height={885} />
<Image src="/static/enterprise/data-drains-list.png" alt="Data Drains settings page showing two configured drains — one exporting workflow logs to Amazon S3 daily, another exporting Chat conversations to an HTTPS webhook hourly" width={900} height={885} className="mx-auto h-auto w-full max-w-md" />

<Image src="/static/enterprise/data-drains-new.png" alt="New data drain dialog with fields for name, source, cadence, destination, and S3 credentials" width={900} height={491} />
<Image src="/static/enterprise/data-drains-new.png" alt="New data drain dialog with fields for name, source, cadence, destination, and S3 credentials" width={900} height={491} className="mx-auto h-auto w-full max-w-xl" />

Each drain has four pieces:

Expand Down
12 changes: 6 additions & 6 deletions apps/docs/content/docs/platform/enterprise/forks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,15 +44,15 @@ You will see:

Click **Create fork**. Name the child (defaults to `{workspace} (fork)`), then review **Copy resources**.

<Image src="/static/enterprise/forks-create-modal.png" alt="Fork workspace modal with name field and Copy resources list fully selected" width={900} height={884} />
<Image src="/static/enterprise/forks-create-modal.png" alt="Fork workspace modal with name field and Copy resources list fully selected" width={900} height={884} className="mx-auto h-auto w-full max-w-md" />

Everything under **Copy resources** starts **selected**. That is usually what you want: tables, knowledge bases, files, custom tools, skills, and MCP servers the child will need.

<Callout type="info">
If you deselect a resource, references to it in the forked workflows are **cleared** in the child. You will see a warning before you confirm.
</Callout>

<Image src="/static/enterprise/forks-create-warning.png" alt="Fork workspace modal showing a warning that deselected resources will clear references in the fork" width={900} height={953} />
<Image src="/static/enterprise/forks-create-warning.png" alt="Fork workspace modal showing a warning that deselected resources will clear references in the fork" width={900} height={953} className="mx-auto h-auto w-full max-w-md" />

Click **Fork**. The child workspace is created immediately. Deployed workflows land as **drafts** in the child. Large content (table rows, knowledge base files, file blobs) may finish copying in the background — watch **Activity** on the source workspace.

Expand Down Expand Up @@ -94,11 +94,11 @@ On the sync page you will see direction (**Push** / **Pull**), deployed workflow

Both are force operations. Confirm carefully.

<Image src="/static/enterprise/forks-copy-resources.png" alt="Copy resources section showing resources used by workflows and a Not used by any workflow group" width={900} height={334} />
<Image src="/static/enterprise/forks-copy-resources.png" alt="Copy resources section showing resources used by workflows and a Not used by any workflow group" width={900} height={334} className="mx-auto h-auto w-full max-w-xl" />

Resources referenced by the workflows in the sync default to selected for copy. Unused ones sit under **Not used by any workflow** (off by default). If you **map** a resource, it leaves the copy list — maps win.

<Image src="/static/enterprise/forks-reconfigure.png" alt="Dependent field reconfigure card under a mapped resource with a required field marked" width={900} height={242} />
<Image src="/static/enterprise/forks-reconfigure.png" alt="Dependent field reconfigure card under a mapped resource with a required field marked" width={900} height={242} className="mx-auto h-auto w-full max-w-xl" />

**Sync** stays disabled until:

Expand All @@ -111,7 +111,7 @@ Resources referenced by the workflows in the sync default to selected for copy.

Click **Sync**. You will get an overwrite confirmation.

<Image src="/static/enterprise/forks-sync-confirm.png" alt="Overwrite target workspace confirmation dialog warning that syncing overwrites changes on the target" width={900} height={438} />
<Image src="/static/enterprise/forks-sync-confirm.png" alt="Overwrite target workspace confirmation dialog warning that syncing overwrites changes on the target" width={900} height={438} className="mx-auto h-auto w-full max-w-md" />

On success you will see a toast such as **Pushed to "…"** or **Pulled from "…"**. If some workflows fail to redeploy, you get a warning to open and redeploy them manually.

Expand All @@ -134,7 +134,7 @@ The setting belongs to **this workspace's copy** only. Excluding a workflow here

**See activity** (or the Activity view from the Forks header) lists forks, pushes, pulls, and rollbacks that involve this workspace — including events recorded on the other side of the edge.

<Image src="/static/enterprise/forks-activity.png" alt="Activity view showing Fork and Push events with expandable detail rows" width={900} height={614} />
<Image src="/static/enterprise/forks-activity.png" alt="Activity view showing Fork and Push events with expandable detail rows" width={900} height={614} className="mx-auto h-auto w-full max-w-xl" />

Expand a row for names of workflows and resources that were created, updated, or archived, and any warnings (for example failed background copies or deploy failures). A push or pull that copies resources fills their content in the background, and that progress and outcome show in the same row.

Expand Down
7 changes: 4 additions & 3 deletions apps/docs/content/docs/platform/enterprise/scim/entra.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ description: Connect Microsoft Entra ID to Sim and verify user and group provisi

import { Callout } from 'fumadocs-ui/components/callout'
import { Step, Steps } from 'fumadocs-ui/components/steps'
import { Image } from '@/components/ui/image'

Use a non-gallery enterprise application in Microsoft Entra ID to create, update, and deactivate Sim members. Configure [single sign-on](/platform/enterprise/sso) separately for authentication.

Expand Down Expand Up @@ -48,7 +49,7 @@ In the new application's **Provisioning** page, select **New configuration**. Ch

Select **Test connection**, then **Create** after the test succeeds. Entra adds the bearer prefix itself. A successful connection test verifies connectivity and authentication; continue with a test assignment to verify provisioning.

![Entra provisioning connection settings with the deployment URL redacted and secret token masked](/static/enterprise/entra/connection.png)
<Image src="/static/enterprise/entra/connection.png" alt="Entra provisioning connection settings with the deployment URL redacted and secret token masked" width={808} height={305} className="mx-auto h-auto w-full max-w-xl" />

<Callout type="info">
These steps use Entra's current provisioning experience. In the legacy experience, choose **Automatic** provisioning, enter the same credentials under **Admin Credentials**, test the connection, and save. See [Microsoft's SCIM configuration guide](https://learn.microsoft.com/en-us/entra/identity/app-provisioning/use-scim-to-provision-users-and-groups).
Expand All @@ -67,7 +68,7 @@ Under **Attribute mapping**, review the user mappings. The defaults map `userPri

If **Mail** is empty, Entra omits the work email and Sim uses `userName` as the account email. That UPN must be a valid email address in a verified Sim domain.

![Entra provisioning properties restricted to assigned users and groups](/static/enterprise/entra/scope.png)
<Image src="/static/enterprise/entra/scope.png" alt="Entra provisioning properties restricted to assigned users and groups" width={810} height={250} className="mx-auto h-auto w-full max-w-xl" />
</Step>

</Steps>
Expand All @@ -76,7 +77,7 @@ If **Mail** is empty, Entra omits the work email and Sim uses `userName` as the

Open **Provision on demand**, search for the assigned test user, and select **Provision**. Review the import, scope, matching, and action results. In Sim, confirm that the member appears under **Organization → Members** and that **Single sign-on → Provisioning → Activity** shows successful requests.

![Successful on-demand user provisioning in Entra with account details redacted](/static/enterprise/entra/provision-user.png)
<Image src="/static/enterprise/entra/provision-user.png" alt="Successful on-demand user provisioning in Entra with account details redacted" width={812} height={626} className="mx-auto h-auto w-full max-w-xl" />

Change the test user's display name in Entra and provision them again. Confirm the new name in Sim. Repeating provisioning without changes should report that the source and target already match.

Expand Down
Loading
Loading