# 設定値リファレンス

マーケットプレイス版のプロジェクトで決まっている値の一覧です。**SaaS 版と同じ値は載せていません。** 載っていない項目は、SaaS 版の[設定値リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md)を参照してください。項目の名前は画面の表示に合わせています。

## プロジェクト

| 項目                   | 値                                                                                                                                                                                                                                                                                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 型の既定                 | ワークフロー（SaaS 版はサイクル）                                                                                                                                                                                                                                                                                                                                          |
| 作成方法                 | 作成の画面では「自分で作る」「社内のひな形から作る」「ファイルから取り込む」。AI に相談して作る・誘導で作る・既存のプロジェクトから作るは、作成の画面にはありません（今あるプロジェクトは、「複製する」「自分のプロジェクトにコピー」で写せます）                                                                                                                                                                                                                                   |
| プロジェクトの数             | 1 つの環境で 5 件まで（消したもの・アーカイブしたものは数えません）。6 件目になる作成とアーカイブからの戻しは断られます                                                                                                                                                                                                                                                                                              |
| 工程ごとの再試行回数 (失敗・時間切れ) | 画面では 0〜10 回を選べますが、登録 Agent の工程で効くのは**最大 2 回**です。自動で再試行するのは、契約の「外部への効果」が「読み取りのみ」か「書き込み (再送しても同じ結果)」で、何が起きたかが分かっている失敗のときだけです。回数を使い切ると案件は失敗で閉じます（[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md#%E3%81%86%E3%81%BE%E3%81%8F%E3%81%84%E3%81%8B%E3%81%AA%E3%81%8B%E3%81%A3%E3%81%9F%E3%81%A8%E3%81%8D)） |

## 工程

| 項目                                      | 値                                                                                                                                                                                                                                                                                      |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 工程に置ける Agent（ワークフロー）                    | 管理コンソールでワークフローの契約を登録し、**認定済み**の登録 Agent だけ                                                                                                                                                                                                                                             |
| 工程に置ける Agent（サイクル）                      | 管理コンソールで有効にした登録 Agent（会話で使う Agent）。契約・認定は要りません                                                                                                                                                                                                                                         |
| 並列のレーン・同時に実行・次の工程の候補・結果ごとの次の工程          | ありません。保存・開始のときに断られます                                                                                                                                                                                                                                                                   |
| 条件分岐（ワークフロー）                            | SaaS 版と同じです（[SaaS 版の設定値リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md)）。ただし判定対象に「質問で判定」はありません                                                                                                                                    |
| 結果の扱い（ルールにより実行できない場合・Agent の報告による失敗のとき） | 画面には、選ぶ設定がありません。決まった扱いで動きます（ルールにより実行できない場合だけ、外部の API で「失敗として閉じる」を設定できます。[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md#%E3%81%86%E3%81%BE%E3%81%8F%E3%81%84%E3%81%8B%E3%81%AA%E3%81%8B%E3%81%A3%E3%81%9F%E3%81%A8%E3%81%8D)） |

## 工程の設定（ワークフロー）

| 項目          | 値                                                                                                           |
| ----------- | ----------------------------------------------------------------------------------------------------------- |
| 設定値         | 契約の設定項目のうち、文字列・整数・数値・はい／いいえ・選択肢の項目を画面で変えられます。保存されるのは値を入れた項目だけで、空欄の項目は Agent の標準値のままです。それ以外の型の項目は管理者が契約で決めます |
| 連携先         | 契約の接続 slot ごとに、このプロジェクトの連携先から 1 つ選びます。選べるのは、管理者が slot に許可した連携先だけです                                          |
| 入力ファイルの受け渡し | 先行する工程の Agent の出力を、この Agent の入力ファイルとしてつなぎます。つながないファイルは、案件の開始で渡します                                           |
| 実行上限        | 契約で決まります。既定は 900 秒。0 は制限しない（配備の上限まで。既定 24 時間）。プロジェクトでは変えられません                                               |

## 環境変数（サイクル）

| 項目     | 値                                                                          |
| ------ | -------------------------------------------------------------------------- |
| 数      | 配置ごとに 32 個まで                                                               |
| 大きさ    | 名前と値の合計 16 KiB まで                                                          |
| 名前     | 英大文字で始め、英大文字・数字・`_` の 64 文字まで                                              |
| 使えない名前 | 予約された名前（`ASTER_`・`MP_` で始まる名前、`PATH` など）、Agent に秘密として登録された名前、管理者が変更を禁止した名前 |

## 確認工程

| 項目                | 値                                            |
| ----------------- | -------------------------------------------- |
| 確認方法              | 「担当者の判断を待つ」または「外部条件待ち」                       |
| 期限を過ぎたら           | **自動では決めません。** 期限を過ぎても確認担当者の判断を待ち、期限超過を通知します |
| 次の工程の候補           | ありません                                        |
| 外部条件              | 「GitLabのMRのマージ」の 1 種類                        |
| 外部条件の観測の間隔        | 300 秒。連携先からの Webhook を受けると、その時点でも読み直します      |
| 外部条件待ちのWebhook秘密鍵 | 16〜255 文字。保存した値は表示されません                      |

## 案件（ワークフロー）

| 項目             | 値                                                                                                                                                                                                                                                                                                               |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 成果物の大きさ        | 1 ファイル 20 MiB まで。1 回の実行で合計 100 MiB・100 ファイルまで                                                                                                                                                                                                                                                                   |
| 画面で編集できる成果物    | テキストで 1 MiB まで。YAML と JSON は、保存のときに構文と契約で決まった形を先に確かめます                                                                                                                                                                                                                                                          |
| 設定と成果物を変えられるとき | 確認待ちのときだけ。実行中と、終わった案件では変えられません                                                                                                                                                                                                                                                                                  |
| 案件の開始          | プロジェクトの参加者（オーナー・運用担当・メンバー）・組織の運用の役割の人                                                                                                                                                                                                                                                                           |
| 案件の中断          | オーナー・運用担当・組織の運用の役割の人と、その案件を始めた本人                                                                                                                                                                                                                                                                                |
| サイクルの実行の停止     | オーナー・運用担当・組織の運用の役割の人                                                                                                                                                                                                                                                                                            |
| 同時に進められる案件     | 3 件まで（実行中と確認待ちの合計）。超えると、手動と外部 API は断られ、時間トリガーと工程の時刻の回は見送られます（[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md#%E5%90%8C%E6%99%82%E3%81%AB%E9%80%B2%E3%82%81%E3%82%89%E3%82%8C%E3%82%8B%E6%95%B0%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC)） |
| 実行の既定の締め切り     | 開始からの時間（時間）。受け付けるのは 1〜2,160 時間。既定は「なし」。過ぎても案件は止まらず、「対応待ち」に並びます                                                                                                                                                                                                                                                  |
| 停滞とみなす時間       | 既定は 24 時間。受け付けるのは 1〜720 時間。最後に工程が終わってから（まだ無ければ開始から）この時間進まない実行中の案件（確認待ち・中断を要求した案件・締め切りを過ぎた案件を除く。締め切りを過ぎた案件は「実行の締め切り超過」に並ぶ）が、「対応待ち」に並びます                                                                                                                                                                          |
| 案件の設定と成果物の編集   | オーナーだけ                                                                                                                                                                                                                                                                                                          |

## 起動

| 項目                | 値                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| メールで起動            | ありません                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 外部 API            | サービスアカウントのトークン（[システム連携 API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/api-reference.md)）と、外部ツールでログインした利用者のトークン（[ユーザー API リファレンス（プロジェクト）](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/user-api-reference-projects.md)）で呼べます。外部 API の実行の開始では、開始のときに設定値・連携先・入力ファイルを渡せます（`config`）。時間トリガーと Webhook トリガーの呼び出しで開始した案件には渡せません（外部 API の `payload` は、依頼として最初の工程の Agent に渡ります） |
| 巡回（サイクル）の重なり      | 同じ配置が実行中のあいだに来た回は見送ります（積み上げません）                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 巡回（サイクル）の遅れ       | 予定から 5 分を過ぎた回は、1 件だけ見送りとして残して次の予定へ進みます                                                                                                                                                                                                                                                                                                                                                                                                                |
| 同じ配置の次の起動まで（サイクル） | 前の実行が終わってから 60 秒。そのあいだの巡回は見送り、Webhook の呼び出しは待ってから起動します                                                                                                                                                                                                                                                                                                                                                                                                |
| Webhook（サイクル）     | 受け付けた呼び出しをまとめず、同じ配置に 1 件ずつ順に渡します。配置ごとに待ちは 20 件まで（超えると `429 queue_full`）。受け付けてから 24 時間を過ぎた呼び出しは起動しません                                                                                                                                                                                                                                                                                                                                                  |

## 実行ルール

| 項目              | 値                                                                                                                                                                                                                                        |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 全体の基本ルール        | 管理コンソールの「実行ルール」で決めます。未設定のときは Open で動きます。新しい版は、**その後に始まる実行から**効き、過去の実行に適用された版は変わりません                                                                                                                                                      |
| 基本ルール           | Open／Guarded／Strict。テナント全体の基本ルールとプロジェクトの基本ルールを合わせて、**厳しいほう**がその実行の基本ルールになります                                                                                                                                                             |
| 基本ルールが効く範囲      | ワークフローだけ。起動の前に、Agent の認定の「使える実行ルール」に入っているかを確かめます。サイクルでは効きません                                                                                                                                                                             |
| プロジェクトで追加する禁止操作 | Agent には渡りません（起動の前に、テナント全体の規則と合わせて、その実行に固定されます）                                                                                                                                                                                          |
| 外への通信           | 環境全体の設定です。管理コンソールの「禁止URL」と NetworkPolicy で絞ります（[実行ルールと通信ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/control-guide.md#%E5%A4%96%E3%81%B8%E3%81%AE%E9%80%9A%E4%BF%A1%E3%82%92%E7%B5%9E%E3%82%8B)） |

## 対応待ち

| 項目     | 値                                                                                                                                                                                                                                                                                                     |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 種類     | 確認待ち・期限超過・外部待ち・失敗・差し戻し待ち・巡回の失敗・締め切り超過（実行）・停滞の 8 つ                                                                                                                                                                                                                                                     |
| 優先度    | P1〜P4。機械的に決まり、手では変えられません（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E5%AF%BE%E5%BF%9C%E5%BE%85%E3%81%A1%E3%81%A7%E4%BA%BA%E3%81%AE%E6%89%8B%E3%81%8C%E8%A6%81%E3%82%8B%E3%82%82%E3%81%AE%E3%82%92%E7%89%87%E4%BB%98%E3%81%91%E3%82%8B)） |
| 一度に並ぶ行 | 100 件まで                                                                                                                                                                                                                                                                                               |
| 一括操作   | 承認・却下・差し戻し・期限の延長・担当の付け替え。**巡回の再実行はありません**。案件の確認依頼の承認・却下・差し戻しは、一括では決められません                                                                                                                                                                                                                             |

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

時刻の選び方は、周期・毎時・毎日・平日・毎週・カスタム (cron) です。周期は、60 分未満は 60 を割り切る分、60 分以上は 24 時間を割り切る時間だけ指定できます。タイムゾーンも指定します。時間トリガー・工程の時刻・巡回の周期は、同じ書き方で決まります。

カスタム (cron) は、5 つの項目（分・時・日・月・曜日）を半角の空白で区切って書きます。選んだタイムゾーンの時刻として扱われます。

| 項目 | 値                      |
| -- | ---------------------- |
| 月  | 1〜12、または JAN〜DEC       |
| 曜日 | 0〜7、または SUN〜SAT（7 は日曜） |

どの項目にも、`*`（すべて）・`?`（`*` と同じ）・数値・`n,m`（列挙）・`n-m`（範囲）・`*/n`（n ごと）・`n/k`（n から始めて k ごと）・`n-m/k`（範囲の中で k ごと）が使えます。範囲の外の値（`70/5` の 70 のような、刻みの起点も含みます）・逆順の範囲・0 以下の刻み・空の要素があると、式全体が無効になります。構文が正しくても、次の実行が 366 日より先になる式（例: 2 月 31 日）は、保存はできますが、次回の時刻が出ず、動きません。
