マーケットプレイス版のプロジェクトで決まっている値の一覧です。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 日)は、保存はできますが、次回の時刻が出ず、動きません。