Skip to content
AletheIA Docs
Esc
navigateopen⌘Jpreview
On this page

Agent Action Audit Record

Posture: docs_first, advisory_first. Describes a record’s required fields; implements no runtime, logger, or storage. Provider-agnostic.

Goal

Define the minimum record that proves what happened when an agent took (or was denied) an action: which skill, which task, which tool, what risk, which verdict, what evidence, and whether a human approved. “Audit proves” — without this record, a permission decision is just a claim.

Minimum record

agent_action_audit_record:
  task_id:
  agent_id:
  skill_id:
  autonomy_level:        # observe | advise | act_with_approval | autonomous_within_bounds
  tool_name:
  action_type:
  risk_class:            # coarse (low|medium|high|critical) or authoritative class
  policy_version:
  policy_verdict:        # allow | deny | require_approval | transform | log_only
  approval_required:
  approval_by:
  evidence_refs:
  knowledge_packs_used:
  restrictions_applied:
  timestamp:
  result_summary:

This is the minimum for declaration and review. It is not a new logging system.

Reconciliation with existing observability

The runtime harness already defines a per-event and per-action record:

This audit record is a skill-and-policy-oriented view over those: it names the fields a reviewer needs to connect skill → tool → verdict → evidence → approval. When emitting real traces, populate the governance record/schema; this document says which of those fields are non-negotiable for audit of a skill-driven action. Where they overlap, the governance record schema is authoritative for structure.

Non-negotiable fields

At minimum, a recorded action must carry: skill_id, task_id, tool_name, policy_verdict, evidence_refs, and — when the verdict was require_approvalapproval_by.

See also

Was this page helpful?