# 用語リファレンス

マーケットプレイス版のプロジェクトにだけ出てくる言葉の一覧です。SaaS 版と共通の言葉は、SaaS 版の[用語リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/glossary.md)を参照してください。

## 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           |
