NYDFS Part 500 Audit Trail Requirements for CrewAI Crews: What to Log per Task and Tool Call
Part 500 does not prescribe fields for agent records. Section 500.6 requires audit trails designed to detect and respond to material cybersecurity events, and access privilege duties require you to show who or what could reach nonpublic information. For a CrewAI crew, that means recording, for every task and every tool call, the acting identity, the request, the policy that applied, the decision, the outcome, a timestamp and the retention class. Treat that field list as a design specification, and capture it in the execution path so the record shows what an agent was permitted to do, not only what it did.
Where to place capture and enforcement: evaluation criteria
- Can an agent or a prompt bypass the capture point, or does every tool call pass through it?
- Is the policy decision recorded at call time, with the policy version, rather than inferred later?
- Does the record cover blocked, redacted and escalated calls, not only successful ones?
- Can sensitive inputs and outputs be protected inside the record, with restricted access to the unredacted values?
- Can you retain and retrieve records for at least five years where they support the annual compliance notification, and produce them to DFS on request?
- Can it run in your own cloud, with retention and data residency you configure?
What Part 500 asks of agent-generated records
Start with applicability. Which Part 500 sections apply depends on whether the entity qualifies for a 500.19 exemption or is a Class A company, so confirm that before fixing log scope. Where 500.6 applies, it requires audit trails designed to detect and respond to cybersecurity events with a reasonable likelihood of materially harming a material part of normal operations. The text points to a purpose, detection and response, rather than a field list.
Three adjacent obligations shape what an agent record must show. Covered Entities must review access privileges at least annually so each Authorized User has access only to the nonpublic information needed for the job, and that review extends to third-party service providers. They must notify the superintendent no later than 72 hours after determining a cybersecurity incident has occurred, including at a third-party service provider. And records supporting the annual compliance notification must be kept for 5 years and produced to DFS on request.
DFS's AI industry letter states that it imposes no new requirements beyond Part 500 and explains how to apply the existing framework to AI risk. Agent evidence should therefore be tied to these existing provisions, not to claimed AI-specific rules. As of November 2026, the field-level detail below is engineering judgment applied to those provisions.
Mapping Part 500 expectations to CrewAI constructs
CrewAI organizes work into crews, agents, tasks and tools. Each level answers a different examiner question, so each needs its own record. The mapping below is an inference from the regulatory text, not language DFS has published for multi-agent systems.
- Crew: Defines the workflow boundary. Record the crew definition, version and the agents and tools it was permitted to use. This supports the access privilege inventory.
- Agent: Acts under a role. Give each agent an attributable identity with enumerable permissions, so an annual review has something concrete to examine.
- Task: Unit of delegated work. Record the assigned agent, the input context and the output, so a reviewer can reconstruct what was asked and produced.
- Tool call: Where the agent touches systems and data. This is the main audit trail event: it carries the policy decision and the outcome.
- External tool or service: Mark calls that reach third-party services as third-party interactions, since provider assessments and incident notice cover them.
Minimum field set per task and per tool call
For each task, capture a crew identifier and version, the task identifier, the assigned agent role, the input context handed to it, the final output, start and end timestamps, and any error or escalation state. Link each task record to the tool calls made during it with a shared identifier. That linkage is within one task, not a trace of an entire workflow.
The tool call is where evidence is won or lost. The proposed minimum is below. These fields are a design specification chosen to make a record reconstructable, not a quotation from Part 500.
- Acting identity: Crew, agent role and the credential or service identity used, so the actor is attributable and its permissions can be listed.
- Request: Tool name, target system and arguments. Redact or tokenize nonpublic information while keeping the record meaningful.
- Policy applied: Policy identifier and version in force at the moment of the call, not reconstructed later.
- Decision: Allowed, redacted, blocked or escalated, with the approver and approval time for escalations.
- Outcome: Response summary or reference, error codes, and whether data was returned to the agent.
- Time and retention: Synchronized timestamp and the retention class, so records can be kept and produced on schedule.
Application logs versus policy-enforced evidence
A standard application log records that a function ran. It rarely records which permission allowed it, which policy was evaluated, or what would have happened had the call been disallowed. An examiner asking what the agent was allowed to do cannot be answered from output text and stack traces, and answering by inference after the fact is weak.
Evidence produced at the point of enforcement differs in kind. The decision and the record come from the same event, so the record states the policy and its result as they occurred. Blocked and escalated calls are preserved too, and those are often the entries a detection and response process cares about most. Logs reviewed after the fact can still add value for analysis, but they describe behavior; they do not establish authorization.
This distinction matters for model risk management as well. A team that can show the policy governing each tool call, and the decision taken, can discuss agent behavior in terms of controls rather than reconstructed narrative.
Retention, integrity and where Trussed fits
Set retention from the entity's applicable sections. Records supporting the annual certification or acknowledgment carry a 5-year baseline, and agent evidence that supports that notification should be treated the same way. Own the retrieval path as well as the storage: someone should be able to produce a task and its tool calls on request, and that should be tested before an examination.
Integrity controls such as append-only storage, hashing, restricted write and read access, and clock synchronization are design choices that make a record defensible. They are not stated Part 500 requirements, so document why you chose them. Apply the same care to nonpublic information inside the record, since an audit store full of unredacted inputs becomes a data risk in its own right. Records should also be usable for incident determination, because the 72-hour notice clock runs from the point you determine an incident occurred, including one at a third-party provider.
Trussed enforces policy in the execution path on individual interactions and tool calls, with allow, redact, block, rate limit and escalate for human approval. That enforcement generates audit-ready evidence mapped to NYDFS, and it deploys self-managed in the customer cloud with configurable retention and data residency. Trussed is in continuous production in a regulated enterprise, and insurance is where it is deepest. It does not trace whole agentic workflows or govern at the level of business transactions. It is one way to meet the criteria above, and the schema works regardless of tooling.
Evidence captured per tool call
Identity
Crew, agent role and credential that acted
Request
Tool name and arguments, with sensitive values protected
Policy decision
Policy version applied and result: allow, redact, block or escalate
Outcome
What was returned, errors, and approval details if escalated
Time and retention
Timestamp and the retention class assigned to the record
Review your CrewAI evidence design
Walk through your crews, tasks and tool calls with us and see how policy enforced in the execution path produces audit-ready evidence.
Explore Agent and Tool-Call EnforcementHow does your AI governance program compare?
See where your program has gaps in less than 2 minutes.