# 設定値リファレンス

プロジェクトで決まっている値の一覧です。項目の名前は画面の表示に合わせています。どれを選ぶかの考え方は、各ガイドにあります。

## プロジェクト

| 項目                            | 値                                                                                                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| タグ                            | 10 個まで                                                                                                                                                                                |
| 1回の実行の長さ                      | 5・15・30・60・90・120 分か「制限しない（管理者の上限まで）」。既定は「制限しない」。Agent の 1 回の実行ごとに効きます。管理者が設定した上限のほうが短いときは、そちらで停止します。その時間に達すると Agent にまとめに入らせます。まとめて完遂すれば結果は「完了」、完遂できなかったときと、それでも終わらず打ち切ったときは「時間切れ」です |
| 工程ごとの再試行回数 (失敗・時間切れ)          | 0〜10 回。既定は 2 回。ワークフローの実行で、基盤側の失敗（実行環境の異常や時間切れなど）のときに使われ、工程に置いた Agent ごとに、その工程に入るたびに数えます                                                                                               |
| 連続して失敗したらオーナーへ通知する (メール・Push) | 3 回（画面からは変えられません）。サイクルの同じ配置の巡回が続けてこの回数失敗すると、オーナーなどにメールとプッシュ通知で届きます。値は 設定 タブに出ます                                                                                                       |
| 差し戻しの上限（同じ戻り先への回数）            | 1〜10 回。既定は 3 回。1 回の実行の中で、同じ工程へ差し戻せる回数。担当者の差し戻しも、期限による自動の差し戻しも数えます。変更は次に始まる実行から使われます                                                                                                   |
| 同時に進められるワークフローの実行             | 3 件まで。実行中と確認待ちの実行を数えます。3 件あるときに新しく始めようとすると、断られます（閉じた実行の再開も同じ）                                                                                                                         |
| 実行の既定の締め切り（開始からの時間）（ワークフロー）   | なし・6・12・24・48・72・168・336・720 時間。既定は「なし」。設定すると、そのあとに始まる実行ごとに締め切りが付きます。過ぎても実行は止まりません                                                                                                    |
| 停滞とみなす時間（ワークフロー）              | 6・12・24・48・72・168 時間。既定は 24 時間                                                                                                                                                        |
| 期限超過時の連絡先（既定）（ワークフロー）         | プロジェクトのメンバーから 1 人。既定は「なし」。工程に期限超過時の連絡先が無い確認依頼で使われます                                                                                                                                   |
| 閉じた実行の再開の理由                   | 必須。1000 文字まで                                                                                                                                                                          |
| 所属組織                          | 「組織未設定」か、付ける人の今の所属組織。一度付けると変えられません                                                                                                                                                    |

## 工程

| 項目                     | 値                                                                                                                                                                                                                                                                                                                                      |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 工程の数                   | 12 個まで。削除して下限（ワークフローは 2 個、サイクルは 1 個）より少なくすることはできません                                                                                                                                                                                                                                                                                    |
| 工程を指定せずに作ったときの工程       | ワークフローは「Agent が実行」→「確認工程」→「Agent が実行」の 3 個。サイクルは「Agent が実行」の工程 2 個                                                                                                                                                                                                                                                                     |
| 起動条件（ワークフロー）           | 既定は「前の工程の完了後すぐ」。「所定の時刻に」を選ぶと、初期値は毎日 9:00                                                                                                                                                                                                                                                                                               |
| 結果の扱い（ワークフロー）          | 「ルールにより実行できない場合」の既定は「確認を求める (確認待ち)」。「Agent の報告による失敗のとき」の既定は「確認を求める」。どちらも「指定した工程へ進む」を選べ、次の工程は後ろの有効な工程から選びます（並列のレーンがあるときは同じレーン、レーンの外では並列の前どうし・合流のあとどうしの工程から）                                                                                                                                                                             |
| 同時に実行（ワークフロー）          | 既定はオフ（配置順に 1 体ずつ）。「Agent が実行」の工程に Agent を 2 体以上置いたときに使えます。並列に進む前の工程には設定できません                                                                                                                                                                                                                                                           |
| 並列のレーン（ワークフロー）         | 並列は 1 か所。2〜11 本に分かれ、全レーンが終わってから合流します。レーン名は 50 文字まで。各レーンに工程が 1 つ以上要ります                                                                                                                                                                                                                                                                  |
| 条件分岐（ワークフロー）           | レーンは 11 本まで（各レーンに工程が 1 つ以上。工程は条件分岐を含めて全部で 12 まで。レーン名は 50 文字まで）。条件は 1〜8 件（条件が無いと反映できません）。規則の語・JSON の項目の名前と比べる値・「質問で判定」の質問は 200 文字まで、数は 0 以上の整数。「どの条件にも当てはまらないとき」の既定は「何もせずに合流」                                                                                                                                                           |
| 前の工程から渡る出力（ワークフロー）     | 前の工程の Agent の最後の回答が、1 つにつき 20,000 文字まで渡ります（いくつか受け取るときは、合わせて 40,000 文字まで）。超えた分は切れます（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%A7%E4%BD%95%E3%81%8C%E5%BC%95%E3%81%8D%E7%B6%99%E3%81%8C%E3%82%8C%E3%82%8B%E3%81%8B)） |
| 次の工程に渡す値と資料の役割（ワークフロー） | 「Agent が実行」の工程だけ。値は 5 つ・役割は 3 つまで。名前は 40 文字・説明は 200 文字まで。名前は値と役割を通して重ねられません。返された値は 1 つ 1,000 文字までで、超えた分は切れます                                                                                                                                                                                                                           |

## Agent

| 項目       | 値      |
| -------- | ------ |
| 名前       | 必須     |
| ゴール (指示) | 必須     |
| ガードレール   | 任意     |
| 説明       | 任意     |
| Playbook | 0〜1 つ  |
| Skills   | 10 件まで |
| 入力ファイル   | 10 件まで |

## 確認工程

| 項目        | 値                                                                                                                                |
| --------- | -------------------------------------------------------------------------------------------------------------------------------- |
| 確認の種類     | 「確認 (Agent の結果を人が判断する)」または「手作業 (AI は実行せず、人が作業してから進める)」。既定は「確認」                                                                   |
| 確認担当者     | プロジェクトのメンバーから 20 人まで。有効な確認工程に担当者が 1 人もいないと、ワークフローを始められません                                                                        |
| 確認方法      | 「担当者の判断を待つ」または「期限後に自動で進める」。既定は「担当者の判断を待つ」                                                                                        |
| 確認期限（時間）  | 1〜720 時間。空欄なら 24 時間                                                                                                              |
| 期限を過ぎたら   | 「通知して待機する」「自動で進める」「自動で差し戻す」「自動で却下する」。既定は「通知して待機する」。確認方法が「期限後に自動で進める」のときは選べません                                                    |
| 次の工程の候補   | この工程より後ろの工程から 2〜5 件（並列のレーンがあるときは同じレーン、レーンの外では並列の前どうし・合流のあとどうしの工程から）。表示名は 100 文字まで。候補があるときは「期限を過ぎたら」を選べず、「期限後に自動で進める」とは組み合わせられません |
| 期限超過時の連絡先 | プロジェクトのメンバーから 1 人。既定は「なし」（プロジェクトの「期限超過時の連絡先（既定）」があれば、その人）                                                                        |
| 確認期限の延長   | 「対応待ち」の一括操作で、今より後の日時を指定します。上の 720 時間には縛られません。接続の確認の期限は延ばせません                                                                     |

## 実行ルール

| 項目              | 値                                                                                   |
| --------------- | ----------------------------------------------------------------------------------- |
| 基本ルール           | Open／Guarded／Strict。新しく作ったプロジェクトは「全体の基本ルールを使用する」。コピーしたプロジェクトは、元のプロジェクトの実行ルールを引き継ぎます |
| プロジェクトで追加する禁止操作 | 50 件まで                                                                              |

## 連携先と通知

| 項目              | 値                                                          |
| --------------- | ---------------------------------------------------------- |
| 連携先             | 50 件まで                                                     |
| 接続時の確認（連携先ごと）   | 「確認しない」「初回のみ確認」「毎回確認」。既定は「確認しない」。エージェント連携（A2A）の連携先には設定できない |
| 待ちの上限（分）（連携先ごと） | 1〜1440 分。既定は 60 分。過ぎると、接続の確認は却下として決まります                    |
| 通知（ワークフロー）      | 「確認の依頼」「確認期限の催促」「確認期限の超過」「実行の締め切り超過」「実行の停滞」の 5 つ。既定はどれもオン  |

## 起動

| 項目                | 値                                                                                                                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------------ |
| 時間トリガー（ワークフロー）    | 複数付けられます。追加するときの初期値は「毎日」の 9:00                                                                                     |
| 開始する工程            | 既定は「最初の有効な工程」                                                                                                      |
| 巡回の周期（サイクル）       | 初期値は未設定。「巡回を有効にする」をオンにすると、「周期」の 15 分ごとになります                                                                        |
| 実行しない時間帯・曜日（サイクル） | 巡回の周期で「周期」か「毎時」を選んだときに使えます。時間帯は正時で、開始と終了（再開する時刻）を別の時刻にします。曜日は、全部は選べません                                             |
| メールで起動            | メールの機能が有効な環境で使えます。宛先はプロジェクトごとに 1 つ。許可する外部の送信元は 20 件まで（アドレス全体を 1 件ずつ）。本文は 20,000 文字まで。添付ファイルは 10 件まで（1 件 10 MiB まで） |
| 時刻の選び方            | 周期／毎時／毎日／平日／毎週／カスタム (cron)。毎週は曜日を 1 つ以上選びます                                                                        |
| 周期                | 1〜1440 分。60 分未満は 60 を割り切る分（1・2・3・4・5・6・10・12・15・20・30 分）、60 分以上は 24 時間を割り切る時間（1・2・3・4・6・8・12・24 時間）だけ指定できます        |
| タイムゾーン            | 必ず選びます。時刻は、選んだタイムゾーンの時刻として扱われます。保存する前に、タイムゾーンが意図したものか確かめてください                                                      |

### カスタム (cron) の書き方

5 つの項目を半角の空白で区切って書きます。選んだタイムゾーンの時刻として扱われます。

| 位置 | 項目 | 値                              |
| -- | -- | ------------------------------ |
| 1  | 分  | 0〜59                           |
| 2  | 時  | 0〜23                           |
| 3  | 日  | 1〜31                           |
| 4  | 月  | 1〜12、または JAN〜DEC               |
| 5  | 曜日 | 0〜7、または SUN〜SAT（0 と 7 はどちらも日曜） |

どの項目にも、次の書き方が使えます。

| 書き方     | 意味                    | 例                                     |
| ------- | --------------------- | ------------------------------------- |
| `*`     | すべて                   | `* * * * *`（毎分）                       |
| `?`     | `*` と同じ（すべて）          | `0 9 ? * 1-5`（平日の 9:00）               |
| 数値      | その値                   | `0 9 * * *`（毎日 9:00）                  |
| `n,m`   | 列挙                    | `0 9,18 * * *`（毎日 9:00 と 18:00）       |
| `n-m`   | 範囲                    | `0 9 * * 1-5`（平日の 9:00）               |
| `*/n`   | n ごと                  | `*/15 * * * *`（15 分ごと）                |
| `n/k`   | n から始めて k ごと（項目の上限まで） | `5/15 * * * *`（毎時 5・20・35・50 分）       |
| `n-m/k` | 範囲の中で k ごと            | `0 9-17/2 * * *`（9:00〜17:00 の 2 時間ごと） |

範囲の外の値（`70/5` の 70 のような、刻みの起点も含みます）・数字と名前以外の値・0 以下の刻み・逆順の範囲（例: `5-1`）・空の要素（例: `5,,10`）があると、式全体が無効になります。

## 対応待ち

| 項目               | 値                                                    |
| ---------------- | ---------------------------------------------------- |
| 一度に並ぶ行           | 100 件まで。それより多いときは「ほか◯件は表示していません」と出ます                 |
| 一括操作の理由（却下・差し戻し） | 1 回入れて、全件に同じ理由を付けます                                  |
| 担当の付け替え          | プロジェクトのメンバーから 1〜50 人。実行ごとに、まだ決まっていない確認依頼の担当を置き換えます   |
| 巡回の再実行           | 同じ巡回につき 1 回。接続の確認の承認で巡回を起動し直したときも、この 1 回を使います        |
| 巡回の自動の取り直し       | 「失敗」「時間切れ」で終わった周期の巡回を、終わって間もないうちに 1 回。取り直した巡回は取り直さない |

## プロジェクトのライブラリ

| 項目                               | 値                                     |
| -------------------------------- | ------------------------------------- |
| 1 ファイルの大きさ                       | 512 MB まで                             |
| ファイルの名前                          | 255 文字まで。同じ名前のファイルは登録できません            |
| バージョンの管理                         | 新しい順に 50 個まで出ます                       |
| アップロードで一度に選べる数                   | 20 件まで                                |
| 新しいバージョンにできるファイル                 | 元のファイルと同じ種類（拡張子）だけ                    |
| 自分のライブラリから一度に登録できる数              | 20 件まで                                |
| 1 つの配置で同期できるファイル（ライブラリと同期するファイル） | 20 件まで。作業場所での名前はファイル名だけ（フォルダは指定できません） |

## 記録と指標

| 項目                                                       | 値                       |
| -------------------------------------------------------- | ----------------------- |
| KPI の期間（概要の「この業務の実行結果」）                                  | 7 日／30 日／90 日。初期値は 30 日 |
| 全体集計の期間                                                  | 7 日／30 日／90 日。初期値は 30 日 |
| 記録 (証跡) の CSV出力                                          | 新しい順に 5000 件まで          |
| 検索語（プロジェクトの一覧・記録 (証跡)・編集画面の一覧・Agent のライブラリ・メンバーを足すときの候補） | 100 文字まで                |
| 検索語（実行履歴）                                                | 200 文字まで                |

## AI で作る

AI で作る機能は α 版で、値は今後変わることがあります（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)）。

| 項目                 | 値                                                         |
| ------------------ | --------------------------------------------------------- |
| AI が作る工程の数（相談して作る） | 8 個まで。12 個まで使うときは、作ったあとに足します                              |
| AI が作る工程の数（誘導で作る）  | 8 個まで。工程の形が決まったワークフローのひな形をワークフローのまま使うときは、ひな形の工程の数（12 個まで） |
