# 確認ガイド

業務の途中に人の判断を挟むための設定を扱います。**どこに確認を置き、誰に決めさせ、期限をどうするか**を決めるための選択肢と基準です。

確認工程そのものの考え方は[人の確認](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/human-review.md)にあります。工程をどう分けるかは[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)で扱います。

**画面上の場所がある節では**、そこで決めたことを**どこで設定・確認するか**を終わりに書いてあります。工程の設定は、プロジェクトの画面の上部にある **編集** から開く画面で行います（オーナーだけに出ます）。

## 確認工程で決まるのは「進めるかどうか」

確認工程は、**業務を次に進めてよいかを人が決める工程**です。**確認工程に着くと、その実行はいったん止まります。** そのあとは、担当者の決定か、**期限を過ぎたときの設定**に従って進みます。

**Agent の操作そのものを止める仕組みではありません。** 確認工程は工程と工程の間に立つので、**すでに前の工程で行われた操作は取り消されません**。やってほしくない操作があるなら、確認ではなく実行ルールで禁じます（[実行ルールガイド](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)にあります。**このガイドで扱うのは、ワークフローの確認工程です。**

**連携先を使う前にも、確認依頼が届くことがあります。** 連携先に「接続時の確認」を設定すると、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)）。

確認依頼の画面には、確認工程の前の工程に「次の工程に渡す値と資料の役割」を決めていれば、返された値と資料も出ます。決める前に、次の工程に何が渡るかを見られます。

画面上の場所 編集 ＞ 左の「編集ツール」＞「工程を追加」＞「確認工程」か、中央の図の工程の間の「＋ 工程を追加」＞「確認工程」で追加。設定は中央の図でその工程を選ぶと右に出ます

## 確認と手作業のどちらか

確認工程には**種類が 2 つ**あります。**その間に人がすることが違います。**

- **確認 (Agent の結果を人が判断する)** — 直前の工程の出力を見て、**進める・差し戻す・却下する**のいずれかを決めます。届いた申請を処理するワークフローなら、**Agent が確かめた結果を担当者が見て承認する**のがこれです。進めるときに、**直前の工程の出力を直してから進める**こともできます（後の節）
- **手作業 (AI は実行せず、人が作業してから進める)** — その工程では Agent が動きません。**人が自分で作業を終えてから、次へ進めます**。社内の別システムへの登録のように、**Agent に任せない作業**を業務の流れに組み込みたいときに使います。進めるときに、直前の工程の出力を直してから進めることもできます（後の節）

**確認依頼の「確認内容」タブには、直前に Agent が動いた工程の、Agent 全員の出力とファイルが並びます**（「Agent の報告」と「成果物」）。レーンの合流のすぐあとの確認工程では、各レーンで最後に Agent が動いた工程のぶんが並びます。担当者はそれを見て決めます。成果物は、名前を押すとプレビューが開き、ダウンロードもできます。プロジェクト・現在の工程・次の工程・依頼者・確認担当者は「関連情報」タブに、依頼の経過は「履歴」タブにあります。

**どちらの種類でも、その工程に Agent は置けません。** 置きたい作業がある場合は、その前後に工程を分けてください。

**種類は、待ち方とは別の設定です。** **手作業でも、期限を過ぎれば次の節の設定に従って自動で処理されます**。人が作業を終えるまで必ず止めておきたいなら、待ち方の組み合わせも合わせて決めてください（次の 2 節）。

### 出力を修正して進める

**確認・手作業のどちらの確認工程でも**、確認依頼の画面で「**出力を修正して進める**」を押すと、直前の工程の出力が編集欄に入って開きます。直した文が次の工程に渡ります。**元の出力も残り**、実行記録で「確認で修正した文」と「元の出力」を両方見られます。直せるのは 20,000 文字までです。

**出るのは、確認工程の前の工程の出力が 1 つのとき**です。「同時に実行」で 2 つ以上の Agent が動いた工程の後・合流の後・失敗から立った確認・接続の確認では出ません（「同時に実行」でも Agent が 1 つなら出ます）。外部 API からも直して進められます。確認依頼の取得で `gate.editableOutput` が null でない確認依頼に、進める（`proceed`）判断で直した文を `editedOutput`（前後の空白を除いて 20,000 文字まで）として送ります。確認依頼の `gate.contextVersion` が null でなければ、それも一緒に送ります（[外部 API のドキュメント](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference-projects.md#decide-workitem)）。

## 決められるのは指定した人と、その代理人だけ

**確認担当者に指定された人と、その人が任せた期間中の代理人だけが決められます**（[誰が何を決められるか](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/roles.md)）。これは役割とは別で、**オーナーでも、その工程の確認担当者に指定されていなければ（代理人でもなければ）決められません**。指定されていないオーナーは、確認依頼を見ることはできます。ただし、「Agent が実行」の工程の結果から作られる確認依頼と、接続の確認の確認依頼は、原則として、その時点のオーナー全員が担当者になります（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)）。確認工程でも、確認依頼が作られる時点で、指定された確認担当者が全員メンバーから外れていたときは、その時点のオーナー全員が担当者になります。

候補になるのは**プロジェクトのメンバー**です。メンバーでない人を担当者にはできないので、**決めてほしい人は先にメンバーに加えます**。**メンバーから外すと、その人は確認担当者からも外れ、決められなくなります**（期限超過時の連絡先からも外れます）（[誰が何を決められるか](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/roles.md)）。

**複数人を指定できます。** ただし**最初の回答で確定します**。全員の同意を取る仕組みではないので、**合議が必要なら、会議などで決めたうえで 1 人が代表して回答する**形にしてください。

**決まっていない確認依頼の担当は、オーナー・運用担当と組織の運用の役割の人が付け替えられます。** 担当者が不在のときなどに使います。ワークフローの実行ごとに、その実行のまだ決まっていない確認依頼の担当を、選んだメンバーに丸ごと置き換えます。新しく担当になった人にだけ、確認の依頼の通知が届きます。**工程の確認担当者の設定は変わりません。** そのあとに作られる確認依頼は、工程に指定した担当者に届きます。記録 (証跡) には「担当の付け替え」（確認依頼ごと）と「実行の担当の付け替え」（実行ごと）が残ります。

**有効な確認工程に担当者を指定していないと、実行を始められません。** メンバーから外して担当者がいなくなった工程も同じです。無効にした工程は対象外です。反映の前に「設定を検証」で確かめられます。

画面上の場所 編集 ＞ 中央の図で確認工程を選び、右の「確認の設定」＞「基本設定」＞「確認の種類」「確認担当者」。メンバーの追加は 設定 タブ ＞「メンバー」。担当の付け替えは、「対応待ち」から開くワークフローの実行の画面の「担当を付け替える」か、「対応待ち」の一括操作の「担当の付け替え」（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/record-guide.md#%E3%81%BE%E3%81%A8%E3%82%81%E3%81%A6%E6%93%8D%E4%BD%9C%E3%81%99%E3%82%8B)）

## 待たせるか、期限で進めるか

**確認方法**で 2 つから選びます。**ここが確認工程の意味を変えるところ**です。

- **担当者の判断を待つ** — 担当者が決めるまで止まります。期限を過ぎたときの動きは、次の節の設定に従います
- **期限後に自動で進める** — 期限までは担当者が決められますが、**期限を過ぎると自動で次の工程へ進みます**（最終工程なら、その実行が完了します）

**選ぶ基準は「決まらなかったときに、進んでよいか」です。** 進んでよいなら「期限後に自動で進める」、進んではいけないなら「担当者の判断を待つ」を選びます。

**人の回答を必ず得たいなら、「担当者の判断を待つ」と「通知して待機する」を組み合わせます。** この 2 つでないと、**期限を過ぎたときに人を通さず動きます**。

**期限後に自動で進んだものは、承認されたわけではありません。** 記録には、人が決めたのではなく**期限で処理されたこと**が残ります。**「人が承認した割合」には数えられませんが、「待ち時間の目安」には入ります**（[記録と指標](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/reference/settings-ref.md)）。期限が無い確認は作れません。

**決まっていない確認依頼の期限は、確認担当者と期間中の代理人のほか、オーナー・運用担当と組織の運用の役割の人も、あとから延ばせます**（決めるのは今までどおり確認担当者と代理人だけです）。 「対応待ち」の一括操作の「**期限の延長**」で、新しい期限（今より後の日時）を入れます（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/record-guide.md#%E3%81%BE%E3%81%A8%E3%82%81%E3%81%A6%E6%93%8D%E4%BD%9C%E3%81%99%E3%82%8B)）。期限超過の印は外れ、延ばした期限で次の期限超過を待ちます。確認期限の上限（720 時間）には縛られません。**延ばしても、通知のメールのリンクの期限は変わりません**（リンクが切れても、確認担当者か代理人なら画面から決められます）。記録 (証跡) には「確認期限延長」として残ります。接続の確認の期限は延ばせません。

**期限と、期限を過ぎたときの扱いは、依頼の量と合わせて決めます。** 起動への影響は[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/trigger-guide.md#%E5%90%8C%E6%99%82%E3%81%AB%E9%80%B2%E3%82%81%E3%82%89%E3%82%8C%E3%82%8B%E6%95%B0%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC)にあります。

## 期限を過ぎたらどうするか

「担当者の判断を待つ」を選んだときだけ、**期限を過ぎたあとの動きを 4 つから選べます。**

- **通知して待機する** — 期限超過を知らせるだけで、**そのあとも担当者の回答を受け付けます**
- **自動で進める** — 次の工程へ進みます（最終工程なら、その実行が完了します）
- **自動で差し戻す** — 戻り先の工程からやり直します
- **自動で却下する** — その実行を閉じます

**既定は「通知して待機する」です。** 止めたまま人を待つのが既定の振る舞いだと考えてください。

**「期限後に自動で進める」を選んでいるときは、この設定は効きません。** 画面でも選べなくなります。**期限を過ぎたら進む**という指定がすでに済んでいるためです。

**確認工程に「次の工程の候補」を置いたときも、期限を過ぎても自動では決まりません。** 「期限を過ぎたら」は選べなくなり、期限を過ぎたことを知らせて、担当者が次の工程を選ぶまで待ちます。「期限後に自動で進める」とは組み合わせられません。

**自動で差し戻す・自動で却下するは、人が見ないまま業務が動きます。** 選ぶ前に、**戻り先の工程がやり直しても差し支えないか**、**閉じてしまって困らないか**を確かめてください。

**期限を過ぎたことを、担当者以外にも知らせられます。** メンバーから 1 人を**期限超過時の連絡先**に指定すると、担当者に加えてその人にも届きます。**その人は決められません。** 決めるのは担当者と期間中の代理人だけです。

**プロジェクトの既定の連絡先も決められます。** 設定 タブの「**期限超過時の連絡先（既定）**」に 1 人を選ぶと、工程に連絡先を指定していない確認依頼（「Agent が実行」の工程の結果から作られる確認依頼も）で、その人に届きます。工程に指定した連絡先があれば、そちらが使われます。どちらも、確認依頼が作られた時点でメンバーの人だけに届きます。

**届くのは「通知して待機する」のときです（期限の前の催促は、残りが少なくなった 2 回目だけ、連絡先にも共有リンクで届きます）。** 自動で進める・差し戻す・却下する設定では、**処理が成り立てば連絡先にも届きません**。

画面上の場所 編集 ＞ 中央の図で確認工程を選び、右の「確認の設定」＞「基本設定」＞「確認方法」「確認期限（時間）」「期限を過ぎたら」「期限超過時の連絡先」。既定の連絡先は 設定 タブ ＞「トリガーと通知」＞「通知」＞「期限超過時の連絡先（既定）」（ワークフローでオーナーのときだけ変えられます）

## 決めたあと、どうなるか

担当者が選べるのは **3 つ**です。選んだあとの動きが違います。

- **次の工程へ進める** — 次の工程が動きます。**最終工程なら、その実行が完了します**（そのときは表示も変わります）
- **差し戻す** — 指定した工程から Agent がやり直します
- **却下する** — その実行を閉じます。**Agent はやり直しません**

**確認工程に「次の工程の候補」を置くと、「次の工程へ進める」の代わりに、進む工程を選んで進めます。** 候補は、この工程より後ろの工程から 2〜5 件を、表示名を付けて決めておきます。並列のレーンがあるときは、候補も確認工程と同じレーン（レーンの外では、並列の前どうし・合流のあとどうし）の工程から選びます。担当者は「**次の工程を選択する**」から 1 つを選び、「**選択した工程へ進める**」を押します。**選んだ工程までの間の工程は実行されません**（実行記録には「分岐の対象外」と出ます）。候補は、実行を始めたときに有効な工程だけが使われます。有効な候補が 2 件に満たないときは、その確認では次の工程を選ばず、ふつうに進めます。

**差し戻しと却下には、理由が必要です。差し戻しには、プロジェクトのライブラリのファイルを 5 件まで添えられます（接続の確認には添えられません）。** 進めるときだけ理由を省けます。差し戻しは**加えて戻り先の工程**も必要です。**差し戻しの理由は Agent に渡り、記録にも残ります**。何を直してほしいのかを書いてください。

**戻り先に選べるのは、この確認工程より前の、有効な Agent の工程だけです。** 確認工程や無効にした工程には戻せません。工程ごとに既定の戻り先を決めておけば、決定のときは、それがこの確認工程より前の工程である場合に使われます。**「Agent が実行」の工程の結果から作られた確認依頼では、その工程自身にも戻せます。** 戻り先には「この工程を再実行する」と添えられ、差し戻しの上限に達していなければ、それが既定の戻り先になります。外部の自動化の工程も戻り先に選べます（差し戻すと、あらためて送り直します）。並列のレーンがあるときは、戻り先も確認工程と同じレーン（レーンの外では、並列の前どうし・合流のあとどうし）の工程から選びます。戻せる工程が無いときは「戻せる工程がありません」と出て、差し戻せません。

**合流のあとの確認依頼では、担当者が決めるときに、合流の前の各レーンの Agent の工程も戻り先に選べます。** 戻り先に「（レーン名）だけ再実行し、合流を待ち直す」と添えられます。選ぶと、そのレーンだけが戻り先からやり直し、ほかのレーンは終えた結果をそのまま使って、合流で待ちます。既定の戻り先・期限による自動の差し戻し・「対応待ち」の一括の差し戻しでは、今までどおり同じ側（合流のあと）の工程に戻ります。

**同じ戻り先へ差し戻せる回数には上限があります。** 1 回の実行の中で同じ工程へ差し戻せるのは、既定で 3 回です。担当者の差し戻しも、期限による自動の差し戻しも数えます。確認依頼では戻り先ごとに「差し戻し◯/◯回」と出て、**上限に達した戻り先は選べません**。どの戻り先も上限に達したら、進めるか却下します。期限による自動の差し戻しが上限に当たったときは、決まらないまま担当者の決定を待ちます。

**戻り先の工程に Agent が置かれていないと、そこは飛ばされて次へ進みます。** やり直させたい工程に Agent があるかを確かめてください。

**却下すると、その実行はそこで閉じます。** 却下の決定は取り消せません。ただし、却下や失敗で閉じた実行は、オーナー・運用担当と組織の運用の役割の人が選んだ工程から同じ実行のまま続けられます（次の節）。最初からやり直すなら、新しく実行を始めます。

画面上の場所 左の「受信トレイ」＞「確認依頼」＞ 対象を選ぶ ＞ 決定のボタン（**最終工程では表示が変わります**）。既定の戻り先は 編集 ＞ 中央の図で確認工程を選び、右の「確認の設定」＞「基本設定」＞「既定の差し戻し先」。次の工程の候補は 編集 ＞ 中央の図で確認工程を選び、右の「確認の設定」＞「基本設定」＞「次の工程の候補を使用する」。差し戻しの上限は 設定 タブ ＞「実行ルール」＞「実行」＞「差し戻しの上限（同じ戻り先への回数）」（変更は次に始まる実行から）

## 閉じた実行を再開する

**却下か失敗で閉じたワークフローの実行は、オーナー・運用担当と組織の運用の役割の人が選んだ工程から、同じ実行のまま続けられます。（失敗は、Agent の工程だけでなく外部の自動化の工程の失敗も含みます。）** 中断した実行は再開できません。もう一度やるなら、新しく実行を始めます。

**「再開する」を押すと、閉じた理由と、再開する工程を選ぶ画面が出ます。** 理由は「『（工程名）』の確認で却下」か「『（工程名）』で失敗」と出て、却下なら却下の理由も並びます。

- **再開する工程** — 閉じる原因になった工程と同じ側（同じレーン。レーンの外では、並列の前どうし・合流のあとどうし）にある、その工程までの Agent の工程と外部の自動化の工程から選びます。既定は、原因が Agent の工程か外部の自動化の工程ならその工程、確認工程ならその前の直近の Agent の工程か外部の自動化の工程です。戻れる Agent の工程が無いときは、再開できません
- **再開の理由** — 必須です（1000 文字まで）。理由は、再開で動き直した工程の行に出ます。記録 (証跡) には再開したことが残りますが、理由の文は残りません

**再開すると、選んだ工程から後を実行し直し、前の結果は残ります。** 工程の並びと配置は、その実行を始めたときのままです。レーンの中の工程から再開したときは、合流に着いていたほかのレーンは結果をそのまま使って合流で待ち、実行が閉じたときに止まったほかのレーンは、止まった工程から動き直します。却下した確認依頼は開き直しません。後ろの確認工程に着けば、新しい確認依頼が作られます。再開で動き直した工程の行（ほかのレーンで動き直した行も含みます）には「再開：（理由）」と出ます。

**次のときは再開できません。** プロジェクトが一時停止しているとき、管理者がプロジェクトを止めているとき、同時に進められる数に達しているとき（再開した実行も数えます。[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/trigger-guide.md#%E5%90%8C%E6%99%82%E3%81%AB%E9%80%B2%E3%82%81%E3%82%89%E3%82%8C%E3%82%8B%E6%95%B0%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/control-guide.md)）
- **期限による自動処理を、人の判断として数える。** 「期限後に自動で進める」で進んだものは、**担当者が答えていません**。**「人が承認した割合」からは除かれますが、「待ち時間の目安」には入ります。** 一方、**自動で差し戻した・却下したものは、「差し戻し・却下・中断」に入ります**（[記録と指標](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/records-and-metrics.md)）
- **「あとで人に聞けばよい」と考えて工程を組む。** **Agent は実行の途中で人の回答を待ちません。** 人に決めてほしいことは、ワークフローなら**確認工程として置きます**。サイクルでは確認工程を置けないので、**対象ごとに保留して人の判断を挟みます**（[設計ガイド](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)）
- **オーナーなら決められると思う。** 決められるのは**確認担当者に指定された人と、期間中の代理人だけ**です。オーナーという役割だけでは決められません（「Agent が実行」の工程の結果から作られる確認依頼だけは、原則としてオーナー全員が担当者になります）
- **複数人を指定すれば合意が取れると思う。** **最初の回答で確定します。** 全員の同意を待つ仕組みではありません
- **却下した実行はもう続けられないと思う。** **却下か失敗で閉じた実行は、オーナー・運用担当と組織の運用の役割の人が選んだ工程から再開できます。** 却下した確認依頼そのものは開き直しません

## 次に読むもの

- [設計ガイド](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/trigger-guide.md) — いつ、何をきっかけに動かすか
- [連携ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/connection-guide.md) — 確認依頼をどこへ知らせるか
- [人の確認](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/human-review.md) — 確認工程の考え方
- [設定値リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md) — 確認期限の既定と上限
