Records Reference
The events recorded under a project's “Records (audit trail)”, its CSV, and what the “Export” of a run record contains. Item names follow what the screen shows. How to trace the records is covered in the Record Guide.
The Records (audit trail) list
Under the Execution history tab > “Records (audit trail)”, events are listed newest first.
| Column | Content |
|---|---|
| Time | When the event happened |
| Event | The kind of event (see the table below). A tool operation is shown by its operation kind, the same kinds as in the execution rules (Text write, Connector and so on) |
| Who | A user's name (their email address or ID when there is no name). Records that do not identify the user show “User”. An external sender who started it by email shows “External sender ([EXT])”. Otherwise “Agent” or “System”. An automatic action at a deadline is “System” |
| Channel | Set on review decisions and on the records of review-request, review-overdue and similar emails. app (decided on screen), mail (decided through the personal link in an email, or a record of sending the email), mail_reply (approved by replying “承認” or “APPROVE” to the review-request email), system (an automatic action at a deadline) |
| Content | The main points for each kind of event: the review request's title, the decision, the reason, the step name and so on |
- You can filter by “Event”. Only the kinds present in this project's records can be chosen.
- “Search records” finds entries by a word. It searches the stored record data (the event name, the reason, the attached reference information and so on); the names of users, step names, review request titles and event labels shown on screen are not searched.
- “Export CSV” exports them as CSV. A reason is required when you export. Only the event filter carries into the CSV; the search term does not.
The events that are recorded
| Event | event_type in the CSV | When it is recorded |
|---|---|---|
| Confirmation requested | gate.requested | A review request was created (on reaching a review step, when an agent's result was “Not allowed by rules” or “Failed (reported by agent)” and the step is set to ask for review, when the agents on a step set to “Run at the same time” point to different destinations, or when an agent is about to use a connector set to confirm before connecting (a connection confirmation)) |
| Review result recorded | gate.resolved | A review request was decided (Content shows “Approved” for a person's decision to proceed, “Automatic deadline action” for one made at the deadline, or “Sent back” / “Rejected”). Automatic actions at a deadline are included |
| Confirmation overdue | gate.overdue | A review request passed its deadline |
| Review request voided | gate.cancelled | A connection confirmation was still undecided when the run ended, and the request was voided |
| Confirmation deadline extended | gate.extended | A review request's deadline was extended |
| Approvers reassigned | gate.reassigned | The reviewers of a workflow run were reassigned. One row is kept for each review request not yet decided |
| Notification queued for sending | delivery.accepted | A notification, such as a review-request or review-overdue email, was handed over to be sent |
| Delivery Acked | delivery.acked | Sending the notification was confirmed |
| Delivery Failed | delivery.failed | The notification could not be sent |
| Delivery Unconfirmed | delivery.unconfirmed | The result of sending the notification could not be confirmed |
| Execution rules changed | policy.changed | The execution rules (basic rules and forbidden operations), the reviewers, the review method or the email start settings were changed |
| Member / role change | policy.changed | A member was added or removed, or a role was changed |
| Run started | run.started | A workflow run started |
| Run resumed | run.resumed | A workflow run closed by a rejection or a failure was resumed by owners, operators and people with the organization operations role from a chosen step |
| Lanes joined | run.lane_joined | In a workflow run, every lane finished and they joined |
| Could not start from the time trigger | run.start_failed | A workflow run could not be started at its set time (a time trigger, or, when no enabled time trigger exists, the time on the first enabled step). While the same reason continues, only the first one is kept |
| Email start rejected | mail.rejected | An email to the project's address was refused under the conditions for starting by email (the reasons are the same as in “Rejected emails”). The reason and the sender's domain are kept; the address, subject and body are not. One row per hour for the same reason (per address for senders who are notified, otherwise per sender domain) |
| Deadline set | run.deadline_set | A workflow run's deadline was set or removed. It is not kept when a default deadline is given as the run starts |
| Past deadline | run.deadline_overdue | A workflow run passed its deadline. The run is not stopped, and the owners are notified. It is kept only once for the same deadline (even when the notification is switched off) |
| Stalled | run.stalled | A workflow run made no progress for the “Hours before a run counts as stalled” after its last step finished (or after it started, if no step has finished yet). It does not cover a run waiting for review, a run that has been asked to cancel, or a run past its deadline. The run is not stopped, and the owners are notified. It is kept only once until a step moves on (even when the notification is switched off) |
| Run approvers reassigned | run.approvers_reassigned | The reviewers of a workflow run were reassigned. One row per run, with the number of review requests reassigned |
| External automation called | automation.called | An External automation step sent to its destination. The result and reason are kept |
| Branch decided | branch.decided | A Branch step decided the lane to go to (or to join directly) (the condition that decided is kept) |
| Branch asked a person | branch.asked_human | A Branch step could not decide where to go, so a review request was created for a person to choose a lane or joining directly |
| Sweep rerun requested | sweep.rerun_requested | In a cycle's sweep, a run that did not go well was asked to run again (it runs once with the placement's current settings). It is also left when a sweep starts again after a connection confirmation is approved |
| Stop requested | stop_signal.received | The running agent received a request to stop |
| Body Viewed | forensic.viewed | The body of a run record was opened. The reason is kept |
| Execution records exported | forensic.exported | A run record was exported, or Records (audit trail) was exported as CSV. The reason is kept |
| Improvement ideas requested | consult.failure_requested | Improvement ideas were consulted on from a run that did not go well |
| Improvement applied | improvement.applied | An improvement idea was applied (the changes saved) |
| Consultation proposal taken in | consult.proposal_applied | A proposal from consulting the AI (alpha) was taken in (when a project was created by consulting, or a proposal was taken into the draft). The numbers taken in and not taken in are kept; the text of the proposal is not |
| Stale Completion | completion.stale | A run's result arrived after its step or its workflow run had already ended (for example, after it was cancelled) |
| (the operation kind) | tool.access | An agent's operation was judged by the execution rules. When it was stopped, decision is deny |
| (the operation kind) | tool.invoked | An agent was about to call a tool |
| (the operation kind) | tool.effect | The result of a tool call |
| (the operation kind) | a2a.invoked | An agent was about to send a request to another agent (a record that it tried; it does not show that the request succeeded) |
- “Execution rules changed” covers only the four settings above. Changes to steps, agents, time triggers, connectors and other settings are not shown in the on-screen list. A saved change is, however, recorded as one row for each item that changed, and appears in the CSV (see the CSV section below). However, when an improvement idea is applied from a run record, “Improvement applied” is recorded for each saved change.
- The email addresses that notifications were sent to are not recorded.
The Records (audit trail) CSV
“Export CSV” exports the records of the event you have chosen, newest first, up to 5000 (the count is in the Settings reference). When it is cut off at the limit, the screen says “Exported the newest ◯ entries (◯ in total).”
| Column | Content |
|---|---|
occurred_at | The time (UTC) |
event_type | The kind of event (the event_type in the table above) |
actor | A user's name (their email address or ID when there is no name). Otherwise, the name of the part of the platform that recorded it, or the kind of actor |
decision | The value of the decision or judgement (for a review decision: proceed = Approved, send_back = Sent back, reject = Rejected) |
reason | The reason. For a body viewed and an export of run records, the reason that was entered |
step | The step name |
workitem | The review request's title |
run_id | The ID of the workflow run |
root_execution_id | The ID of the run |
metadata | The reference information attached to the record (JSON) |
- The CSV can include kinds of rows that the on-screen list does not show. The screen lists only the kinds that have a label. The CSV also carries events inside a run, such as
guardrail.blocked(stopped by the guardrail) andkill_switch.triggered(cut off at the time limit). Registering a file on the Library tab (library.registered), adding a new version (library.version_added, also when an old version is restored, when a run writes the file back, and when an artifact in a run record is added as a new version) and deleting a file (library.deleted) also appear only in the CSV. So does the record of saving the project's definition (steps, placements, triggers, connectors, basic rules and so on): one row for each item that changed (project.definition_changed). Creating a project leaves only its first version and no row, and saving the same content again adds none. Where definition changes need approval in the tenant, rows for the approval request (project.definition_submitted), approval (project.definition_approved), sending back (project.definition_rejected) and withdrawal (project.definition_withdrawn) are also included, and the change rows keep who requested and who approved it. Rows for exporting a definition (project.exported), creating a project by importing a file (project.imported), creating one from a company template (project.created_from_template), publishing as a company template (project.template_published; also when you update it) and stopping sharing (project.template_unpublished) are also only in the CSV. - Tool operations appear under their
event_typenames. They are not turned into operation kinds as on screen.
Exporting a run record
“Export” on a run record writes the execution of the open run record, and the records related to it, to a JSON file (for a workflow, the flow and step rows of the same run are included). A reason is required, and it is kept in Records (audit trail) as “Execution records exported”.
| Included | Not included |
|---|---|
| The run's state, result, reason, times and retry count | The body of the exchange with the agent |
| The execution rules in effect at the time (basic rules and version), and the name of the model used | The comment in the closing report |
| The counts of tool calls and external-service calls, and whether the closing report said it finished, with its category | The values passed to tools, and the body written |
| The Records (audit trail) rows (kind, who, decision, reason code, reference IDs) | Review request titles, and the text of decision reasons |
| References to files handed over from or saved to the project library (file and version IDs, hash values, the name in the workspace), the authentication result when approved by replying to the mail, and resumed runs (the earlier state, the rounds before and after, the lane resumed) | The text of the reason for resuming |
| A verification hash for each record, and a hash of all the records exported | Information about files created or received (names in the library, locations, sizes and so on) |
| The workflow run's flow (the order of steps, Run at the same time, lanes, splits and joins, references to destinations), the rows for each step (placement, lane, round, state, reason, times), and the state of each lane | Step names, descriptions, instructions, lane names, display names of destinations |
| The review requests created from that run (state, decision, who decided, references to the chosen destination and the step sent back to) | (as “Review request titles, and the text of decision reasons” above) |
This is not the same as “Export CSV” on Records (audit trail). The CSV exports the project's records as a list (it also needs a reason).