メインコンテンツまでスキップ

設定値リファレンス

マーケットプレイス版のプロジェクトで決まっている値の一覧です。SaaS 版と同じ値は載せていません。 載っていない項目は、SaaS 版の設定値リファレンスを参照してください。項目の名前は画面の表示に合わせています。

プロジェクト​

項目値
型の既定ワークフロー(SaaS 版はサイクル)
作成方法作成の画面では「自分で作る」「社内のひな形から作る」「ファイルから取り込む」。AI に相談して作る・誘導で作る・既存のプロジェクトから作るは、作成の画面にはありません(今あるプロジェクトは、「複製する」「自分のプロジェクトにコピー」で写せます)
プロジェクトの数1 つの環境で 5 件まで(消したもの・アーカイブしたものは数えません)。6 件目になる作成とアーカイブからの戻しは断られます
工程ごとの再試行回数 (失敗・時間切れ)画面では 0〜10 回を選べますが、登録 Agent の工程で効くのは最大 2 回です。自動で再試行するのは、契約の「外部への効果」が「読み取りのみ」か「書き込み (再送しても同じ結果)」で、何が起きたかが分かっている失敗のときだけです。回数を使い切ると案件は失敗で閉じます(起動ガイド)

工程​

項目値
工程に置ける Agent(ワークフロー)管理コンソールでワークフローの契約を登録し、認定済みの登録 Agent だけ
工程に置ける Agent(サイクル)管理コンソールで有効にした登録 Agent(会話で使う Agent)。契約・認定は要りません
並列のレーン・同時に実行・次の工程の候補・結果ごとの次の工程ありません。保存・開始のときに断られます
条件分岐(ワークフロー)SaaS 版と同じです(SaaS 版の設定値リファレンス)。ただし判定対象に「質問で判定」はありません
結果の扱い(ルールにより実行できない場合・Agent の報告による失敗のとき)画面には、選ぶ設定がありません。決まった扱いで動きます(ルールにより実行できない場合だけ、外部の API で「失敗として閉じる」を設定できます。起動ガイド)

工程の設定(ワークフロー)​

項目値
設定値契約の設定項目のうち、文字列・整数・数値・はい/いいえ・選択肢の項目を画面で変えられます。保存されるのは値を入れた項目だけで、空欄の項目は 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 は断られ、時間トリガーと工程の時刻の回は見送られます(起動ガイド)
実行の既定の締め切り開始からの時間(時間)。受け付けるのは 1〜2,160 時間。既定は「なし」。過ぎても案件は止まらず、「対応待ち」に並びます
停滞とみなす時間既定は 24 時間。受け付けるのは 1〜720 時間。最後に工程が終わってから(まだ無ければ開始から)この時間進まない実行中の案件(確認待ち・中断を要求した案件・締め切りを過ぎた案件を除く。締め切りを過ぎた案件は「実行の締め切り超過」に並ぶ)が、「対応待ち」に並びます
案件の設定と成果物の編集オーナーだけ

起動​

項目値
メールで起動ありません
外部 APIサービスアカウントのトークン(システム連携 API リファレンス)と、外部ツールでログインした利用者のトークン(ユーザー API リファレンス(プロジェクト))で呼べます。外部 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 で絞ります(実行ルールと通信ガイド)

対応待ち​

項目値
種類確認待ち・期限超過・外部待ち・失敗・差し戻し待ち・巡回の失敗・締め切り超過(実行)・停滞の 8 つ
優先度P1〜P4。機械的に決まり、手では変えられません(記録ガイド)
一度に並ぶ行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 日)は、保存はできますが、次回の時刻が出ず、動きません。