記録リファレンス
プロジェクトの「記録 (証跡)」に残る出来事と、その CSV、実行記録の「エクスポート」の中身の一覧です。項目の名前は画面の表示に合わせています。記録のたどり方は記録ガイドにあります。
記録 (証跡) の一覧
実行履歴 タブ >「記録 (証跡)」に、新しい順に並びます。
| 列 | 内容 |
|---|---|
| 日時 | 出来事が起きた時刻 |
| 種別 | 出来事の種類(下の表)。ツールの操作は、実行ルールと同じ操作の種別(テキスト書き込み・連携先など)で出る |
| 記録した人・Agent | 利用者なら名前(名前が無ければメールアドレスや ID)。利用者を特定しない記録は「利用者」。メールで起動した外部の送信者は「外部の送信者([EXT])」。それ以外は「Agent」か「システム」。期限による自動処理は「システム」 |
| チャネル | 確認の決定と、確認の依頼・確認期限超過などのメールの記録に付く。app(画面で決めた)・mail(メールの専用リンクで決めた、またはメールの送信の記録)・mail_reply(確認の依頼のメールに「承認」か「APPROVE」と返信して承認した)・system(期限による自動処理) |
| 内容 | 確認依頼の題名・決定・理由・工程名など、種類ごとの要点 |
- 「種別」で絞り込めます。選べるのは、このプロジェクトの記録にある種類だけです。
- 「記録を検索」で、語で探せます。探すのは記録の元のデータ(種類の名前・理由・付いている参照の情報など)で、画面に出る実行者の名前・工程名・確認依頼の題名・種別の表示名では見つかりません。
- 「CSV出力」で CSV に出せます。出すときは理由の入力が必要です。CSV に反映されるのは種別の絞り込みだけで、検索語は反映されません。
記録に残る出来事
| 種別 | CSV の event_type | 何が起きたとき |
|---|---|---|
| 確認の依頼 | gate.requested | 確認依頼が作られた(確認工程に入ったとき、Agent の結果が「ルールにより実行不可」「失敗 (Agent の報告)」で確認を求める設定のとき、「同時に実行」の工程で Agent ごとに次の工程が分かれたとき、または Agent が「接続時の確認」を設定した連携先を使おうとしたとき(接続の確認)) |
| 確認結果の記録 | gate.resolved | 確認依頼が決まった(内容に、人が進めた決定は「承認」、期限で進んだものは「期限による自動処理」、ほかは「差し戻し」「却下」と出る)。期限による自動処理も入る |
| 確認期限超過 | gate.overdue | 確認依頼が期限を過ぎた |
| 確認依頼の失効 | gate.cancelled | 接続の確認が決まらないまま実行が終わり、その確認依頼を失効させた |
| 確認期限延長 | gate.extended | 確認依頼の確認期限を延ばした |
| 担当の付け替え | gate.reassigned | ワークフローの実行の確認担当者を付け替えた。まだ決まっていない確認依頼ごとに 1 行残る |
| 通知を送信待ちに登録しました | delivery.accepted | 確認の依頼・確認期限超過のメールなどを、送信の受付に渡した |
| 通知の送信完了 | delivery.acked | 通知の送信が確かめられた |
| 通知の送信失敗 | delivery.failed | 通知を送れなかった |
| 通知を送信できたか不明 | delivery.unconfirmed | 通知の送信結果を確かめられなかった |
| 実行ルールの変更 | policy.changed | 実行ルール(基本ルール・禁止操作)、確認担当者、確認方法、メールで起動の設定を変えた |
| メンバー/役割の変更 | policy.changed | メンバーを足した・外した、役割を変えた |
| ワークフロー実行の開始 | run.started | ワークフローの実行が始まった |
| ワークフロー実行の再開 | run.resumed | 却下・失敗で閉じたワークフローの実行を、オーナー・運用担当と組織の運用の役割の人が選んだ工程から再開した |
| レーンの合流 | run.lane_joined | ワークフローの実行で、全レーンが終わって合流した |
| 時間トリガーで開始できず | run.start_failed | 決めた時刻(時間トリガー、または有効な時間トリガーが無いときの最初の有効な工程の時刻)に、ワークフローの実行を始められなかった。同じ理由が続くあいだは、最初の 1 回だけ残る |
| メールでの起動を拒否 | mail.rejected | プロジェクトの宛先に届いたメールを、メールで起動の条件で断った(理由は「受け付けなかったメール」と同じ)。理由と送信元のドメインが残り、アドレス・件名・本文は残らない。同じ理由は、知らせを送る相手は同じアドレスごと、それ以外は同じ送信元のドメインごとに 1 時間に 1 行 |
| 締め切りの設定 | run.deadline_set | ワークフローの実行の締め切りを設定した、または外した。実行が始まるときに既定の締め切りが付いたときは残らない |
| 締め切り超過 | run.deadline_overdue | ワークフローの実行が締め切りを過ぎた。実行は止まらず、オーナーに知らせる。同じ締め切りでは 1 回だけ残る(通知をオフにしていても残る) |
| 停滞 | run.stalled | ワークフローの実行が、最後に工程が終わってから(まだ 1 つも終わっていなければ始まってから)「停滞とみなす時間」を過ぎても進まなかった。確認待ちのあいだ、中断を求めたあと、締め切りを過ぎた実行は入らない。実行は止まらず、オーナーに知らせる。工程が進むまでは 1 回だけ残る(通知をオフにしていても残る) |
| 実行の担当の付け替え | run.approvers_reassigned | ワークフローの実行の確認担当者を付け替えた。実行ごとに 1 行で、付け替えた確認依頼の数が残る |
| 外部の自動化の呼び出し | automation.called | 外部の自動化の工程が、宛先へ送った。結果と理由が残る |
| 条件分岐の判定 | branch.decided | 条件分岐の工程が、進むレーン(または何もせずに合流)を決めた(どの条件で決めたかが残る) |
| 条件分岐で人に確認 | branch.asked_human | 条件分岐の工程で次の工程が決まらず、進むレーンか何もせずに合流を人に選択してもらう確認依頼を作った |
| 巡回再実行要求 | sweep.rerun_requested | サイクルの巡回で、うまくいかなかった実行をもう一度動かすよう求めた(配置の今の設定で 1 回動く)。接続の確認の承認で巡回を起動し直したときも残る |
| 停止を要求 | stop_signal.received | 実行中の Agent が、停止の要求を受け取った |
| 本文閲覧 | forensic.viewed | 実行記録の本文を開いた。理由が残る |
| 実行記録のエクスポート | forensic.exported | 実行記録をエクスポートした、または記録 (証跡) を CSV に出力した。理由が残る |
| 改善案の相談 | consult.failure_requested | うまくいかなかった実行から、改善案を相談した |
| 改善案の実施 | improvement.applied | 改善案を実施した(保存した変更) |
| 相談の案の取り込み | consult.proposal_applied | AI(α版)に相談して出た案を取り込んだ(相談して作ったとき、または案を下書きに取り込んだとき)。取り込んだ数と取り込まなかった数が残り、案の本文は残らない |
| 完了の遅延到着 | completion.stale | 実行の結果が、その工程やワークフローの実行がもう終わったあと(中断したあとなど)に届いた |
| (操作の種別) | tool.access | Agent の操作を実行ルールで判定した。止められたときは decision が deny |
| (操作の種別) | tool.invoked | Agent がツールを呼び出そうとした |
| (操作の種別) | tool.effect | ツールの呼び出しの結果 |
| (操作の種別) | a2a.invoked | Agent が他の Agent に依頼しようとした(依頼したことの記録で、うまくいったことは表さない) |
- 「実行ルールの変更」として残るのは、上の 4 つの設定の変更だけです。 工程・Agent・時間トリガー・連携先などの設定の変更は、画面の一覧には出ません。ただし、保存した変更は、変えた項目ごとに 1 行が記録に残り、CSV に入ります(下の CSV の節)。ただし、実行記録から改善案を実施したときは、保存した変更ごとに「改善案の実施」が残ります。
- 通知の宛先のメールアドレスは残りません。
記録 (証跡) の CSV
「CSV出力」で、いま選んでいる種別の記録を、新しい順に 5000 件まで出力します(件数は設定値リファレンス)。上限で切れたときは、画面に「新しい順に◯件を出力しました(全◯件)」と出ます。
| 列 | 内容 |
|---|---|
occurred_at | 時刻(UTC) |
event_type | 出来事の種類(上の表の event_type) |
actor | 利用者なら名前(名前が無ければメールアドレスや ID)。それ以外は、記録した仕組みの名前か、実行者の区分 |
decision | 決定や判定の値(確認の決定なら proceed=承認、send_back=差し戻し、reject=却下) |
reason | 理由。本文閲覧と実行記録のエクスポートでは、入力した理由の文 |
step | 工程名 |
workitem | 確認依頼の題名 |
run_id | ワークフローの実行の ID |
root_execution_id | 実行の ID |
metadata | 記録に付いた参照の情報(JSON) |
- 画面の一覧に出ない種類の行も入ることがあります。 画面は、表示の語が決まっている種類だけを並べます。CSV には、ガードレールで止められた
guardrail.blocked、制限時間で打ち切られたkill_switch.triggeredなど、実行の中の出来事も入ります。ライブラリ タブのファイルの登録(library.registered)、新しいバージョンの追加(library.version_added。古いバージョンに戻したとき、実行が書き戻したとき、実行記録の成果物を新しいバージョンとして入れたときも)、削除(library.deleted)も、CSV にだけ入ります。プロジェクトの定義(工程・配置・トリガー・連携先・基本ルールなど)を保存したときの記録も、CSV にだけ入ります。変えた項目ごとに 1 行(project.definition_changed)で、作ったときは最初の版だけで行は残らず、同じ内容を保存し直しても増えません。定義の変更に承認を要るテナントでは、承認の依頼(project.definition_submitted)・承認(project.definition_approved)・差し戻し(project.definition_rejected)・取り消し(project.definition_withdrawn)の行も入り、変更の行には申請した人と承認した人が残ります。定義を書き出したとき(project.exported)、ファイルから取り込んでプロジェクトを作ったとき(project.imported)、社内のひな形から作ったとき(project.created_from_template)、社内のひな形として公開したとき(project.template_published。「ひな形を更新する」も)、公開をやめたとき(project.template_unpublished)の行も、CSV にだけ入ります。 - ツールの操作は、
event_typeの名前のまま出ます。 画面のような操作の種別の語にはなりません。
実行記録のエクスポート
実行記録の「エクスポート」は、開いている実行記録の実行と、それにかかわる記録を JSON のファイルに出力します(ワークフローでは、同じ実行の流れと工程の行も入ります)。理由の入力が必要で、記録 (証跡) に「実行記録のエクスポート」として残ります。
| 入るもの | 入らないもの |
|---|---|
| 実行の状態・結果・理由・時刻・やり直しの回数 | Agent とのやりとりの本文 |
| そのとき効いていた実行ルール(基本ルールとバージョン)と、使ったモデルの名前 | 終了時の報告のコメント |
| ツールの呼び出しや外部サービスの呼び出しの件数、終了時の報告の、完遂したかどうかと分類 | ツールに渡した値や、書き込んだ本文 |
| 記録 (証跡) の行(種類・実行者・決定・理由のコード・参照の ID) | 確認依頼の題名や、決定の理由の文 |
| プロジェクトのライブラリから渡した・保存したファイルの参照(ファイルとバージョンの ID・ハッシュ値・作業場所での名前)、メールへの返信で承認したときの認証の結果、閉じた実行の再開(元の状態・前後の回・再開したレーン) | 再開の理由の文 |
| 記録ごとの検証用のハッシュ値と、出力した記録全体のハッシュ値 | 作ったファイルや受け取ったファイルの情報(ライブラリでの名前・置き場所・大きさなど) |
| ワークフローの実行の流れ(工程の並び・同時に実行・レーン・並列と合流・次の工程の参照)と、工程ごとの行(配置・レーン・回・状態・理由・時刻)、レーンごとの状態 | 工程名・説明・指示・レーン名・次の工程の候補の表示名 |
| その実行から作られた確認依頼(状態・決定・決めた人・選んだ次の工程と差し戻し先の参照) | (上の「確認依頼の題名や、決定の理由の文」と同じ) |
記録 (証跡) の「CSV出力」とは別のものです。 CSV は、プロジェクトの記録を一覧で出します(理由の入力が要るのは同じです)。