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

用語リファレンス

マーケットプレイス版のプロジェクトにだけ出てくる言葉の一覧です。SaaS 版と共通の言葉は、SaaS 版の用語リファレンスを参照してください。

Agent と契約​

画面の言葉意味記録・設定での名前
登録 Agent管理者が管理コンソールの「マーケットプレイスのAIエージェント」で登録した、コンテナのイメージの Agentruntime_kind: marketplace
ワークフローで使う登録 Agent をワークフローの工程に置けるようにする管理コンソールの設定。オンにして契約を登録するworkflow_contract
契約登録 Agent が受け取る設定値・ファイル・成果物・接続先と、外部への効果・実行上限の取り決めworkflow_contract
認定済み / 利用不可 (未認定)契約の認定の情報がそろっているか。認定済みでないとワークフローに置けないcertification
使える実行ルールAgent が対応している基本ルール(Open/Guarded/Strict)。認定の情報の 1 つsupported_policies
外部への効果読み取りのみ/書き込み (再送しても同じ結果)/書き込み (再送で重複しうる)。管理コンソールでは「実行の効果」effect_mode(read_only/idempotent_write/non_idempotent_write)
実行上限1 回の実行の制限時間。管理コンソールでは「実行時間の上限(秒)」limits.execution_timeout_seconds
接続 slot契約で決める、接続先の枠。プロジェクトで連携先を割り当てるconnection_slots

工程と配置​

画面の言葉意味記録・設定での名前
工程の設定ワークフローの配置ごとの設定値・連携先・入力ファイルの受け渡し
設定値契約の設定項目の値。値を入れた項目だけが保存され、空欄は Agent の標準値のまま
入力ファイルの受け渡し先行する工程の出力を、この Agent の入力ファイルにつなぐこと
環境変数(サイクル)サイクルの配置ごとに渡す環境変数
利用者に上書きさせない環境変数(NG)管理者が登録 Agent ごとに決める、配置で変えられない名前placement_env.denied_names

案件​

画面の言葉意味記録・設定での名前
案件登録 Agent を置いたワークフローの実行 1 件project_runs
案件を開始画面から案件を始める操作。SaaS 版の「今すぐ実行」にあたる
指示ファイル案件を始めるときに入れる、編集できるテキストのファイル
案件の設定・設定のバージョン案件ごとの設定値・連携先・ファイルと、そのバージョン
成果物とファイルAgent の出力と、人が編集したバージョン
次の工程に渡すバージョン成果物のうち、次の工程の入力にするバージョン
案件の中断案件を止める操作。SaaS 版の実行の中断にあたる
起動待ち/起動中/起動済み/起動失敗/取消済み工程の Agent の起動の状態pending/leased/dispatched/failed/cancelled

確認​

画面の言葉意味記録・設定での名前
外部条件待ち外部サービスの状態で次の工程へ進める確認方法wait_source: external
外部条件何が成立したら進むか。今は「GitLabのMRのマージ」だけgitlab.mr_merged
観測に使用する連携先外部条件を確かめるために読む連携先
対象を示す出力外部条件の対象(MR)を示す、前の工程の JSON の出力gitlab_project_id・mr_iid・expected_head_sha
外部条件の成立で進行外部条件が成立して、基盤が進めた決定decided_by: system
外部条件待ちの Webhook 秘密鍵GitLab の Webhook を受け付けるための秘密鍵connect_secret
確認内容のバージョン確認担当者が判断する、案件の設定と成果物のバージョン

記録​

画面の言葉意味記録・設定での名前
実行終了 (完遂は未計測)・未計測サイクルの Agent が正常に終わったが、完遂したかを報告しなかった実行runner_exited
実行環境のイメージその実行で動いたコンテナのイメージ
案件設定の変更案件の設定を新しいバージョンにした記録
サービスアカウント外部 API を呼ぶための、管理コンソールで作るクライアント

対応待ち​

画面の言葉意味記録・設定での名前
対応待ち人の手が要るものの一覧。8 種類を優先度(P1〜P4)の順に並べる
外部待ち外部条件待ちの確認で、確認期限の前に、連携先の状態を読めずにいる対応待ちの種類(期限を過ぎると「期限超過」になる)external_wait_blocked
締め切り超過(実行)締め切りを過ぎても終わっていない案件の対応待ちの種類run_deadline_overdue
停滞実行中の案件が「停滞とみなす時間」を過ぎても進まないときの、対応待ちの種類(締め切りを過ぎた案件は、「実行の締め切り超過」に並ぶ)run_stalled
確認の種類確認工程の種類。「確認」(Agent の結果を人が判断する)か「手作業」(人が作業してから進める)review/manual
確認依頼の代理人不在の間の確認の決定を、同じ組織の 1 人に任せる個人の設定

同じものの別の言い方​

左の列は、このドキュメントで使っている言葉です。画面でも基本は同じ言葉で表示されますが、場所によっては別の言葉で表示されます。

言葉画面での別の表示
決めた時刻に案件が始まったことスケジュール実行
サイクルの巡回の実行定期実行
確認依頼を進める決定承認 (次の工程へ)・承認 (案件を完了)。外部条件で進んだものは「外部条件の成立で進行」
結果の「完了」正常完了(KPI)
案件(ワークフローの実行)画面の説明文などでは「案件」

似ているが別のもの​

言葉取り違えやすい言葉違い
実行案件実行は登録 Agent の 1 回の処理で、実行履歴に並び、開くと実行記録になる。案件は、ワークフローの実行 1 件で、ワークフロー履歴に並ぶ
実行記録記録 (証跡)実行記録は、実行 1 件の詳細。記録 (証跡) は、プロジェクトの中の決まった操作や出来事の一覧
実行の結果(完了・失敗・時間切れ など)案件の状態(実行中・確認待ち・完了・失敗・却下・中断)別の欄に出る。数える単位が違う
確認依頼確認待ち確認依頼は、確認担当者に届く依頼そのもの。確認待ちは、決まっていない状態のこと
確認承認確認は内容を見て決めること全般。「承認」は、担当者が進めた決定を表す画面の語。外部条件で進んだものは「外部条件の成立で進行」と出て、承認ではない
基本ルール全体の基本ルール基本ルールはプロジェクトで選ぶもの。全体の基本ルールはテナント全体で決めたもので、より厳しいほうが実行の基本ルールになる
確認工程Agent が実行工程の種類。確認工程では Agent は動かず、確認担当者が決める。「Agent が実行」の工程には登録 Agent を置く
スケジュール実行定期実行どちらも決めた時刻で始まったこと。スケジュール実行はワークフロー、定期実行はサイクルの巡回の実行記録に出る
「再開」(プロジェクトの画面の上部)閉じた案件の再開上部の「再開」は、一時停止したプロジェクトを動かし直す。閉じた案件をやり直すときは、新しい案件を開始する
確認期限(確認依頼)締め切り(案件)確認期限は確認依頼ごとに付く。過ぎても自動では決まらない。締め切りは案件ごとに付き、過ぎても案件は止まらず、「対応待ち」と通知に出るだけ
確認待ち(対応待ちの種類)確認待ち(案件の状態)「対応待ち」の「確認待ち」は、まだ決まっていない確認依頼の行。案件の「確認待ち」は、確認の決定を待っている案件の状態
工程登録 Agent工程は登録 Agent を置く場所で、プロジェクトの流れの単位。登録 Agent は、管理者が登録したコンテナの Agent