> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decisional.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Dex

> Start work, ask questions, run agents, and review approvals from the web app, Slack, email, or mobile

Dex is Decisional's conversational operator. Use it to ask questions about agents and runs, start one-off work, run agents, view agent details, and review approvals across the tools and context your workspace has authorized.

## How Dex Runs

Each organization's Dex runs on its own dedicated orchestrator computer (VM). This long-running computer receives requests, keeps channel connections available, and carries out work using the tools and context your organization has authorized.

Open **Settings → Organization** to see whether the computer is running. Organization owners and admins can open, stop, start, or delete it. They can also choose the model and runtime settings. Some settings changes briefly restart the computer while the new configuration is applied.

<Frame caption="Organization settings show Dex's dedicated computer, model and runtime, and connected channels.">
  <img src="https://mintcdn.com/decisional/p_K8KTgUaUdelXwd/images/dex/dex-settings-channels.png?fit=max&auto=format&n=p_K8KTgUaUdelXwd&q=85&s=043e740e82b22138b8b5b2b826c1d630" alt="Organization settings showing a running Dex orchestrator and channel options for Slack, SMS or iMessage, email, and Telegram" width="1696" height="927" data-path="images/dex/dex-settings-channels.png" />
</Frame>

## What You Can Ask For

<CardGroup cols={2}>
  <Card title="Understand work" icon="message">
    Ask about an agent, source, run, file, approval, or output without opening every underlying screen.
  </Card>

  <Card title="Run one-off tasks" icon="bolt">
    Use an agent's available context and connected tools for work that does not need a reusable workflow.
  </Card>

  <Card title="Explain runs" icon="clipboard-check">
    Summarize what happened, identify the step that broke, and surface the relevant logs, files, or outputs.
  </Card>

  <Card title="Run agents" icon="play">
    Start an agent, check its details, or review recent runs without opening every underlying screen.
  </Card>
</CardGroup>

## Channels

Dex can meet you where the work starts. You can connect several channels at the same time, such as Slack and email for the organization and SMS or iMessage for your own account. Requests from every connected channel are routed to the same organization Dex.

<CardGroup cols={2}>
  <Card title="Web app" icon="globe">
    Start new work, inspect runs, review files, and open the Decisional web app when configuration needs to change.
  </Card>

  <Card title="Slack" icon="slack">
    Chat with Dex from team conversations, ask for updates, and keep work moving without leaving the thread where the request started.
  </Card>

  <Card title="Email" icon="envelope">
    Send requests, receive summaries, and handle asynchronous follow-ups through email when a workflow needs a written trail.
  </Card>

  <Card title="SMS or iMessage" icon="phone">
    Text Dex from your phone through a personal connection. You can optionally route that number to a specific agent.
  </Card>

  <Card title="Telegram" icon="paper-plane">
    Connect a Telegram bot so people can talk to the organization Dex from Telegram.
  </Card>

  <Card title="Google Chat or Microsoft Teams" icon="comments">
    Connect Dex to supported chats, spaces, or channels used by your team.
  </Card>
</CardGroup>

Configure these connections in **Settings → Organization → Channels**. Expand a channel to connect it or review its setup.

### How channel scope works

The scope label tells you who uses the connection:

* **Org-wide** connections are shared by everyone in the organization. Slack, email, Telegram, Google Chat, and Microsoft Teams use this scope.
* **Personal** connections belong only to the signed-in account. SMS or iMessage uses this scope, and each account can connect one number.

The Settings tabs use the same idea:

* **Account** contains settings that affect only you, such as your profile and notifications.
* **Workspace** contains settings for the workspace selected in the top-left menu, such as members, access, and workspace keys.
* **Organization** contains settings shared across the organization, including the dedicated Dex computer, model and runtime, channels, and audit log.

<Note>
  The selected workspace determines your current context and whether you have permission to manage the organization. It does not create a separate Dex computer for every workspace: the dedicated computer belongs to the organization.
</Note>

<Frame>
  <video controls playsInline muted preload="metadata" src="https://mintcdn.com/decisional/z0qNWho6sRoSiUbW/videos/pmm/dex-in-slack.mp4?fit=max&auto=format&n=z0qNWho6sRoSiUbW&q=85&s=ba2026843f4d264d62fbf1bf54079c33" data-path="videos/pmm/dex-in-slack.mp4" />
</Frame>

## Approval requests

When you ask Dex to perform a write action from Slack, such as creating a Linear issue, Dex can post an approval request before the action runs. The request summarizes the action, shows the app or record involved, includes an approval link, and keeps the review in the same thread as the original ask.

<Frame>
  <img src="https://mintcdn.com/decisional/IFSOOf2eTUcGlvVM/images/agents/dex-slack-approval-request.png?fit=max&auto=format&n=IFSOOf2eTUcGlvVM&q=85&s=2d9eb02cf81c85c53b79cf750d3adda5" alt="Dex approval request in Slack before creating a Linear issue" width="2132" height="932" data-path="images/agents/dex-slack-approval-request.png" />
</Frame>

In this example, Dex waits to create the Linear issue until someone selects **Approve creation**. The expiration timestamp limits how long the approval link can be used, and the thread keeps the request, approval, and resulting artifact together.

<Card title="Approvals and Policy" icon="user-check" href="/agents/approvals">
  Learn how ask, bypass, and tool policies control agent actions.
</Card>

## Relationship to Agents

Dex is where you ask for work and review what happened. Agents are saved automations with their own instructions, connected tools, schedules, files, run history, and approval settings.

Use Dex to run an agent or inspect its details and runs. For configuration changes, Dex points you to the Decisional web app, where you can edit the agent's setup.

## Related docs

<CardGroup cols={2}>
  <Card title="Agent Modes" icon="robot" href="/agents/modes">
    Understand Chat Mode, Operator Mode, and Run Mode for agents.
  </Card>

  <Card title="Approvals and Policy" icon="user-check" href="/agents/approvals">
    Learn how ask, bypass, and tool policies control agent actions.
  </Card>
</CardGroup>
