# 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

| Item                                                   | Value                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tags                                                   | Up to 10                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Length of one run                                      | 5, 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 once                      | Up 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 run                       | Required. Up to 1000 characters                                                                                                                                                                                                                                                                                                                                                                                              |
| Organization                                           | “No organization”, or an organization the person setting it currently belongs to. Once set, it cannot be changed                                                                                                                                                                                                                                                                                                             |

## Steps

| Item                                                      | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Number of steps                                           | Up 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 any    | A 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](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md#what-is-handed-over-in-a-workflow))                                                                                                               |
| 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

| Item                | Value    |
| ------------------- | -------- |
| Name                | Required |
| Goal (instructions) | Required |
| Guardrail           | Optional |
| Description         | Optional |
| Playbook            | 0 or 1   |
| Skills              | Up to 10 |
| Input files         | Up to 10 |

## Review steps

| Item                            | Value                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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                                                                                                                                                                                                     |
| Reviewers                       | Up 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 options             | 2 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 overdue | One of the project's members. The default is “None” (if the project has a “Default contact when overdue”, that person)                                                                                                                                                                                                                             |
| Extending the deadline          | With 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

| Item                                      | Value                                                                                                                                                                 |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Basic rules                               | Open / 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 project | Up to 50                                                                                                                                                              |

## Connectors and notifications

| Item                                      | Value                                                                                                                                     |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Connectors                                | Up 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

| Item                         | Value                                                                                                                                                                                                                |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Time trigger (workflow)      | You can attach several. When you add one, the initial value is “Daily” at 9:00                                                                                                                                       |
| Start step                   | The 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 email               | Available 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 time        | Interval / Hourly / Daily / Weekdays / Weekly / Custom (cron). Weekly takes one or more days                                                                                                                         |
| Interval                     | 1 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)      |
| Timezone                     | Always 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.

| Position | Field        | Values                                    |
| -------- | ------------ | ----------------------------------------- |
| 1        | Minute       | 0–59                                      |
| 2        | Hour         | 0–23                                      |
| 3        | Day of month | 1–31                                      |
| 4        | Month        | 1–12, or JAN–DEC                          |
| 5        | Day of week  | 0–7, or SUN–SAT (0 and 7 are both Sunday) |

Every field accepts the following forms.

| Form     | Meaning                                            | Example                                                 |
| -------- | -------------------------------------------------- | ------------------------------------------------------- |
| `*`      | Every value                                        | `* * * * *` (every minute)                              |
| `?`      | Same as `*` (every value)                          | `0 9 ? * 1-5` (9:00 on weekdays)                        |
| A number | That value                                         | `0 9 * * *` (9:00 every day)                            |
| `n,m`    | A list                                             | `0 9,18 * * *` (9:00 and 18:00 every day)               |
| `n-m`    | A range                                            | `0 9 * * 1-5` (9:00 on weekdays)                        |
| `*/n`    | Every n                                            | `*/15 * * * *` (every 15 minutes)                       |
| `n/k`    | Every k, starting at n (up to the field's maximum) | `5/15 * * * *` (minutes 5, 20, 35 and 50 of every hour) |
| `n-m/k`  | Every k within a range                             | `0 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

| Item                                        | Value                                                                                                                       |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Rows listed at a time                       | Up 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 approvers                       | 1 to 50 of the project's members. Replaces the reviewers of the undecided review requests, run by run                       |
| Rerunning a sweep                           | Once per sweep. Starting a sweep again after a connection confirmation is approved uses this one time too                   |
| Automatic retry of a sweep                  | Once, shortly after it ended, for a periodic sweep that ended “Failed” or “Timed out”. A retried sweep is not retried again |

## Project library

| Item                                                           | Value                                                                             |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Size of a file                                                 | Up to 512 MB                                                                      |
| File name                                                      | Up to 255 characters. A file with the same name cannot be registered              |
| Manage versions                                                | Up to 50 versions, newest first                                                   |
| Files selected at once when uploading                          | Up to 20                                                                          |
| Files that can become a new version                            | Only the same type (extension) as the original                                    |
| Files registered from your own library at once                 | Up 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

| Item                                                                                               | Value                                                    |
| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| KPI period (“Results of this work” on a project's Overview)                                        | 7 days / 30 days / 90 days. The initial value is 30 days |
| Insights period                                                                                    | 7 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](https://developers.fd.agenticstar.tm.softbank.jp/en/docs/saas/project/guide/design-guide.md)).

| Item                                                         | Value                                                                                                                          |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| 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) |
