# 記録ガイド

実行記録と指標の読み方は SaaS 版と同じです（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/record-guide.md)・[記録と指標](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/records-and-metrics.md)）。このページは、マーケットプレイス版で違う点をまとめます。

## どこを見るか

**見る場所は 4 つあります**（ワークフロー履歴はワークフローだけです）。

- **概要** — いまの状態と、期間を選んだ指標です。数え方は後の「[指標の数え方](#%E6%8C%87%E6%A8%99%E3%81%AE%E6%95%B0%E3%81%88%E6%96%B9)」にあります
- **実行履歴** — 実行の一覧です。「起動」の列に、何で始まったか（巡回など）が出ます。結果の絞り込みに「**実行終了 (完遂は未計測)**」があります。ここから 1 件を開くと、実行記録が開きます
- **ワークフロー履歴** — 案件の一覧です。行の「**案件の詳細**」から案件の画面（進行・設定・ファイル・記録）へ進みます（[案件ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md#%E6%A1%88%E4%BB%B6%E3%81%AE%E7%94%BB%E9%9D%A2)）
- **対応待ち** — 人の手が要るものの一覧です（次の節）

**プロジェクトをまたぐ確認依頼は、左の「受信トレイ」＞「確認依頼」で見ます**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md)）。

**うまく終わらなかった実行と、決まらないまま残っている確認依頼について、見る担当と間隔を決めておきます。** たとえば、オーナーが毎朝「対応待ち」を見て、残っている確認依頼を確認担当者に促す、といった分担です。

## 対応待ちで人の手が要るものを片付ける

**「対応待ち」には、人の手が要るものが 1 件 1 行で並びます。** 設定は要りません。確認依頼・実行・巡回の記録から、毎回その時点の状態で作られます。種類は 8 つです。

| 種類             | 並ぶもの                                                                                                                                                                                                                                                             | 担当            |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| **確認待ち**       | まだ決まっていない確認依頼                                                                                                                                                                                                                                                    | 確認担当者         |
| **期限超過**       | 確認期限を過ぎて、まだ決まっていない確認依頼。**期限を過ぎても自動では決まりません**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md#%E6%9C%9F%E9%99%90%E3%81%A7%E3%81%AF%E6%B1%BA%E3%81%BE%E3%82%89%E3%81%AA%E3%81%84)）                         | 確認担当者         |
| **外部待ち**       | 外部条件待ちの確認で、確認期限の前に、連携先の状態を読めずにいるもの。理由は案件の画面に出ます。確認期限を過ぎると「期限超過」に並びます（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md#%E7%A2%BA%E3%81%8B%E3%82%81%E3%82%89%E3%82%8C%E3%81%AA%E3%81%84%E3%81%A8%E3%81%8D)） | 確認担当者         |
| **失敗**         | 進行中の案件で、今の工程の Agent が失敗し、確認依頼も開いていないもの                                                                                                                                                                                                                           | オーナー          |
| **差し戻し待ち**     | 差し戻されて、戻り先の工程がまだ動いていないもの                                                                                                                                                                                                                                         | 差し戻した確認依頼の担当者 |
| **巡回の失敗**      | サイクルで、配置の最後の巡回が失敗の結果（「失敗 (Agent の報告)」「失敗」「ルールにより実行不可」「時間切れ」）で終わったもの                                                                                                                                                                                              | オーナー          |
| **締め切り超過（実行）** | 締め切りを過ぎても終わっていない案件                                                                                                                                                                                                                                               | オーナー          |
| **停滞**         | 実行中の案件が、「停滞とみなす時間」を過ぎても進まないもの（確認待ちと、中断を要求した案件は含みません）                                                                                                                                                                                                             | オーナー          |

**並びは優先度（P1〜P4）の順です。** 優先度は機械的に決まり、手で変えることはできません。同じ優先度の中では、期限の近いもの、古いものが先です。

- **P1** — 期限超過、外部待ち、締め切り超過（実行）
- **P2** — 失敗、巡回の失敗、停滞、確認期限まで 24 時間を切った確認待ち
- **P3** — それ以外の確認待ち、差し戻し待ち
- **P4** — 期限の無い確認待ち

**一度に並ぶのは 100 件までです。** 上の種類で絞り込めます。

### まとめて操作する

**行を選ぶと「一括操作」が出ます。** 操作は次のとおりです。選んだ行のうち、その操作の対象になる行に行われます（対象外の行の数は画面に出ます。担当の付け替えだけは、下の表のとおり案件ごとに行われます）。マーケットプレイス版では、次のとおりです。

| 操作                     | マーケットプレイス版での扱い                                                                                 |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| **承認**・**却下**・**差し戻し** | 案件の確認依頼は、確認依頼を開いて、確認した版を踏まえて 1 件ずつ決めます。承認は、確認待ちと期限超過の確認依頼が対象で、外部待ちの行は人が進められません                 |
| **期限の延長**              | 確認依頼が対象です。新しい期限（今より後の日時）を入れます                                                                  |
| **担当の付け替え**            | 案件の確認依頼が対象です。**付け替えは案件ごとに行われ、その案件の未決の確認依頼は、選んでいない行も含めてすべて置き換わります。** 新しい担当は、そのプロジェクトのメンバーから選びます |

**組織の運用の役割だけで開いた人が使えるのは、期限の延長と担当の付け替えです。**

**結果は 1 件ごとに出ます。** 「成功」のほか、「既決」（ほかの人が先に決めた）、「権限なし」、「競合（内容が更新されました）」、「個別に判断してください」、「見つかりません」、「失敗」などです。「個別に判断してください」と出た行は、確認依頼を開いて 1 件ずつ決めます。

画面上の場所 プロジェクトの「対応待ち」タブ。まとめての操作は、行を選ぶと出る「一括操作」

### 締め切りと停滞（ワークフロー）

**案件には、締め切りを付けられます。** 締め切りを過ぎても、**案件は止まりません。** 「対応待ち」の「締め切り超過（実行）」に並びます。

- **既定の締め切り** — 設定 ＞「実行ルール」の「実行の既定の締め切り（開始からの時間）」を選ぶと、そのあとに始まる案件ごとに、開始からその時間の締め切りが付きます。既定は「なし」です
- **案件ごとの締め切り** — 案件の画面で設定・変更・解除します（[案件ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md#%E7%B7%A0%E3%82%81%E5%88%87%E3%82%8A%E3%81%A8%E7%A2%BA%E8%AA%8D%E3%81%AE%E6%8B%85%E5%BD%93)）

**実行中の案件が進まないときは、「停滞」として「対応待ち」に並びます**（確認待ちと、中断を要求した案件は含みません。締め切りを過ぎた案件は、「締め切り超過（実行）」のほうに並びます）。 「停滞とみなす時間」は、最後に工程が終わってから（まだ 1 つも終わっていなければ始まってから）の時間です。既定は 24 時間です。

画面上の場所 設定 ＞「実行ルール」の「実行の既定の締め切り（開始からの時間）」「停滞とみなす時間」（ワークフローでオーナーのときだけ変えられます）

## 1 回の実行を読む

実行記録には、SaaS 版の項目に加えて「**実行環境のイメージ**」が出ます（「実行情報」の「実行時の設定」）。その実行で動いた登録 Agent のコンテナのイメージです。ワークフローでは管理者が認定した image digest（`sha256:…`）が、サイクルではレジストリ・イメージ名・タグが出ます。

ワークフローの実行記録やワークフロー履歴からは、「**案件の詳細**」で案件の画面を開けます。設定と成果物のバージョンは、案件の画面で見ます（[案件ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md)）。

**見出しの「現在の設定」で出るものは、SaaS 版と違います。** 契約が登録されていて読み取れる登録 Agent では、契約の要約（「外部への効果」と実行上限・「ファイル」・「出力」・「連携先」）が出ます。契約が無い、または読み取れない Agent（サイクルにだけ置く会話の Agent など）では、「この情報は現在利用できません」と出ます。どちらも「Agent を編集」は出ません。

## 本文を見るときは理由が残る

**工程の実行の本文（その実行の依頼と応答）は、理由を入れて開きます。** 開くには、実行記録の画面で理由（300 字まで）を入力します。理由を入れて開いたメンバーだけが、本文を読めます（理由の有効時間は 30 分で、過ぎると、もう一度理由を入力します）。開いた人と理由は記録に残ります。**組織の運用の役割だけで開いた人は、本文を開けません。**

## 起動できなかったとき

登録 Agent が起動できなかったときは、実行記録に理由が出ます。よく出る理由と直すところです。

| 理由                        | 直すところ                                                                                                                                                 |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent がこのプロジェクトの実行ルールに未対応 | プロジェクトの基本ルールと、Agent の「使える実行ルール」を見比べる（[実行ルールと通信ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/control-guide.md)） |
| Agent の認定情報が不足            | 管理者が、Agent の認定を登録し直す                                                                                                                                  |
| Agent の契約が不正              | 管理者が、Agent の契約を直す                                                                                                                                     |
| 工程で選択した連携先が使用不可           | オーナーが、工程の設定で選んだ連携先と、設定の連携先を確かめる                                                                                                                       |
| 連携先の承認済みのバージョンが変更または不明    | 連携先の設定が変わった。オーナーが工程の設定の連携先を選び直す                                                                                                                       |
| 連携先の資格情報が無いか無効            | 連携先を接続し直す                                                                                                                                             |
| 実行する Agent のイメージの特定に失敗    | 管理者が、Agent のイメージの設定（レジストリ・イメージ名）を確かめる（主にサイクル）                                                                                                         |
| 管理者が設定した環境変数と重複           | 管理者が、Agent の環境変数から基盤が決める名前を外す（サイクル）                                                                                                                   |
| 工程の環境変数に使用できない名前を指定       | オーナーが、その工程の環境変数から使えない名前を削除する（サイクル）                                                                                                                    |

## サイクルの結果「実行終了 (完遂は未計測)」

サイクルの登録 Agent は、処理を終えて正常に終了しても、**仕事を果たしたかどうかを基盤は判断できません。** そのような実行の結果は「**実行終了 (完遂は未計測)**」になります。

- **成功にも失敗にも数えません。** Agent の完遂率などの指標の母数に入りません。概要の指標には「完遂は未計測」の件数が別に出ます
- 実行履歴の結果の絞り込みに「**実行終了 (完遂は未計測)**」があります
- 実行が何をしたかは、その実行の会話で確かめます
- 結果の通知（[連携ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/connection-guide.md)）は届きません。結果の通知が届くのは、Agent が完遂を報告した実行だけです

Agent が完遂したかを報告する作りになっていれば（SDK の `report_completion`）、SaaS 版と同じ 7 つの結果で記録されます。作り方は[はじめてのエージェント](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/develop/quickstart/quickstart-sdk.md#report-completion)にあります。

Agent のプロセスが異常に終わったとき、Pod が消えたとき、実行上限を過ぎたときは、Agent の報告があっても使わず、失敗・時間切れとして記録します。

## サイクルの実行を止める

動いているサイクルの実行は、その実行記録の「**停止する**」で止められます。**オーナー・運用担当と組織の運用の役割の人**に出ます。起動を待っている実行と、動いている実行に使えます。

**会話の画面の停止では、サイクルの実行は止まりません。** 実行記録の「停止する」を使ってください。

## 指標の数え方

指標の数え方は SaaS 版と同じです（[実行結果リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/results-ref.md)）。母数になるのは、ワークフローでは工程に置いた登録 Agent の実行（確認工程や通過した工程は除く）、サイクルでは登録 Agent の実行（周期の巡回と、Webhook での起動の両方）です。「実行終了 (完遂は未計測)」は母数に入りません。

## 記録 (証跡)

記録 (証跡) には、SaaS 版の出来事に加えて「**案件設定の変更**」が残ります。案件の設定を新しいバージョンにしたときの記録です。改善案の相談・メール・並列のレーンの合流に関する出来事は、マーケットプレイス版にはありません。条件分岐の「条件分岐の判定」「条件分岐で人に確認」は、SaaS 版と同じに残ります。

## 実績から見直す

SaaS 版の記録ガイドの「実績から見直す」のうち、**AI に改善案を相談して実施する機能はありません。** 見直すときは、実行記録と確認の実績を読み、次のように直す場所を選びます。

| 見えたもの           | 直すところ                                                                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 工程の設定の値が合っていない  | オーナーが工程の設定を直す                                                                                                                                                |
| 確認で毎回同じ直しをしている  | 管理者に契約の標準値を、開発者に Agent の作りを相談する                                                                                                                              |
| 失敗・時間切れが続く      | 開発者に Agent の作りと実行上限を、環境を運用する人に通信の許可を確かめてもらう（[実行ルールと通信ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/control-guide.md)） |
| 「ルールにより実行不可」が続く | プロジェクトの基本ルールと、Agent の「使える実行ルール」を見比べる                                                                                                                         |

## 取り違えやすいところ

- **結果が「完了」なら、業務がうまくいったと思う。** 「完了」は、Agent が完遂として終えたという意味にとどまります。成果物の中身で確かめます
- **サイクルの「実行終了 (完遂は未計測)」を失敗と読む。** 成功にも失敗にも数えません。何をしたかは、その実行の会話で確かめます
- **会話の画面の停止で、サイクルの実行が止まると思う。** 実行記録の「停止する」を使います
- **対応待ちの承認・却下・差し戻しを、まとめてできると思う。** 案件の確認依頼は、1 件ずつ決めます
- **期限超過の確認が、自動で決まると思う。** 決まりません。期限超過として「対応待ち」に並び、確認担当者の判断を待ちます

## 次に読むもの

- [確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md) — 確認依頼の決め方
- [案件ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md) — 案件の画面と、設定・成果物のバージョン
- [実行結果リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/results-ref.md) — 結果の語と、Agentの完遂率の式
