Skip to main content

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.

​
Core Concepts

The conversational operator for Decisional. Dex helps you build agents, ask questions, change workflows, run one-off work, and monitor what happened.Example: Ask Dex to create an agent for quote review, then later ask it to explain a failed run or adjust the approval policy.
An autonomous AI worker that executes your business workflows. Agents understand natural language instructions, process documents, and complete tasks automatically.Example: A Quote Generation Agent that creates customized quotes based on customer requirements.
A full-featured spreadsheet where your agent reads input data and writes output. Worksheets are powered by SpreadJS and support all standard Excel features (formulas, charts, formatting, etc.).Example: A price list where your agent looks up product prices and writes generated quotes.
Documents, files, and links that provide context to your agents. Sources help agents make informed decisions by giving them access to company policies, examples, and reference materials.Example: Uploading past quote PDFs so your agent can match your formatting style.
A single execution of your agent’s workflow. Each time your agent performs its task, that’s a run. Runs have a status (Running, Completed, Failed, Needs Review) and include detailed logs.Example: When your Quote Generation Agent processes 10 customer requests, that’s one run.
A container for your team’s agents, worksheets, sources, and integrations. Workspaces can be personal (individual use) or organizational (team collaboration).Example: “Acme Corp Sales” workspace containing all quote generation and CRM automation agents.
A connection to an external service that your agent can interact with. Integrations enable agents to send emails, update CRMs, post to team chat, query databases, and more.Example: An email integration allowing your agent to send quotes after approval.
The set of rules that decides whether an agent can proceed, must ask for approval, can bypass eligible approvals, or is blocked from taking an action.Example: A reporting agent can always read records but needs approval before sending a final customer-facing message.
The mechanism that activates your agent. Triggers can be time-based (schedule), event-based (webhook, new data), manual (click Run button), or API-based (programmatic).Example: “Run every day at 9 AM” or “Run when a new row is added to the worksheet.”

​
Agent Modes

The conversational mode for an agent. Use it to ask questions, run one-off work, inspect context, and iterate with the agent.
The configuration and monitoring mode for an agent. Use it to change instructions, workflow, tools, triggers, skills, sources, runs, and approval behavior.
The focused run surface for an agent. When the agent is public, Run Mode gives people a public link to run or review the agent without accessing the full builder interface.

​
Technical Terms

A technique where the AI retrieves relevant information from your documents before generating a response. This allows agents to reference specific pages, sections, and data points from your sources.How it works:
  1. Your documents are indexed when uploaded
  2. When the agent runs, it searches for relevant sections
  3. Retrieved content is used to inform the agent’s decisions
  4. The agent cites specific sources and page numbers
Example: Agent extracts pricing from “Q4 Price List.pdf” page 3, paragraph 2, and cites it in the quote.
The exact location within a PDF where information was found. Bounding boxes show the specific paragraph, table, or section the agent referenced, highlighted with a rectangular box.Why it matters: You can verify the agent didn’t hallucinate by seeing exactly what it read.
Technology that extracts text from images and scanned PDFs. Decisional automatically applies OCR to scanned documents so agents can read them.Best practices:
  • Use 300 DPI or higher for scans
  • Ensure good contrast (black text on white background)
  • Avoid skewed or rotated pages
The professional-grade spreadsheet engine powering Decisional worksheets. SpreadJS provides full Excel compatibility including formulas, charts, conditional formatting, and more.
The ability of AI agents to think through problems, handle edge cases, and adapt to new situations - not just follow rigid rules. Agentic reasoning allows Decisional agents to handle complex workflows that traditional automation can’t.Example: If a product is out of stock, the agent suggests alternatives instead of failing.

​
Workflow Terms

The data your agent receives to process. This typically comes from worksheet rows, API calls, email triggers, or form submissions.Example: Customer name, product, and quantity from a “Quote Requests” spreadsheet.
The results your agent produces. This can be written to worksheets, sent via integrations, or returned to another system.Example: Generated quote with calculated prices, discounts, and total.
Natural language description of what your agent should do. Instructions are written like you’re training a new team member.Example:
You are an Invoice Processing Agent.
Extract key details from uploaded invoices and add them to the tracking spreadsheet.
A workflow pattern where the agent pauses for manual review before proceeding. Useful for high-stakes decisions.Example: “If quote exceeds $50,000, flag for manager approval before sending.”
An approval mode where eligible approval prompts continue automatically instead of waiting for a human click. Blocked tools remain blocked.Example: A stable internal report agent can bypass approvals for routine updates after it has been tested.
A workflow node that pauses execution for a human decision before the workflow continues.Example: Require a manager to approve the final contract summary before the agent sends it.
Processing multiple items in a single run. Agents can process entire worksheets or lists of items efficiently.Example: Generate 100 quotes from 100 customer requests in one run.
How your agent responds to problems. Good agents log errors, continue processing remaining items, and notify you of issues.Example: If one invoice fails to process, log it to an “Errors” sheet and continue with the rest.

​
Data & Storage Terms

A single tab within a worksheet (workbook). You can have multiple sheets for organizing data (e.g., “Requests”, “Outputs”, “Errors”, “Reference Data”).
A single box in a spreadsheet, identified by column letter and row number (e.g., A1, B5, Z100).
An Excel-style calculation (e.g., =SUM(A1:A10), =VLOOKUP(B2, Prices!A:B, 2, FALSE)). Agents understand and respect formulas.
A friendly name for a group of cells (e.g., “CustomerNames” for cells B2:B100). Makes formulas more readable.
Rules that constrain what can be entered in cells (e.g., dropdown lists, number ranges, date ranges). Helps ensure data quality.
Automatic cell formatting based on values (e.g., highlight cells red if value > 1000). Useful for visual alerts.

​
Integration & API Terms

A secure authorization method used by integrations. When you connect Gmail, HubSpot, etc., you’re using OAuth to grant Decisional permission to access those services on your behalf.
A callback URL that triggers your agent when an external event occurs. Webhooks enable real-time automation.Example: When a form is submitted on your website, it sends a webhook to trigger your agent.
A way for software to talk to other software. Decisional provides an API for programmatic access, and agents can call external APIs.
A secret token that authenticates API requests. Keep your API keys secure - they grant full access to your workspace.
A specific API URL that performs an action (e.g., /agents/create, /runs/list). Each endpoint has a specific purpose.
A standard way of building APIs using HTTP methods (GET, POST, PUT, DELETE). Decisional’s API is RESTful.

​
Status & States

The agent is currently executing. You can see real-time progress in the run logs.
The agent finished successfully. All outputs have been written and actions taken.
The agent encountered an error and couldn’t complete. Check the run logs for details.
The agent is waiting for human approval before proceeding (human-in-the-loop pattern).
The item is waiting to be processed (e.g., a worksheet row with Status = “Pending”).
A source has been processed and is ready for the agent to search. Sources must be indexed before agents can use them.
A source is currently being indexed. Wait for this to complete before running your agent.

​
Roles & Permissions

The workspace creator. Has full control including billing, deleting workspace, and managing all resources. Each workspace has exactly one owner.
Can manage all agents, invite team members, and configure integrations. Cannot access billing or delete workspace.
Can create, edit, and run agents. Cannot invite team members or delete workspace.
Read-only access. Can view agents and worksheets, run agents, but cannot create or edit anything.

​
File Formats

Simple text format where each line is a row and commas separate columns. No formatting, formulas, or multiple sheets.When to use: Basic data export/import, no formatting needed
Modern Excel format supporting multiple sheets, formulas, charts, formatting, and more.When to use: Full-featured spreadsheets with formulas and formatting
Older Excel format (pre-2007). Still supported but XLSX is preferred.
Static document format. Decisional can extract text and data from PDFs using RAG and OCR.Best for: Contracts, invoices, reports, policies
Microsoft Word format. Good for policies, procedures, and template documents.

​
Quick Reference

TermCategoryDefinition
DexCoreConversational operator for agents
AgentCoreAutonomous AI worker
Chat ModeAgent ModeConversational surface for an agent
Operator ModeAgent ModeBuilder and control surface for an agent
Run ModeAgent ModeFocused public run surface
Approval PolicyCoreRules for review, bypass, and blocked actions
WorksheetCoreSpreadsheet data layer
SourceCoreContext document/file
RunCoreSingle execution
RAGTechnicalRetrieval-Augmented Generation
OCRTechnicalOptical Character Recognition
TriggerWorkflowWhat activates the agent
IntegrationAPIConnected external service
OwnerRoleFull workspace control
IndexedStatusSource ready to use

​
See Also

Core Concepts

Learn about agents, worksheets, sources, and more

FAQ

Common questions and answers

Working with Agents

Detailed agent guide

Approvals and Policy

Approval modes, bypass approvals, and global policy

Support

Contact our team for help