記録ガイド
実行記録と指標の読み方は SaaS 版と同じです(記録ガイド・記録と指標)。このページは、マーケットプレイス版で違う点をまとめます。
どこを見るか
見る場所は 4 つあります(ワークフロー履歴はワークフローだけです)。
- 概要 — いまの状態と、期間を選んだ指標です。数え方は後の「指標の数え方」にあります
- 実行履歴 — 実行の一覧です。「起動」の列に、何で始まったか(巡回など)が出ます。結果の絞り込みに「実行終了 (完遂は未計測)」があります。ここから 1 件を開くと、実行記録が開きます
- ワークフロー履歴 — 案件の一覧です。行の「案件の詳細」から案件の画面(進行・設定・ファイル・記録)へ進みます(案件ガイド)
- 対応待ち — 人の手が要るものの一覧です(次の節)
プロジェクトをまたぐ確認依頼は、左の「受信トレイ」>「確認依頼」で見ます(確認ガイド)。
うまく終わらなかった実行と、決まらないまま残っている確認依頼について、見る担当と間隔を決めておきます。 たとえば、オーナーが毎朝「対応待ち」を見て、残っている確認依頼を確認担当者に促す、といった分担です。
対応待ちで人の手が要るものを片付ける
「対応待ち」には、人の手が要るものが 1 件 1 行で並びます。 設定は要りません。確認依頼・実行・巡回の記録から、毎回その時点の状態で作られます。種類は 8 つです。
| 種類 | 並ぶもの | 担当 |
|---|---|---|
| 確認待ち | まだ決まっていない確認依頼 | 確認担当者 |
| 期限超過 | 確認期限を過ぎて、まだ決まっていない確認依頼。期限を過ぎても自動では決まりません(確認ガイド) | 確認担当者 |
| 外部待ち | 外部条件待ちの確認で、確認期限の前に、連携先の状態を読めずにいるもの。理由は案件の画面に出ます。確認期限を過ぎると「期限超過」に並びます(確認ガイド) | 確認担当者 |
| 失敗 | 進行中の案件で、今の工程の Agent が失敗し、確認依頼も開いていないもの | オーナー |
| 差し戻し待ち | 差し戻されて、戻り先の工程がまだ動いていないもの | 差し戻した確認依頼の担当者 |
| 巡回の失敗 | サイクルで、配置の最後の巡回が失敗の結果(「失敗 (Agent の報告)」「失敗」「ルールにより実行不可」「時間切れ」)で終わったもの | オーナー |
| 締め切り超過(実行) | 締め切りを過ぎても終わっていない案件 | オーナー |
| 停滞 | 実行中の案件が、「停滞とみなす時間」を過ぎても進まないもの(確認待ちと、中断を要求した案件は含みません) | オーナー |
並びは優先度(P1〜P4)の順です。 優先度は機械的に決まり、手で変えることはできません。同じ優先度の中では、期限の近いもの、古いものが先です。
- P1 — 期限超過、外部待ち、締め切り超過(実行)
- P2 — 失敗、巡回の失敗、停滞、確認期限まで 24 時間を切った確認待ち
- P3 — それ以外の確認待ち、差し戻し待ち
- P4 — 期限の無い確認待ち
一度に並ぶのは 100 件までです。 上の種類で絞り込めます。
まとめて操作する
行を選ぶと「一括操作」が出ます。 操作は次のとおりです。選んだ行のうち、その操作の対象になる行に行われます(対象外の行の数は画面に出ます。担当の付け替えだけは、下の表のとおり案件ごとに行われます)。マーケットプレイス版では、次のとおりです。
| 操作 | マーケットプレイス版での扱い |
|---|---|
| 承認・却下・差し戻し | 案件の確認依頼は、確認依頼を開いて、確認した版を踏まえて 1 件ずつ決めます。承認は、確認待ちと期限超過の確認依頼が対象で、外部待ちの行は人が進められません |
| 期限の延長 | 確認依頼が対象です。新しい期限(今より後の日時)を入れます |
| 担当の付け替え | 案件の確認依頼が対象です。付け替えは案件ごとに行われ、その案件の未決の確認依頼は、選んでいない行も含めてすべて置き換わります。 新しい担当は、そのプロジェクトのメンバーから選びます |
組織の運用の役割だけで開いた人が使えるのは、期限の延長と担当の付け替えです。
結果は 1 件ごとに出ます。 「成功」のほか、「既決」(ほかの人が先に決めた)、「権限なし」、「競合(内容が更新されました)」、「個別に判断してください」、「見つかりません」、「失敗」などです。「個別に判断してください」と出た行は、確認依頼を開いて 1 件ずつ決めます。
画面上の場所 プロジェクトの「対応待ち」タブ。まとめての操作は、行を選ぶと出る「一括操作」
締め切りと停滞(ワークフロー)
案件には、締め切りを付けられます。 締め切りを過ぎても、案件は止まりません。 「対応待ち」の「締め切り超過(実行)」に並びます。
- 既定の締め切り — 設定 >「実行ルール」の「実行の既定の締め切り(開始からの時間)」を選ぶと、そのあとに始まる案件ごとに、開始からその時間の締め切りが付きます。既定は「なし」です
- 案件ごとの締め切り — 案件の画面で設定・変更・解除します(案件ガイド)
実行中の案件が進まないときは、「停滞」として「対応待ち」に並びます(確認待ちと、中断を要求した案件は含みません。締め切りを過ぎた案件は、「締め切り超過(実行)」のほうに並びます)。 「停滞とみなす時間」は、最後に工程が終わってから(まだ 1 つも終わっていなければ始まってから)の時間です。既定は 24 時間です。
画面上の場所 設定 >「実行ルール」の「実行の既定の締め切り(開始からの時間)」「停滞とみなす時間」(ワークフローでオーナーのときだけ変えられます)
1 回の実行を読む
実行記録には、SaaS 版の項目に加えて「実行環境のイメージ」が出ます(「実行情報」の「実行時の設定」)。その実行で動いた登録 Agent のコンテナのイメージです。ワークフローでは管理者が認定した image digest(sha256:…)が、サイクルではレジストリ・イメージ名・タグが出ます。
ワークフローの実行記録やワークフロー履歴からは、「案件の詳細」で案件の画面を開けます。設定と成果物のバージョンは、案件の画面で見ます(案件ガイド)。
見出しの「現在の設定」で出るものは、SaaS 版と違います。 契約が登録されていて読み取れる登録 Agent では、契約の要約(「外部への効果」と実行上限・「ファイル」・「出力」・「連携先」)が出ます。契約が無い、または読み取れない Agent(サイクルにだけ置く会話の Agent など)では、「この情報は現在利用できません」と出ます。どちらも「Agent を編集」は出ません。
本文を見るときは理由が残る
工程の実行の本文(その実行の依頼と応答)は、理由を入れて開きます。 開くには、実行記録の画面で理由(300 字まで)を入力します。理由を入れて開いたメンバーだけが、本文を読めます(理由の有効時間は 30 分で、過ぎると、もう一度理由を入力します)。開いた人と理由は記録に残ります。組織の運用の役割だけで開いた人は、本文を開けません。
起動できなかったとき
登録 Agent が起動できなかったときは、実行記録に理由が出ます。よく出る理由と直すところです。
| 理由 | 直すところ |
|---|---|
| Agent がこのプロジェクトの実行ルールに未対応 | プロジェクトの基本ルールと、Agent の「使える実行ルール」を見比べる(実行ルールと通信ガイド) |
| Agent の認定情報が不足 | 管理者が、Agent の認定を登録し直す |
| Agent の契約が不正 | 管理者が、Agent の契約を直す |
| 工程で選択した連携先が使用不可 | オーナーが、工程の設定で選んだ連携先と、設定の連携先を確かめる |
| 連携先の承認済みのバージョンが変更または不明 | 連携先の設定が変わった。オーナーが工程の設定の連携先を選び直す |
| 連携先の資格情報が無いか無効 | 連携先を接続し直す |
| 実行する Agent のイメージの特定に失敗 | 管理者が、Agent のイメージの設定(レジストリ・イメージ名)を確かめる(主にサイクル) |
| 管理者が設定した環境変数と重複 | 管理者が、Agent の環境変数から基盤が決める名前を外す(サイクル) |
| 工程の環境変数に使用できない名前を指定 | オーナーが、その工程の環境変数から使えない名前を削除する(サイクル) |
サイクルの結果「実行終了 (完遂は未計測)」
サイクルの登録 Agent は、処理を終えて正常に終了しても、仕事を果たしたかどうかを基盤は判断できません。 そのような実行の結果は「実行終了 (完遂は未計測)」になります。
- 成功にも失敗にも数えません。 Agent の完遂率などの指標の母数に入りません。概要の指標には「完遂は未計測」の件数が別に出ます
- 実行履歴の結果の絞り込みに「実行終了 (完遂は未計測)」があります
- 実行が何をしたかは、その実行の会話で確かめます
- 結果の通知(連携ガイド)は届きません。結果の通知が届くのは、Agent が完遂を報告した実行だけです
Agent が完遂したかを報告する作りになっていれば(SDK の report_completion)、SaaS 版と同じ 7 つの結果で記録されます。作り方ははじめてのエージェントにあります。
Agent のプロセスが異常に終わったとき、Pod が消えたとき、実行上限を過ぎたときは、Agent の報告があっても使わず、失敗・時間切れとして記録します。
サイクルの実行を止める
動いているサイクルの実行は、その実行記録の「停止する」で止められます。オーナー・運用担当と組織の運用の役割の人に出ます。起動を待っている実行と、動いている実行に使えます。
会話の画面の停止では、サイクルの実行は止まりません。 実行記録の「停止する」を使ってください。
指標の数え方
指標の数え方は SaaS 版と同じです(実行結果リファレンス)。母数になるのは、ワークフローでは工程に置いた登録 Agent の実行(確認工程や通過した工程は除く)、サイクルでは登録 Agent の実行(周期の巡回と、Webhook での起動の両方)です。「実行終了 (完遂は未計測)」は母数に入りません。
記録 (証跡)
記録 (証跡) には、SaaS 版の出来事に加えて「案件設定の変更」が残ります。案件の設定を新しいバージョンにしたときの記録です。改善案の相談・メール・並列のレーンの合流に関する出来事は、マーケットプレイス版にはありません。条件分岐の「条件分岐の判定」「条件分岐で人に確認」は、SaaS 版と同じに残ります。
実績から見直す
SaaS 版の記録ガイドの「実績から見直す」のうち、AI に改善案を相談して実施する機能はありません。 見直すときは、実行記録と確認の実績を読み、次のように直す場所を選びます。
| 見えたもの | 直すところ |
|---|---|
| 工程の設定の値が合っていない | オーナーが工程の設定を直す |
| 確認で毎回同じ直しをしている | 管理者に契約の標準値を、開発者に Agent の作りを相談する |
| 失敗・時間切れが続く | 開発者に Agent の作りと実行上限を、環境を運用する人に通信の許可を確かめてもらう(実行ルールと通信ガイド) |
| 「ルールにより実行不可」が続く | プロジェクトの基本ルールと、Agent の「使える実行ルール」を見比べる |
取り違えやすいところ
- 結果が「完了」なら、業務がうまくいったと思う。 「完了」は、Agent が完遂として終えたという意味にとどまります。成果物の中身で確かめます
- サイクルの「実行終了 (完遂は未計測)」を失敗と読む。 成功にも失敗にも数えません。何をしたかは、その実行の会話で確かめます
- 会話の画面の停止で、サイクルの実行が止まると思う。 実行記録の「停止する」を使います
- 対応待ちの承認・却下・差し戻しを、まとめてできると思う。 案件の確認依頼は、1 件ずつ決めます
- 期限超過の確認が、自動で決まると思う。 決まりません。期限超過として「対応待ち」に並び、確認担当者の判断を待ちます
次に読むもの
- 確認ガイド — 確認依頼の決め方
- 案件ガイド — 案件の画面と、設定・成果物のバージョン
- 実行結果リファレンス — 結果の語と、Agentの完遂率の式