メインコンテンツまでスキップ

記録リファレンス

プロジェクトの「記録 (証跡)」に残る出来事と、その 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_appliedAI(α版)に相談して出た案を取り込んだ(相談して作ったとき、または案を下書きに取り込んだとき)。取り込んだ数と取り込まなかった数が残り、案の本文は残らない
完了の遅延到着completion.stale実行の結果が、その工程やワークフローの実行がもう終わったあと(中断したあとなど)に届いた
(操作の種別)tool.accessAgent の操作を実行ルールで判定した。止められたときは decision が deny
(操作の種別)tool.invokedAgent がツールを呼び出そうとした
(操作の種別)tool.effectツールの呼び出しの結果
(操作の種別)a2a.invokedAgent が他の 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 は、プロジェクトの記録を一覧で出します(理由の入力が要るのは同じです)。