Skip to main content

Settings Reference

The fixed values in Project. Item names follow what the screen shows. How to choose between them is covered in the guides.

Project​

ItemValue
TagsUp to 10
Length of one run5, 15, 30, 60, 90 or 120 minutes, or “No limit (up to the administrator's limit)”. The default is no limit. It applies to each agent run. If the limit set by the administrator is shorter, the run stops there. When the time is reached, the agent is told to wrap up. If it wraps up and finishes, the result is “Completed”; if it cannot finish, or it still has not finished and is cut off, the result is “Timed out”
Retries per step (failed / timed out)0 to 10. The default is 2. Used in workflow runs for failures on the platform's side (such as an abnormality in the runtime, or a timeout), and counted for each agent placed on the step, each time the run enters that step
Notify owners after consecutive failures (email, push)3 (it cannot be changed on the screen). When sweeps of the same placement of a cycle fail this many times in a row, a notice goes by mail and push notification to the owners and others. The value is shown on the Settings tab
Send-back limit (per target step)1 to 10. 3 by default. How many times one run can be sent back to the same step. Both reviewers' send-backs and automatic ones at the deadline count. A change applies to runs started afterwards
Workflow runs in progress at onceUp to 3. Runs that are running and runs awaiting review are counted. Starting a new one while there are already 3 is refused (resuming a closed run too)
Default run deadline (hours after start) (workflows)None, or 6, 12, 24, 48, 72, 168, 336 or 720 hours. The default is “None”. Once set, every run started afterwards gets a deadline. The run does not stop when it passes
Hours before a run counts as stalled (workflows)6, 12, 24, 48, 72 or 168 hours. The default is 24 hours
Default contact when overdue (workflows)One of the project's members. The default is “None”. Used for review requests with no escalation contact on their step
Reason for resuming a closed runRequired. Up to 1000 characters
Organization“No organization”, or an organization the person setting it currently belongs to. Once set, it cannot be changed

Steps​

ItemValue
Number of stepsUp to 12. You cannot delete steps to go below the minimum (2 for a workflow, 1 for a cycle)
Steps when you create a project without specifying anyA workflow gets 3: “Run by Agent” → “Human review” → “Run by Agent”. A cycle gets 2 “Run by Agent” steps
Trigger (workflow)The default is “Right after the previous step”. Choose “At a set time” and the initial value is 9:00 every day
Handling of results (workflow)“When not allowed by rules” defaults to “Ask for review (awaiting review)”. “When the agent reports it could not finish” defaults to “Ask for review”. Either can be set to “Go to a specific step”, choosing the destination from the later enabled steps (in the same parallel lane where there are parallel lanes; outside the lanes, from the same side of the split — before it, or after the join)
Run at the same time (workflows)Off by default (one at a time, in placement order). Available on a “Run by Agent” step with two or more agents placed, except on the step the lanes split from
Lanes (workflows)One split. It divides into 2 to 11 lanes, joining once every lane has finished. Lane names up to 50 characters. Each lane needs at least one step
Branch (workflows)Up to 11 lanes (each lane needs at least one step; up to 12 steps in all, including the Branch step; lane names up to 50 characters). Conditions: 1 to 8 (without a condition, the changes cannot be applied). The rule's words, the JSON field name and the value to compare with, and the question for “question” conditions are up to 200 characters; numbers are whole numbers of 0 or more. “When no condition matches” defaults to “Join directly”
Output handed over from the previous step (workflows)The last answer of each agent on the previous step is handed over up to 20,000 characters each (up to 40,000 characters in all when several are received). Anything beyond that is cut off (Design Guide)
Values and file roles passed to the next step (workflows)“Run by Agent” steps only. Up to 5 values and 3 roles. Names up to 40 characters, descriptions up to 200. A name cannot repeat across values and roles. Each returned value is up to 1,000 characters; anything beyond that is cut off

Agents​

ItemValue
NameRequired
Goal (instructions)Required
GuardrailOptional
DescriptionOptional
Playbook0 or 1
SkillsUp to 10
Input filesUp to 10

Review steps​

ItemValue
Kind of review“Review (a person judges the Agent's result)” or “Manual work (AI does not run; a person does the work, then proceeds)”. The default is Review
ReviewersUp to 20, from the project's members. A workflow cannot start while an enabled review step has no reviewer
Review method“Stop and wait for a decision” or “Notify and proceed after the deadline”. The default is “Stop and wait for a decision”
Deadline (hours)1 to 720 hours. Left empty, it is 24 hours
When the deadline passes“Notify and keep waiting”, “Proceed automatically”, “Send back automatically” or “Reject automatically”. The default is “Notify and keep waiting”. It cannot be chosen when the review method is “Notify and proceed after the deadline”
Destination options2 to 5 steps after this one (in the same parallel lane where there are parallel lanes; outside the lanes, from the same side of the split — before it, or after the join). Display names up to 100 characters. With options, “When the deadline passes” cannot be chosen, and they cannot be combined with “Notify and proceed after the deadline”
Escalation contact when overdueOne of the project's members. The default is “None” (if the project has a “Default contact when overdue”, that person)
Extending the deadlineWith a bulk action in “Action needed”, give a date and time later than now. It is not bound by the 720 hours above. The deadline of a connection confirmation cannot be extended

Execution rules​

ItemValue
Basic rulesOpen / Guarded / Strict. A newly created project starts on “Use the global basic rules”. A copied project keeps the execution rules of the project it was copied from
Forbidden operations added by the projectUp to 50

Connectors and notifications​

ItemValue
ConnectorsUp to 50
Confirm before connecting (per connector)“Don't confirm”, “Confirm first use only” or “Confirm every time”. “Don't confirm” by default. Cannot be set for an agent (A2A) connector
Wait limit (minutes) (per connector)1 to 1440 minutes. 60 by default. When it passes, the connection confirmation is decided as rejected
Notifications (workflow)Five: “Review requested”, “Review deadline reminder”, “Review overdue”, “Run past its deadline” and “Run stalled”. All are on by default

Triggers​

ItemValue
Time trigger (workflow)You can attach several. When you add one, the initial value is “Daily” at 9:00
Start stepThe default is “First enabled step”
Sweep schedule (cycle)Not set at first. Switch on “Enable sweeping” and it becomes “Interval”, every 15 minutes
Quiet hours and days (cycle)Available when the sweep schedule is “Interval” or “Hourly”. The hours are on the hour, with a start and an end (the time it starts again) that differ. Not every day can be chosen
Start by emailAvailable where the email feature is enabled. One address per project. Up to 20 allowed external senders (each a complete address). The body can be up to 20,000 characters. Up to 10 attachments, each up to 10 MiB
Ways to give the timeInterval / Hourly / Daily / Weekdays / Weekly / Custom (cron). Weekly takes one or more days
Interval1 to 1440 minutes. Under 60 minutes, only a number of minutes that divides 60 (1, 2, 3, 4, 5, 6, 10, 12, 15, 20 or 30); from 60 minutes up, only a number of hours that divides 24 (1, 2, 3, 4, 6, 8, 12 or 24)
TimezoneAlways chosen. Times are taken in the timezone you choose. Before saving, check that the timezone is the one you intend

Writing a Custom (cron) expression​

Write five fields separated by single-byte spaces. The times are taken in the timezone you chose.

PositionFieldValues
1Minute0–59
2Hour0–23
3Day of month1–31
4Month1–12, or JAN–DEC
5Day of week0–7, or SUN–SAT (0 and 7 are both Sunday)

Every field accepts the following forms.

FormMeaningExample
*Every value* * * * * (every minute)
?Same as * (every value)0 9 ? * 1-5 (9:00 on weekdays)
A numberThat value0 9 * * * (9:00 every day)
n,mA list0 9,18 * * * (9:00 and 18:00 every day)
n-mA range0 9 * * 1-5 (9:00 on weekdays)
*/nEvery n*/15 * * * * (every 15 minutes)
n/kEvery k, starting at n (up to the field's maximum)5/15 * * * * (minutes 5, 20, 35 and 50 of every hour)
n-m/kEvery k within a range0 9-17/2 * * * (every 2 hours from 9:00 to 17:00)

A value out of range (including the start of a step, such as the 70 in 70/5), a value other than a number or a name, a step of 0 or less, a reversed range (for example 5-1), or an empty element (for example 5,,10) makes the whole expression invalid.

Action needed​

ItemValue
Rows listed at a timeUp to 100. Beyond that, “◯ more not shown” appears
Reason for bulk actions (reject, send back)Entered once; the same reason goes on every row
Reassigning approvers1 to 50 of the project's members. Replaces the reviewers of the undecided review requests, run by run
Rerunning a sweepOnce per sweep. Starting a sweep again after a connection confirmation is approved uses this one time too
Automatic retry of a sweepOnce, shortly after it ended, for a periodic sweep that ended “Failed” or “Timed out”. A retried sweep is not retried again

Project library​

ItemValue
Size of a fileUp to 512 MB
File nameUp to 255 characters. A file with the same name cannot be registered
Manage versionsUp to 50 versions, newest first
Files selected at once when uploadingUp to 20
Files that can become a new versionOnly the same type (extension) as the original
Files registered from your own library at onceUp to 20
Files synced for one placement (Files synced with the library)Up to 20. The name in the workspace is a file name only (folders cannot be given)

Records and metrics​

ItemValue
KPI period (“Results of this work” on a project's Overview)7 days / 30 days / 90 days. The initial value is 30 days
Insights period7 days / 30 days / 90 days. The initial value is 30 days
CSV export of Records (audit trail)Up to 5000, newest first
Search terms (project list, Records (audit trail), editor lists, Agent library, member candidates)Up to 100 characters
Search terms (execution history)Up to 200 characters

Creating with AI​

The features for creating with the AI are alpha, and these values may change (Design Guide).

ItemValue
Number of steps the AI creates (Create through consultation)Up to 8. To use up to 12, add them after the project is created
Number of steps the AI creates (Guided setup)Up to 8. When a workflow template with a fixed step structure is used as a workflow, the template's number of steps (up to 12)