Platform Capacities

Reference the currently supported capacities of the Kognitos platform to confidently design, deploy, and manage automations.

Agents

An agent is a dedicated execution environment within your organization. You can create multiple agents, and each agent can manage many playground and process automations.

Parameter
Optimal Capacity

Agents (per organization)

Up to 100 agents

Playgrounds (per agent)

Up to 200 playgrounds

Processes (per agent)

Up to 200 processes

Optimal capacity values are recommendations. You can create additional agents, playgrounds, and processes, but these ranges help ensure the best automation performance and user experience. See What happens if I exceed the recommended numbers? for details.

Automation Design

A playground or process automation should be written within the following capacity guidelines:

Automation Length
Performance Capacity

1-200 lines

Great — Fastest execution and easiest to maintain

200-500 lines

High — Suitable for more complex workflows

500-1200 lines

Moderate — Can be optimized by breaking into subprocesses

1200+ lines

Needs Optimization — Should be broken into smaller subprocesses

Parameter
Optimal Capacity

Number of Loops

Up to 200 loops

Runs

A run is a single execution instance of a process. Concurrent runs refer to the total number of runs executing at the same time across your organization. Runs can be started manually, triggered via email or API, or scheduled. The platform can support the following number of concurrent runs:

Parameter
Supported Capacity
Description

Concurrent Runs

150 runs

The total number of actively running instances across your entire organization. This includes all process runs (you can run the same process multiple times), parallel child runs, and test suite runs.

Parallel Runs

50 runs (per process)

The maximum number of child processes that a parent process can call and run at the same time. These count toward the concurrent run capacity.

Test Suite Runs

40 runs

The maximum number of test runs that can execute simultaneously in the Test Suite when validating process changes. Test runs also count toward the concurrent run capacity.

See FAQ #4 for more details.

Learnings

Learnings are rules that guide your automation's decision-making. Learnings are isolated to each agent, with no limit on the total number of learnings per agent.

Parameter
Supported Capacity

Learning Length

15,000 characters

Emails

Kognitos supports sending and receiving emails with attachments up to 20 MB. Outgoing emails with oversized attachments are handled using download links. These limits apply only to native email functionality and not to Books (e.g., Outlook, Gmail).

Parameter
Supported Capacity

Email Size

20 MB (including attachments)

For larger input files, use the REST API to trigger new runs.

Files

The platform supports uploading and processing the following file types, up to 1 GB each:

File Type
Extensions
Supported Capacity

PDF

.pdf

1 GB

Images

.jpeg, .jpg, .png, .tif, .tiff

1 GB

Data

.txt, .yml, .yaml, .csv

1 GB

Excel

.xlsx, .xls, .xlsb, .xlsm

1 GB

Documents

.docx, .doc

1 GB

HTML

.html, .htm

1 GB

Email

.eml, .msg

1 GB

ERP

.edi

1 GB

Media

.wav, .mp3, .mp4, .mov, .avi

1 GB

Other

.ttf

1 GB

JSON

.json

1 GB* While uploads up to 1 GB are supported, files larger than 100 KB can't be fully displayed in the interface. These can be downloaded to view the complete content locally.

Department Boxes

Store structured information at scale with capacities designed for fast retrieval and updates.

Parameter
Supported Capacity

Entries

150,000 (per department box)


Frequently Asked Questions

1. What if I need more capacity?

These capacities reflect current performance levels and will continue to expand as the platform grows. If your workload requires higher limits, please reach out to our support team via in-app chat (preferred) or email us at [email protected].

2. What's the difference between agents and automations?

Agents are dedicated execution environments that contain and manage your automations. Each agent is dedicated to your organization, with its own skills and settings, and can hold multiple automations.

Automations are sets of instructions that tell Kognitos what to do — process data, work with documents, send emails, call other processes, and more. These are workflows that can take the form of an early idea (playground) or a complete process. Both playgrounds and processes are considered automations.

The optimal capacity recommendations (100 agents, 200 playgrounds, 200 processes) are guidelines, not hard limits. You can create unlimited agents, playgrounds, and processes. However, exceeding these recommendations may slow down the user interface, causing delays when loading dashboards, navigating lists, or accessing settings. For the best experience, we recommend staying within these ranges.

4. What's the difference between concurrent, parallel, and test suite runs?

Concurrent runs refer to the total number of active runs across your entire organization. You can run the same process multiple times, and each run counts as one concurrent slot.

Example: With a 150 concurrent run limit, you could run the same process 150 times, or 75 runs each of two different processes, or any other combination up to 150 total running instances.

Parallel runs refer to child processes that a single automation spawns to execute simultaneously. One parent process can spawn up to 50 parallel children at once. These parallel runs count toward your concurrent run capacity.

Example: If one process spawns 50 parallel children, it uses 51 concurrent slots (1 parent + 50 children).

Test suite runs are special runs used to validate process changes by comparing results against expected outcomes. You can run up to 40 test runs simultaneously. Test suite runs also count toward the concurrent run capacity.

5. What types of runs count toward the concurrent run capacity?

Only active runs count toward the concurrent run capacity. Process runs do NOT count when:

  • Waiting for user input (exceptions)

  • Waiting to retry after an error

  • Completed (successfully, failed, or stopped)

When a process pauses for user input, it releases capacity for other processes to run.

6. Does it matter how I start a run for it to count toward the capacity limit?

No. All runs count toward the run limit regardless of how they're started — whether triggered manually, via API, by email, or on a schedule.

7. What happens when I reach the concurrent run limit?

When you reach the capacity limit for concurrent runs:

  • API calls to trigger new runs may return 403 errors or "Resource Not Available" messages

  • Process crashes may occur and require reruns or retries

  • Processes beyond the capacity threshold may experience failures

8. Can I retry a process that was rejected due to exceeding capacity?

Yes. If a process is rejected due to exceeding capacity, you can retry it once capacity becomes available. We recommend staying within the capacity thresholds to prevent unexpected behavior.

9. Are API requests limited?

Yes, API endpoints all share the same rate limit pool, including both trigger and query operations (such as status checks). Rate limits differ by region. To check your rate limits, go to API Keys → click on the menu () to the right of an API key → Usage.

Last updated

Was this helpful?