Core Concepts

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.

​

Overview

Decisional is built around a few core concepts. Understanding these will help you get the most out of the platform.

---

​

Dex

Dex is the conversational operator for Decisional. Use Dex to describe work, create agents, ask what happened in a run, change an existing workflow, or complete one-off tasks against the tools and context you have authorized. Dex helps route requests to the right place:

• Chat Mode for questions, exploration, and one-off work
• Operator Mode for changing an agent’s configuration, workflow, tools, triggers, skills, and policy
• Run Mode for public run links that can be shared without exposing the builder interface

---

​

Agents

Agents are the core operating units in Decisional. Each agent is an AI worker that owns a specific workflow and runs it for you. You create an agent by describing what you want it to do. Dex helps turn that description into instructions, a workflow, required tool connections, and a testable agent. Once live, the agent runs from manual runs, schedules, triggers, or API calls, and you manage changes through the agent surfaces.

​

What Makes Up an Agent

• Instructions — what you told the agent to do, written in plain English
• Workflow — the step-by-step plan the agent built to carry out your instructions
• Integrations — the apps and systems your agent connects to, such as email, CRM, team chat, and spreadsheets
• Sources — documents and files that give your agent context
• Triggers — how your agent gets activated (schedule, event, or manual)
• Approval policy — when the agent pauses, asks for review, bypasses eligible approvals, or blocks an action

​

Agent Operating Modes

​

Agent States

Your agent moves through these states as you set it up:

• Draft — still being configured or built
• Ready — tested and ready to go live
• Live — available for scheduled, triggered, API, or manual runs
• Paused — temporarily stopped, can be resumed anytime

---

​

Workflows

When you describe what you want, your agent creates a workflow — a series of steps it follows to get the job done. Each step in the workflow is a node. Nodes can do things like:

• Read data from a spreadsheet
• Call an API or integration
• Process a document
• Run AI reasoning
• Write results back

You do not need to draw every workflow step by hand. Decisional generates the graph from your instructions, then you review and change it through Operator Mode or Dex.

​

Workflow Viewer

You can see your agent’s workflow visually at any time. It shows every node, how they connect, and the status of each step during a run.

---

​

Integrations

Integrations are the apps your agents connect to and work with. When your agent needs to send a message, update a CRM record, or read from a spreadsheet, it uses an integration.

​

How Integrations Work

1. Your agent identifies which apps it needs based on your instructions
2. You authorize access to each app
3. Your agent can use them in its workflow when the workflow calls for them

Integrations can be shared across your workspace or kept private to specific agents.

---

​

Runs

Every time your agent executes its workflow, that’s a run. You can see all your agent’s runs from the Runs tab.

​

Run Statuses

• Running — your agent is executing right now
• Completed — finished successfully
• Failed — something went wrong
• Needs Approval — your agent is waiting for you to approve an action

​

What’s in a Run

Each run shows you:

• A step-by-step breakdown of what happened at each node
• The input and output data for each step
• Files your agent produced
• How long it took

If a run fails, you can see exactly which step broke and why.

---

​

Approvals

Approvals let agents pause before sensitive actions or manual decision points. A reviewer can see the context, approve the action, reject it, or route the workflow back for changes. Approval behavior comes from:

• Global approval mode in Settings
• Agent-level approval mode for a specific agent
• Tool approval policy for connected tools and actions
• Workflow gates placed directly in a workflow

Use Ask approvals when you want a human review step. Use Bypass approvals only for stable workflows where eligible approval prompts can continue automatically.

---

​

Sources

Sources are documents and files you upload to give your agents context. Think of them as reference material your agent can look up when it needs to.

​

What You Can Upload

• PDFs — contracts, invoices, forms, statements
• Spreadsheets — price lists, templates, historical data
• Word docs — policies, procedures, playbooks
• Images — forms and receipts (your agent can read these with OCR)

​

How Agents Use Sources

Decisional uses retrieval-augmented generation (RAG) to help your agent understand documents. When your agent needs information from a source, it retrieves only the relevant sections instead of trying to process the entire file. This works even across hundreds of pages.

---

​

Workspaces

Workspaces are where your team organizes agents, integrations, and credentials.

​

What’s in a Workspace

• Your agents
• Connected integrations and credentials
• Team members and their permissions
• Sources and documents

​

Team Access

Invite members from your organization into your workspace. Workspace owners control who can view, edit, and manage agents. If you sign up with a company email, you’ll automatically join your organization’s workspace. Personal email addresses get their own workspace.

---

​

How It All Fits Together

---

​

Next Steps