# 記録ガイド

**動かしたあとに何を見るか**を扱います。結果の読み方、記録のたどり方、そして**実績から見直す進め方**です。

記録の仕組みそのものは[記録と指標](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/records-and-metrics.md)にあります。

**画面上の場所がある節では**、そこで決めたことを**どこで設定・確認するか**を終わりに書いてあります。

## どこを見るか

**見る場所は 5 つあります。**

- **概要** — 上から、「プロジェクトの概要」（目的・工程・Agent の設定から AI が書いた説明か、プロジェクトの説明。どちらも無いときは出ない）、選んだ期間の「この業務の実行結果」（実行結果の文と指標）、工程と Agent の流れの「ワークフローの形」（右の列で、工程ごとの「基本情報」・「数値」〈上と同じ期間の工程ごとの指標〉・「最新の成果物」〈組織の運用の役割だけで開いた人には出ません〉を切り替えます）が並び、サイクルではその下に Agent ごとの直近 24 時間の帯、一番下に「プロジェクト情報」（1 行の要約。「すべて表示」で全部を開きます）があります。帯の Agent を押すと、その Agent に絞った実行履歴に移ります
- **実行履歴** — 実行の一覧。**まだ動いているものも並びます**。「トリガー」の列に、何で始まったか（手動実行・スケジュール実行・外部API実行・メールで起動・巡回・Webhook）が出て、人やアプリが起動したときはその名前も出ます（外部の送信者は「外部（\[EXT]）」付き）。決めたあとの確認依頼の行も並び、エージェントの欄に「確認：（決めた人）」か「自動で決定」が出ます。結果の欄には、Agent の出力の最初の段落と、成果物があればその件数（「成果物3件」など）も添えられます。外部の自動化に送った行には、送ったことと HTTP の状態が、条件分岐の行には、決めたレーン（または何もせずに合流）か、人に確認を立てたことが出ます。ここから 1 件を開きます。ワークフローの工程の実行記録からは「**この実行の履歴を表示**」で、そのワークフローの実行の記録だけに絞って見られます。「**見直す箇所**」（指示・Skill・前の工程からの受け渡し・連携先の接続・実行ルールなど）でも絞り込めます。巡回の再実行で動いた実行には「**再実行**」と付きます
- **ワークフロー履歴** — ワークフローの実行の一覧。**ワークフローだけに出ます**（サイクルは工程をまたぐ実行を持たないため）。**動いているものだけに絞られてはいません**。工程に置いた Agent ごとに丸が 1 つ並び（確認工程や Agent を置いていない工程は、工程ごとに 1 つ）、やり直しても丸は増えず、直近の状態が出ます。まだ来ていない工程は「予定」、失敗や却下で動かなかった工程は「未実行」、中断した実行で止めた工程から後ろは「中断」です（丸にポインターを合わせると「工程名（Agent 名）: 状態」、確認工程や Agent を置いていない工程では「工程名: 状態」で出ます）。進行中の実行に締め切りがあれば「**締め切り: ◯後**」、過ぎていれば「**締め切り超過**」と出ます（過ぎても実行は止まりません。後の[節](#%E7%B7%A0%E3%82%81%E5%88%87%E3%82%8A%E3%81%A8%E5%81%9C%E6%BB%9E%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC)）。却下・失敗で閉じた実行には、オーナー・運用担当と組織の運用の役割の人に「**再開する**」が出ます（管理者がプロジェクトを止めている間は出ません。[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md#%E9%96%89%E3%81%98%E3%81%9F%E5%AE%9F%E8%A1%8C%E3%82%92%E5%86%8D%E9%96%8B%E3%81%99%E3%82%8B)）
- **対応待ち** — 人の手が要るものの一覧。確認待ちの確認依頼、うまく終わらなかった実行、締め切りを過ぎた・進まない実行が、急ぐ順に並びます（次の節）
- **KPI** — 期間を区切った集計。概要の「この業務の実行結果」にあります

**プロジェクトの一覧の「自分のプロジェクト」に並ぶカードにも、直近 7 日の「完遂率（7日）」と、実行中の件数が出ます**（止めているプロジェクトは「停止中」と状態）。完遂率は Agentの完遂率と同じ数え方です。「公開プロジェクト」に並ぶカードには出ません。

**プロジェクトをまたぐ確認依頼は、左の「受信トレイ」の「確認依頼」で見ます**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md)）。「対応待ち」に切り替えると、参加しているプロジェクトの対応待ちのうち、自分が担当の行だけが並びます。

**プロジェクトをまたぐ数字は「全体集計」で見ます。** 参加しているプロジェクトをまとめた数字と、プロジェクト別の一覧が出ます（数え方は下の「数字を読むときの注意」）。

**うまく終わらなかった実行と記録不足、決まらないまま残っている確認依頼、連携先の認証状態について、見る担当と間隔を決めておきます**（通知で届くものは[連携ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/connection-guide.md)）。申請処理のワークフローなら、オーナーが毎朝「対応待ち」を見て、確認依頼に残っているものを担当者に促す、といった分担です。記録不足と連携先の認証状態は「対応待ち」には並ばないので、実行履歴と連携先の画面で見ます。

画面上の場所 プロジェクトを開くと 概要／実行履歴／ワークフロー履歴／対応待ち／ライブラリ／設定 のタブが並びます（ワークフロー履歴 はワークフローのときだけ）。KPI は 概要 の中の「この業務の実行結果」、プロジェクト内の操作の記録は 実行履歴 の中の「記録 (証跡)」にあります。プロジェクトをまたぐ数字は、プロジェクトを開く前の画面の上部の「全体集計」にあります

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

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

| 種類             | 並ぶもの                                                                                         | 担当            |
| -------------- | -------------------------------------------------------------------------------------------- | ------------- |
| **確認待ち**       | まだ決まっていない確認依頼                                                                                | 確認担当者         |
| **期限超過**       | 確認期限を過ぎて、まだ決まっていない確認依頼                                                                       | 確認担当者         |
| **失敗**         | 進行中のワークフローの実行で、今の工程の Agent が失敗し、確認依頼も開いていないもの                                                | オーナー          |
| **差し戻し待ち**     | 差し戻されて、戻り先の工程がまだ動いていないもの                                                                     | 差し戻した確認依頼の担当者 |
| **巡回の失敗**      | サイクルで、配置の最後の巡回が「失敗 (Agent の報告)」「失敗」「ルールにより実行不可」「時間切れ」で終わったもの（再実行を求めると外れます。接続の確認で止めた巡回は並びません） | オーナー          |
| **締め切り超過（実行）** | 締め切りを過ぎても終わっていないワークフローの実行                                                                    | オーナー          |
| **停滞**         | 「停滞とみなす時間」を過ぎても進まないワークフローの実行                                                                 | オーナー          |

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

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

**プロジェクトの「対応待ち」タブには、担当にかかわらず全部の行が並びます。** メンバーと組織の運用の役割の人も、全部の行を見られます。左の「受信トレイ」の「対応待ち」は、自分が担当の行だけです。どちらも上の種類で絞り込めます。一度に並ぶのは 100 件までで、それより多いときは「ほか◯件は表示していません」と出ます。

**行を開くと、それぞれの画面に移ります。** 確認依頼の行は確認依頼の画面、ワークフローの実行の行（失敗・差し戻し待ち・締め切り超過・停滞）はその実行の画面（「案件」）、巡回の失敗は実行記録です。

### まとめて操作する

**行を選ぶと「一括操作」が出ます。** 操作は 6 つで、選んだ行のうち、その操作の対象になる行だけに 1 件ずつ行われます（対象外の行の数は画面に出ます）。

| 操作              | 対象になる行                                                                                                                                                                                                                                                                                                 | できる人                               |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- |
| **承認**          | 確認待ち・期限超過の確認依頼                                                                                                                                                                                                                                                                                         | 確認担当者・期間中の代理人                      |
| **却下**・**差し戻し** | 確認依頼（接続の確認は却下だけ）。理由を 1 回入れると、全件に同じ理由が付きます。差し戻し先は、各確認依頼の既定の戻り先です                                                                                                                                                                                                                                        | 確認担当者・期間中の代理人                      |
| **期限の延長**       | 確認依頼（接続の確認を除く）。新しい期限（今より後の日時）を入れます（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md#%E5%BE%85%E3%81%9F%E3%81%9B%E3%82%8B%E3%81%8B%E6%9C%9F%E9%99%90%E3%81%A7%E9%80%B2%E3%82%81%E3%82%8B%E3%81%8B)）                                                     | 確認担当者・期間中の代理人・オーナー・運用担当・組織の運用の役割の人 |
| **巡回の再実行**      | 巡回の失敗                                                                                                                                                                                                                                                                                                  | オーナー・運用担当・組織の運用の役割の人               |
| **担当の付け替え**     | ワークフローの実行の確認依頼。新しい担当は、そのプロジェクトのメンバーから選びます。複数のプロジェクトの行をまとめては付け替えられません（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md#%E6%B1%BA%E3%82%81%E3%82%89%E3%82%8C%E3%82%8B%E3%81%AE%E3%81%AF%E6%8C%87%E5%AE%9A%E3%81%97%E3%81%9F%E4%BA%BA%E3%81%A0%E3%81%91)） | オーナー・運用担当・組織の運用の役割の人               |

**結果は 1 件ごとに出ます。** 「成功」のほか、「既決」（ほかの人が先に決めた）、「権限なし」、「競合（内容が更新されました）」、「個別に判断してください」、「見つかりません」、「失敗」、「管理者が停止」（管理者がプロジェクトを止めている）、「運用の役割では、この操作はできません」です。**承認・却下・差し戻しは、オーナーでも、確認担当者でも期間中の代理人でもない確認依頼では「権限なし」になります。** 期限の延長は、オーナー・運用担当と組織の運用の役割の人なら、確認担当者でなくても通ります。 次の工程の候補がある確認依頼のように、まとめては決められないものは、まとめて決める対象から外れ、「◯件は…一括では判断できません。確認依頼を開いて判断してください」と出るので、1 件ずつ開いて決めます。

**サイクルの周期の巡回が「失敗」「時間切れ」で終わると、基盤が 1 回だけ自動で取り直します。** 外部へ書き込んだ後に失敗した巡回も取り直します。取り直しは、終わってから間もないうちに、新しい実行として動きます（実行履歴の `attempt` は 2）。終わってから時間がたった巡回は取り直しません。「失敗 (Agent の報告)」「ルールにより実行不可」「失敗 (停止)」、接続の確認で止めた巡回、Webhook やメールで動いた巡回、取り直した巡回は、取り直しません。取り直しでも失敗したときは、「対応待ち」の「巡回の失敗」の行で再実行を決めます。

**巡回の再実行は、配置の今の設定で 1 回動きます。** 元の巡回が Webhook やメールで動いた回なら、そのときの本文を添え直します。**同じ巡回の再実行は 1 回だけです。** 動いた実行には「再実行」と付き、実行記録から元の実行が分かります。記録 (証跡) には「巡回再実行要求」として残ります。

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

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

**ワークフローの実行には、締め切りを付けられます。** 締め切りを過ぎても、**実行は止まりません。** 「対応待ち」の「締め切り超過（実行）」に並び、オーナーに通知が届きます。

- **既定の締め切り** — 設定 タブの「実行の既定の締め切り（開始からの時間）」を選ぶと、そのあとに始まる実行ごとに、開始からその時間の締め切りが付きます。既定は「なし」です
- **実行ごとの締め切り** — オーナー・運用担当と組織の運用の役割の人は、進行中の実行の画面（「対応待ち」の行から開きます）で、締め切りを設定・変更・外せます

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

**通知は、同じ締め切り・同じ停滞につき 1 回です。** 届く先と止め方は[連携ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/connection-guide.md#%E9%80%9A%E7%9F%A5%E3%82%92%E6%AD%A2%E3%82%81%E3%82%8B)にあります。

画面上の場所 既定の締め切りと停滞とみなす時間は 設定 タブ ＞「実行ルール」＞「実行」＞「実行の既定の締め切り（開始からの時間）」「停滞とみなす時間」（ワークフローでオーナーのときだけ変えられます）。実行ごとの締め切りは、「対応待ち」から開く実行の画面の「締め切りを設定」「締め切りを変更」「締め切りを解除する」

## 1 回の実行を読む

**実行履歴で時刻を選ぶと、その 1 回の記録が開きます。** これが**実行記録**です。

**「実行記録」タブの先頭に、その実行を短い文で読み下したものが出ます。** 何で起動したか（巡回の再実行と、接続の確認の承認で起動し直した実行ならそのこと）、連携先の呼び出し、確認依頼、結果、見直す箇所の順です。記録にある事実だけで組み立てた文で、やりとりの本文や成果物の中身は読んでいません。

**その下に「できたもの」が出ます。** その実行の Agent の出力（ワークフローの工程では先頭の 2,000 字まで）と成果物です（どちらも無い実行には出ません）。確認で出力を直して進めた実行では、「確認で修正した文」が先に出て、Agent の出力は「元の出力」の見出しになります。成果物の名前を押すと、記録した時点のバージョン（後の回で上書きされて残っていないときは今のバージョン）でプレビューが開き、ダウンロードもできます。成果物ごとに、次の操作が出ます。

- 「**ライブラリに登録**」 — 成果物を、記録した時点のバージョンでプロジェクトのライブラリに入れます（メンバーもできます。管理者が決める機能の許可で「ファイルの添付」を使える人だけ）。同じ名前のファイルがライブラリにあるときは「**「（ファイル名）」の新しいバージョンとして登録**」になり、そのファイルの新しいバージョンとして入ります。この記録から入れたものには「**登録済み**」と出て、押すとライブラリのそのファイルが開きます。記録した時点のバージョンが残っていない成果物には「**後の回で上書きされています**」と出て、入れられません
- 「**毎回この名前でライブラリに保存**」 — オーナーにだけ出ます。成果物をライブラリに入れ、この実行の工程の配置の「ライブラリと同期するファイル」に、同じ名前で足します。次の回から、Agent がその名前で書いたものがライブラリの新しいバージョンとして残ります。定義の変更に承認が要るテナントでは、承認されるまで残りません（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E6%B8%A1%E3%81%99)）。作業場所の直下のファイルで、まだ同期していないものに出ます。記録した時点のバージョンが残っていない成果物は、今のバージョンで入ります（「登録済み」の印は付きません）

工程に「次の工程に渡す値と資料の役割」を決めていると、「できたもの」の下に、その回に返された値と資料と、返されなかった値・見つからない資料が出ます（1,000 字で切った値には「（1,000字で切り詰め）」と出ます）。ワークフローの実行の工程の行にも出ます。

**「できたもの」の見出しの横の「この結果でチャットする」で、この結果を受けて続けて頼めます。** Agent の出力（ワークフローの工程では 20,000 字まで）を入力欄に入れ、成果物を添えた新しいチャットを開きます（まだ送りません）。出力は、指示ではなくデータとして扱うよう添えた形で入ります。成果物は押した人のライブラリに写ります。会話の全文は渡りません。メンバーもできます。添えられなかった成果物があれば、その件数が出ます。

**うまく終わらなかった実行では、「できたもの」があればその下に「失敗の要点」が出ます**（接続の確認で止めた実行には出ません）。 **原因・影響・次の対応**が並び、記録されている場合は**見直す箇所**も並び、次の対応は**どこを見ればよいか**（連携先の設定／実行ルール／工程の設定と入力／実行したこと）を示します。**まずここを読んでください。**

**「見直す箇所」は、直すところの見当です。** 「指示（プロンプト）」「設定・連携（ハーネス）」「管理者・システムによる制限」「外部サービス」などで出て、Agent の報告にコメントが無いときと、基盤側の失敗のときは、何を見直すかの説明も添えられます。次の対応のボタンは、見直す箇所が絞れていればそれに合わせて、絞れていなければ失敗の分類に合わせて出ます。

**実行記録は 5 つの問いで並んでいます。**

- **依頼** — どの工程の Agent として、何によって起動したか。設定した人（アプリが起動したときは起動したアプリ、メールで起動したワークフローは送った人）、受け付けた時刻、**試行 2 回目以降ならその回数**。Agent に登録した入力ファイルと、前の工程から受け取ったファイルがあれば、「**Agentに登録した入力ファイル**」「**前の工程から受け取ったファイル**」に分けて一覧が出ます。「同時に実行」の工程では「**同時に実行した担当**」として同じ回の Agent ごとの状況が、レーンのあるワークフローの実行では、並列に進むと、その実行のどの記録にも各レーンの今の状況（合流待ち・合流済みなど）が並びます（前の工程の記録でも、出るのは今の状況です）
- **根拠** — 読み取った回数、使ったツールの種類、**外部サービスの呼び出し件数とそのうちの失敗件数**（連携先ごとの件数も出ます）。連携先につながったかは「**連携先の接続: ◯/◯**」で出て、つながらなかった連携先と、理由の分類ごとの件数も別々に並びます
- **実行したこと** — **ツールの呼び出しの件数**と、**どのツールで何をしたか**の一覧、**それぞれがどうなったか**（実行・試行のみ・拒否・効果の確定）。当たった規則が記録されている拒否には、「**当たった規則**」が添えられます。Agent の出力と、作ったファイルは「できたもの」に出ます
- **確認** — 「**Agentからの質問**」と「**確認依頼**」に分かれます。プロジェクトの実行では Agent は途中で人に尋ねないので、Agentからの質問には「この実行で Agent から人への質問・確認はありません」と出ます。確認依頼は、**確認工程の行の実行記録に出ます**。「Agent が実行」の工程の結果から作られた確認依頼は、その Agent の行の記録にも出ます。決まったものには決定と決めた人、まだのものには「確認待ち」が出ます。**接続の確認は、別の欄の「接続の確認」に出ます。** 止めた Agent の行と巡回の実行記録に、連携先の名前・状態（期限切れ・失効など）・Agent が申告した目的が並び、名前を押すと確認依頼が開きます
- **結果** — どう終わったか。**ふつうに完了し、理由やエラーなどの補足が無いときは、この項目は出ません**（結果は見出しの札で分かります）

**「実行したこと」に拒否が並ぶことがあります。** 実行ルールや、製品側で決まっている制限で止められた操作です（[実行ルールガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/control-guide.md)）。

**「実行したこと」の一覧は「操作の詳細」を開くと出ます。** そこには読み取りや外部サービスの呼び出しも並びます。ただし**操作の中身（渡した値や書き込んだ本文）は出ません**。

**実行記録では、「Agentに登録した入力ファイル」「前の工程から受け取ったファイル」「成果物」の名前を押すとプレビューが開き、ダウンロードもできます。** プロジェクトのメンバーのときです。見られるのは最新のバージョンと、そのファイルを初めて成果物として記録した実行が始まったあとに書かれたバージョンです。

**プロジェクトのライブラリのファイルを渡した実行では、「依頼」に「ライブラリから渡したファイル」がバージョンとともに並びます。** Agent がそのファイルを書き換えたときは、「実行したこと」の「**ライブラリへの保存**」に、どうなったか（新しいバージョンを保存・変更なし（バージョンは増えていません）・保存に失敗・登録なし（実行の出力のまま））が出ます。ライブラリの仕組みは[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E6%B8%A1%E3%81%99)にあります。

**「実行情報」タブに「実行時の設定」があります。** 実行時に保存された値（実行時の基本ルール・モデルなど）で、**あとで設定を変えても、この表示は変わりません**。同じ実行について実行基盤に保存された値と照らし合わせ、食い違う項目には「差分あり」と出て、実行記録の上部にも知らせが出ます。値が無い項目は「未記録」です。

**担当 Agent を「プロジェクトから削除する」で削除していなければ、見出しの「現在の設定」で、その Agent の今の設定を見られます**（工程から外しただけなら見られます）。ゴール (指示)・ガードレールと、付けている Playbook・Skill・入力ファイルの名前が、読み取り専用で出ます。実行したときの設定ではなく、今の設定です。「Agent を編集」は、その Agent の持ち主にだけ出ます。

**「確認」の確認依頼に出るのは、決定と決めた人までです。** 中身は、**名前を押して確認依頼を開いて見ます**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md)）。**やりとりの本文もここには出ません。**

**「時系列」タブ**には、「実行の流れ」（開始から終わりまでの出来事と Agent の操作が、時刻の順に並びます）と「実行基盤の記録サマリー」が出ます。**「実行情報」タブ**には、「実行時の設定」「実行基盤の記録」（実行基盤に保存された値をそのまま出し、記録が無い項目は「未記録」）「識別情報」が出ます。

**記録が欠けている実行もあります。** 「結果が記録されていません」と出た場合、**成功にも失敗にも数えられていません**。

**値が得られていない所には、理由が出ます。** 空欄と 0 件と「対象なし」の違いは、[記録と指標の考え方](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/records-and-metrics.md#%E7%A9%BA%E6%AC%840-%E4%BB%B6%E5%AF%BE%E8%B1%A1%E3%81%AA%E3%81%97%E3%81%AF%E5%88%A5%E3%81%AE%E3%82%82%E3%81%AE)にあります。

| 表示                          | 意味                                                        |
| --------------------------- | --------------------------------------------------------- |
| 未記録                         | その項目の記録が残っていません。今の設定で埋めずに、空けたまま出します                       |
| 結果の記録なし                     | 終わった実行の結果が記録されていません。成功にも失敗にも数えません                         |
| 記録不足                        | 結果が欠けた実行があります。KPI はその実行を数えずに出した暫定の値です（「記録が不足しています」「記録不足」） |
| 取得できませんでした                  | 情報を読み込めませんでした。時間をおいて、もう一度開いてください                          |
| 権限がありません                    | その情報を見られる役割がありません                                         |
| データがない、もしくは権限がありません         | 開いた対象が無いか、見る権限がありません（どちらかは分けて出しません）                       |
| 対象なし                        | 記録の欠けではなく結果です。実行が起動しなかったことを表します                           |
| 測定対象外                       | その値は測る対象ではありません                                           |
| 旧形式の記録                      | 前の形で残った記録です。書き込みがあったかなど、分からない項目があります                      |
| 「記録された理由（結果）をこの画面では解釈できません」 | 記録された理由や結果が、この画面の語にありません。結果のときは、成功にも失敗にも数えません             |
| 削除済み (閲覧できません)              | 削除されたので見られません                                             |
| 届いたか不明                      | 送った知らせ（確認依頼のメールなど）が届いたかを確かめられていません                        |
| この情報は現在利用できません              | その情報は、今はまだ画面に出せません                                        |

画面上の場所 実行履歴 タブ ＞ 一覧の時刻 ＞ 実行記録。「実行記録」タブの先頭に読み下し、その下に「できたもの」（「この結果でチャットする」は、その見出しの横）、うまく終わらなかった実行では続いて「失敗の要点」が出て、その下に「依頼」「根拠」「実行したこと」「確認」と、補足があるときは「結果」が並びます。実行の記録は「実行記録」「時系列」「実行情報」の 3 つのタブに分かれます。「実行時の設定」は「実行情報」タブにあります

## 結果の語を取り違えない

**終わり方は 7 つの語で表されます。**

- **完了** — Agent が「完遂できなかった」と報告せず、最後の結果でもそう示さなかった、という意味です
- **失敗 (Agent の報告)** — Agent が自分で完遂できなかったと報告したか、最後の結果でそう示した（実行時間の上限でまとめに入ったあとは「時間切れ」）
- **失敗** — 異常終了した
- **失敗 (停止)** — 人か基盤が実行を止めた
- **時間切れ** — 制限時間に達した（実行時間の上限でまとめに入り、完遂できなかったときを含む）
- **ルールにより実行不可** — **基盤が実行そのものを禁じた**
- **対象なし** — 扱う対象が無く、**実行が起動しなかった**

**「完了」は業務がうまくいったことの保証ではありません。** Agent が「完遂できなかった」と示さなかっただけなので、**何をしたかは「実行したこと」で確かめてください**。ただし**操作の中身は出ない**ので、業務として正しいかは成果物のほうで確かめます。

**「失敗」には 3 種類あります。** 手の打ち方が違うので、**括弧の中まで見てください**。「**失敗 (Agent の報告)**」は「**失敗の要点」に出る「Agent の終了時の報告」を見ます**（権限・入力の不足・連携先の応答・実行ルールによる制限など）。**括弧なしの失敗は異常終了で、添えられた理由を見ます**。「**失敗 (停止)**」は人か基盤が止めたものです。

## 何が起きたかをたどる

**確認の決定や、実行ルール・メンバーの変更などは、記録 (証跡) で追えます。** それぞれが**時刻と実行者**とともに並びます（記録に残る出来事は[記録リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/events-ref.md)）。

**種別で絞り込め、語で検索もできます。** CSV に出すこともできますが、**CSV に反映されるのは種別の絞り込みだけ**で、検索語は反映されません。一覧は新しい順に 50 件ずつ出て、「**さらに読み込む**」で前の分も読めます。CSV が上限で切れたときは、出力した件数と全体の件数が出ます。

**実行者は人だけではありません。** 「Agent」「システム」「外部の送信者（\[EXT]）」も並びます。**期限による自動処理はシステムとして記録されます**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md)）。

画面上の場所 実行履歴 タブ ＞「記録 (証跡)」。同じ場所に「記録を検索」、「種別」の絞り込み、「CSV出力」があります

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

**本文がある実行では、Agent とのやりとりを開けます。** これを開くには**理由の入力が必要**です（300 文字まで）。オーナー・運用担当・メンバーのだれでも開けます。「**記録の本文を開く**」で、本文が別の画面に、読むだけの形で出ます。**本文を持たない実行もあり、その場合は開けません。** 工程の実行と巡回でできる会話は、「\[プロジェクト名] Agent名」という題になります（Webhook で動いたときは先頭に「\[webhook]」、メールで動いた巡回は「\[mail]」が付きます）。**この会話は、その実行のときのプロジェクトの持ち主のチャットの一覧・件数・検索には出ません。** チャットの画面で開くと、本文の代わりに「この会話はプロジェクトの実行記録で閲覧できます」と出て、今そのプロジェクトのメンバーなら「実行記録を表示」で記録へ移れます。結果を受けて続けて頼むときは、「できたもの」の「この結果でチャットする」を使います。

**理由と閲覧者は記録されます。** 実行記録の「**エクスポート**」も同じで、**理由の入力が必要**です。**誰がいつ何のために見たか**が残ります。

**記録 (証跡) の「CSV出力」も、理由の入力が必要です**（300 文字まで）。出力したことは、理由とともに記録 (証跡) に「実行記録のエクスポート」として残ります。出るのは記録 (証跡) の一覧だけで、本文は含みません。

**誰が本文を見たかは、本人が確認できます。** 自分の実行の本文を誰が見たかを、**閲覧の記録**で確かめられます。プロジェクトのオーナー・運用担当・メンバーと、組織の運用の役割の人も、同じ記録を確かめられます。

**本文には業務の内容が含まれます。** 必要なときだけ開いてください。

画面上の場所 実行記録 ＞「記録の本文を開く」／「エクスポート」。閲覧した人の一覧は同じ画面の「閲覧の記録」

## 数字を読むときの注意

**処理結果の指標は、Agent の 1 回の処理を単位に集計します。** 期間は選べます（値は[設定値リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md)）。

**🚨 確認の指標は、数える対象が処理結果とは違います。** さらに**指標によって、期限による自動処理の扱いも違います**。ここを取り違えると、人の負担を読み間違えます。

- **確認回数**（ワークフロー実行1回あたり） — **人が決めたぶんだけ**を数えます
- **人が承認した割合**／**差し戻し率** — **期限で自動に進んだぶんは、どちらにも影響しません**。ただし**自動で差し戻された・却下されたぶんは影響します**
- **差し戻し・却下・中断**／**待ち時間の目安** — **自動処理も含みます**。「**期限内の回答**」は、期限のある確認依頼のうち、担当者が期限までに答えた割合で、期限による自動処理で決まったものは数えません

**指標ごとの数え方は**[実行結果リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/results-ref.md)**にあります。**

**再試行も、Agent の処理 1 回として別に数えます。** 同じ Agent が同じ工程を 2 回動けば 2 件です。

**集計外になるものがあります。** 対象なし・実行中・記録不足は、「**Agentの完遂率**」の計算から外れます。**変化なしで終わった実行**（見に行った対象に変化が無く、何もしなかったと Agent が報告したもの。結果は「完了」）も外れます。こちらは「集計外」の件数にも出ません。**接続の確認で止めた実行**も外れ、「集計外」の「接続の確認で停止」に出ます。**記録が欠けた実行があると、暫定値の扱いになります。** 概要の「この業務の実行結果」では数字の代わりに「記録が不足」と出て、「全体集計」では暫定値であることが添えられます（どちらも、結果が欠けた実行の件数が添えられます）。

**「Agentの完遂率」は業務の成果ではありません。** 結果が「**完了**」になった実行（変化なしで終わったものを除く）の割合です。**報告が無いまま終わったものも、最後の結果で完遂できなかったと示していなければ「完了」に入ります**が、時間切れ・停止・ルールにより実行不可・失敗は入りません。

**「全体集計」の Agentの完遂率・件数・処理時間の目安も、同じ数え方です。** 参加しているプロジェクトの実行を合わせて出します。プロジェクト別の一覧には記録不足の件数も並び、各行から同じ期間の実行履歴へ進めます。**確認の指標は出ません。** 確認の指標は各プロジェクトの KPI で見ます。

画面上の場所 概要 タブ ＞「この業務の実行結果」。同じ場所に「期間」と「CSV出力」があります。プロジェクトをまたぐ数字は、プロジェクトを開く前の画面の上部の「全体集計」（「期間」も同じ場所）

## 実績から見直す

**見直しの手がかりは、実行記録と確認の実績です。** 見えたものから、直す場所を選びます。

| 見えたもの               | 直す場所                                                                                                                                                                                                                                |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 「失敗の要点」の原因          | 原因ごとの最初の確認先は[実行結果リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/results-ref.md)にあります。実行ルールで止められたなら、その操作を止めてよいか、ゴールでその操作を使わずに済むかも見る                                                            |
| 「実行したこと」に拒否が並ぶ      | 同じく実行ルールか、ゴール（[実行ルールガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/control-guide.md)）                                                                                                                |
| 差し戻しが続き、理由に同じ指摘が並ぶ  | Agent のゴールと Skill                                                                                                                                                                                                                   |
| 「完了」なのに、成果物が業務に使えない | ゴールの「どの状態まで仕上げるか」と Skill（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)）                                                                                                         |
| サイクルで、同じ対象を何度も拾う    | 記録先の目印の決まり（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md#%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB%E3%81%A7%E6%AE%B5%E9%9A%8E%E3%82%92%E3%81%A4%E3%81%AA%E3%81%90%E3%81%A8%E3%81%8D)） |

直した内容を試してから反映する進め方は[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md#%E4%B8%8B%E6%9B%B8%E3%81%8D%E3%82%92%E7%A2%BA%E3%81%8B%E3%82%81%E3%81%A6%E5%8F%8D%E6%98%A0%E3%81%99%E3%82%8B)にあります。

**うまくいかなかったワークフローの工程の実行と、サイクルの巡回からは、AI に改善案を相談できます。** 結果が「失敗 (Agent の報告)」で分類が記録されているもの、「ルールにより実行不可」のうちガードレールか実行ルールで禁じられたもの、「時間切れ」のうち実行時間の上限に達したもの、接続の確認を却下したか期限が切れて閉じたもので、「失敗の要点」に「**改善案を相談（α版）**」が出ます。ワークフローの工程では、結果が「完了」でも、その結果を確認で却下されたものと、同じ戻り先への差し戻しが上限の 1 回手前まで来たものも相談できます。AI が読むのは、終了時の報告・実行したことの一覧（80 件まで）・設定と、読める Skill（先頭の 5 件まで）と Playbook の本文です。ほかに、その工程への差し戻しと却下の理由、連携先への接続の結果と、操作がどこで止められたか、サイクルでは同じ配置の前回の巡回の報告、この配置にこれまで実施した改善（日付と種類だけ。新しい順に 5 件）とその後の結果も渡ります。長い本文は一部だけになることがあります。Agent の出力は最初の相談には渡らず、選ぶと次の相談から渡ります（長いときは一部だけ）。

案は「**文面を修正する**」（Agent のゴール・ガードレール、工程の説明）、「**人の工程にする**」（確認工程を足す、配置を外す）、「**Skill・Playbookに追記**」の 3 種類で、足りない入力や連携先は「**入力・連携先を補う**」として示されます。

**相談はメンバーもできますが、「実施」はオーナーだけです。** 実施すると、選んだ変更がその場で保存され、次の実行から使われます。定義の変更に承認が要るテナントでは、承認されるまで前の版で動きます。その実行の結果は変わらず、自動でやり直すこともありません。直す対象の Agent がほかの人のものか、ほかのプロジェクトでも使われているときは、Agent を複製し、このプロジェクトの配置だけを複製に切り替えます。同じ Agent をこのプロジェクトの複数の工程に置いているときは、ゴールやガードレールの変更は、その Agent を置いたすべての工程に及びます。Playbook がほかの人のものなら、Playbook を複製し、Agent がその複製を使うようにします。自分の Playbook は、ほかで使われていても、そのものが直ります。公開している Playbook の直しは、公開の承認が要るテナントでは、公開の申請になります。相談のあとに、案が前提にした設定が変わっていたら、その変更は保存されず、それより後の変更も実施されません（それより前の変更は保存されています）。内容を確かめて相談し直します。

**Skill への追記は、Skill の持ち主によって変わります。**

- **自分の Skill** — 新しいバージョンになります。その Skill を「最新のバージョンに追随」で使っているほかの Agent にも効きます。公開に管理者の承認が要るテナントで公開中の Skill なら、新しいバージョンは申請中になり、承認されるまでこのプロジェクトにも効きません。Agent がバージョンを固定しているときは、新しいバージョンは使われません（使うときは Agent の設定でバージョンを選び直します）
- **ほかの人の Skill** — 自分用に複製して追記し、Agent がその複製を使うように切り替えます。Agent もほかで使われているときは、Agent も複製し、このプロジェクトの配置だけを切り替えます

**スクリプトなどのコードを含む Skill には追記できません。** 自分の Skill で、Agent が使っているバージョンが Skill の今のバージョンと違うときも、反映できません（ライブラリで Skill のバージョンを確かめます）。

### 確認を緩めていく

**この節はワークフローの話です。** サイクルには確認工程がないので、この設定も出ません（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md)）。

**はじめは「担当者の判断を待つ」と「通知して待機する」の組み合わせで運用し、実績を見てから緩めるのが安全です。** 「担当者の判断を待つ」だけでは足りません。**期限を過ぎたあとの設定によって、自動で進む・差し戻す・却下することがあります**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md)）。

**見るのは 2 つです。**

- **人が承認した割合** — 高いほど、人が承認した決定の割合が大きかったことになります
- **差し戻し率** — 低いほど、差し戻しの割合が小さかったことになります

**この 2 つには、自動で処理された差し戻しと却下も影響します。** 期限後の設定が「自動で差し戻す」「自動で却下する」のときは、**この 2 つは人の判断だけを表しません。**

**人が承認した割合が高く、差し戻し率が低いなら、「期限後に自動で進める」に変えられます。** 逆に差し戻しが続いているなら、**緩める前に Agent のゴールを見直してください**（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)）。

**確認方法は工程ごとに、オーナーだけが変えられます。** 変える場所は、設定 タブの**実行ルール**か、編集の確認工程の「**確認の設定**」で、どちらも同じ設定です。KPI の画面は実績を見るためのものです。変えた人と内容は記録されます。**変えた確認方法が使われるのは、そのあとに始まる実行からです。** 進行中の実行は、始まったときの確認方法のまま進みます。

**🚨 確認方法を緩めても、実行ルールで禁止した操作は許可されません。** 確認方法は**仕事の流れ**の設定で、**どの操作を許すか**とは別の軸です（[実行ルールガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/control-guide.md)）。

画面上の場所 実績は 概要 タブ ＞「ワークフローの形」＞「数値」＞ 確認工程の箱。変更は 設定 タブ ＞「実行ルール」＞「工程の確認方法」＞ 各行の変更のボタン（ワークフローでオーナーのときだけ）。「数値」の確認工程の箱の「設定を開く」からも「実行ルール」へ移れます。編集 ＞ 中央の図で確認工程を選び、右の「確認の設定」＞「基本設定」＞「確認方法」からも変えられます

### 効果を確かめる

**KPI の期間は、今日から遡る決まった長さから選びます**（[設定値リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md)）。**変えた日で区切って比べることはできません。** だから、**変える前に KPI の CSV を出して控えておき**、変えたあと同じ長さの期間が過ぎてから、もう一度出して比べます。CSV の中身は[実行結果リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/results-ref.md)にあります。

**Agentの完遂率と合わせて、業務として決めた終わり（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md#%E6%A5%AD%E5%8B%99%E3%81%A8%E3%81%97%E3%81%A6%E6%B1%BA%E3%82%81%E3%82%8B%E3%81%93%E3%81%A8)）に照らして、成果物を確かめます。**

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

ここまでの節をまたいで、区別しておく点をまとめます。

- **「完了」を業務の成功だと思う。** **Agent が完遂できなかったと報告せず、最後の結果でもそう示さなかった、という意味**です。何をしたかは「実行したこと」で確かめます
- **外部サービスの呼び出し件数を「実行したこと」で探す。** **外部サービスの呼び出しと失敗の件数は「根拠」にあります。** 「実行したこと」の件数はツールの呼び出し全体の件数で、**一覧のほうには読み取りや外部サービスの呼び出しも並びます**
- **実行記録で操作の中身まで追えると思う。** **出るのは何をしたかだけで、渡した値や書き込んだ本文は出ません**
- **確認の数字をひとまとめに読む。** **指標によって数える対象も、期限による自動処理の扱いも違います。** 「人が承認した割合」は期限で自動に進んだぶんに影響されませんが、**自動で差し戻された・却下されたぶんには影響されます**
- **確認を緩めれば操作も緩むと思う。** **確認方法と実行ルールは別の軸です。** 禁止した操作は、確認方法を変えても許可されません
- **本文を気軽に開く。** **理由の入力が必要で、誰がいつ何のために見たかが残ります**
- **サイクルで「ワークフロー履歴」を探す。** **サイクルには出ません。** 動いているものは概要と実行履歴で見ます
- **記録が無い実行を失敗だと思う。** **成功にも失敗にも数えられていません。** 集計では「記録不足」として外れます
- **「接続の確認のため停止」を失敗だと思う。** **人の確認を待っているだけで、失敗には数えません。** 「対応待ち」の失敗にも並ばず、確認依頼として届きます（[連携ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/connection-guide.md#%E4%BD%BF%E3%81%86%E5%89%8D%E3%81%AB%E4%BA%BA%E3%81%AB%E7%A2%BA%E3%81%8B%E3%82%81%E3%81%95%E3%81%9B%E3%82%8B%E6%8E%A5%E7%B6%9A%E3%81%AE%E7%A2%BA%E8%AA%8D)）
- **締め切りを過ぎたら実行が止まると思う。** **止まりません。** 「対応待ち」に並び、オーナーに知らせるだけです。止めたいときは、その実行を中断します
- **「対応待ち」でまとめて承認すれば、オーナーなら全部決められると思う。** **決められるのは、確認担当者に指名された確認依頼と、期間中の代理人として任された確認依頼だけです。** ほかの行は「権限なし」で返ります

## 次に読むもの

- [記録と指標](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/records-and-metrics.md) — 記録の仕組みと、指標の考え方
- [確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md) — 確認方法をどう決めるか
- [実行ルールガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/control-guide.md) — どの操作まで許すか
- [設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md) — 見直すときに直す場所（ゴール・Skill・下書き）
- [設定値リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md) — KPI と全体集計の期間、記録 (証跡) の CSV出力の件数、締め切りと停滞の時間、「対応待ち」の件数
