用語リファレンス
マーケットプレイス版のプロジェクトにだけ出てくる言葉の一覧です。SaaS 版と共通の言葉は、SaaS 版の用語リファレンスを参照してください。
Agent と契約
| 画面の言葉 | 意味 | 記録・設定での名前 |
|---|---|---|
| 登録 Agent | 管理者が管理コンソールの「マーケットプレイスのAIエージェント」で登録した、コンテナのイメージの Agent | runtime_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 |