# 記録と指標

記録は成績表だと思うかもしれません。**そうではありません。** 記録は、1 回の実行を追うための材料です。それが業務としてうまくいったかどうかは、記録だけでは分かりません。

このページでは、実行記録をどう読むのかと、数字が何を表していないのかを説明します。見方の手順は[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md)にあります。

## 実行記録は、1 回の実行を追うための材料

実行記録の画面は、「**依頼**」「**根拠**」「**実行したこと**」「**確認**」「**結果**」の 5 つの見出しで、1 回の実行を起点から終わりまで追えます。依頼には、何がきっかけで始まったか（巡回・Webhook・外部 API・手動など）が出ます。

実行記録は、1 回の実行の詳細です。どの登録 Agent が、どの設定で動いたかを追えます。実行記録には「**実行環境のイメージ**」が出ます。その実行で動いた登録 Agent のコンテナのイメージです。ワークフローでは、管理者が認定した image digest が出ます。

実行中の実行記録の「依頼」の欄には、経過時間と**操作の件数**（「操作 N 件」）が出ます。連携先の件数の内訳は出ません。

ワークフローの実行は、案件の画面からもたどれます。設定と成果物のバージョンは、案件の画面で見ます（[案件ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md)）。

## 結果は実行の終わり方を表す

結果の欄が示すのは、**その実行がどう終わったか**です。業務目標が達成されたかどうかではありません。

「**完了**」は、Agent が完遂として終えた（「完遂できなかった」という宣言も、実行ルールによる拒否・実行上限の超過・異常終了も無かった）という意味です。**成果物が意図どおりかは、中身を見て確かめてください。**

## 「実行終了 (完遂は未計測)」は成功でも失敗でもない

サイクルの登録 Agent は、処理を終えて正常に終了しても、**仕事を果たしたかどうかを基盤は判断できません。** そのような実行の結果は「**実行終了 (完遂は未計測)**」になります。成功にも失敗にも数えず、完遂率などの指標の母数に入りません。Agent が完遂したかを報告する作りになっていれば、通常の結果で記録されます（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB%E3%81%AE%E7%B5%90%E6%9E%9C%E5%AE%9F%E8%A1%8C%E7%B5%82%E4%BA%86-%E5%AE%8C%E9%81%82%E3%81%AF%E6%9C%AA%E8%A8%88%E6%B8%AC)）。

## 指標は実行記録を集計したもの

指標は、記録を数え上げたものです。だから**記録を読むときの注意が、そのまま数字にも表れます**。母数になるのは、ワークフローでは工程に置いた登録 Agent の実行（確認工程や通過した工程は除く）、サイクルでは登録 Agent の実行（周期の巡回と、Webhook での起動の両方）です。「実行終了 (完遂は未計測)」は母数に入りません。

**完遂率が高くても、業務がうまくいったとは言えません。** 「完了」が、Agent が完遂として終えたという意味にとどまるからです。

## 業務の成果は、記録と成果物で判断する

ここまでの話は 1 つに集まります。**実行記録は成績表ではありません。** うまくいったかどうかを知りたいなら、数字を見るだけでは足りません。実行記録と、実際の成果物を合わせて判断してください。記録が答えるのは「何が起きたか」までで、「それでよかったか」を決めるのは利用者です。

## 次に読むもの

- [記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md) — 実行履歴の見方、対応待ち、起動できなかった理由
- [人の確認](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/human-review.md) — 確認の数字のもとになる仕組み
