Audit and Context

Audit and Context

Overview

Two features of iVendNext Copilot — the full audit trail and live context injection — operate quietly in the background of every conversation. Neither is visible as a button or setting in the chat interface, but both matter significantly for how Copilot behaves and how your organisation can account for what it does.


This article explains how the audit trail works, what it records, how to use it, and how live context injection primes Copilot with your current business state before you type your first message.




The Audit Trail

Every tool call that Copilot executes is logged as a record in iVendNext. The log entry captures:


  • Tool name — which of the 40+ tools was invoked

  • Input — the parameters that were assembled and passed to the tool

  • Output — the result returned by the tool

  • Execution status — whether the call succeeded, failed, or was blocked

  • Execution time — how long the tool call took to complete



Info
This log is created for every tool execution, without exception. It cannot be disabled by a user and does not depend on conversation history being retained. Even if the chat session is closed, the tool call records remain.




Why the Audit Trail Matters

AI-driven actions in a business system need to be traceable. If a draft Sales Order is created, a GL entry is queried, or a customer record is updated via Copilot, there should be a clear record of when it happened, what inputs were used, and what the outcome was.


The audit trail serves several purposes in practice:


Operations review. If a document was created with incorrect details, the audit log shows exactly what inputs Copilot received and what it returned. This makes it straightforward to determine whether the error was in the instruction given, the data available, or the tool's execution.


Compliance. Organisations subject to audit requirements — for data access, financial controls, or operational governance — can use the Copilot audit trail as evidence of how AI-assisted actions were performed. The log is queryable and retains full input/output detail, not just a summary.


Security investigation. If an unusual pattern of tool calls is suspected, the audit log provides a complete record of what was executed, by which user, with what parameters. Combined with the rate limiting and permission guard, this makes post-incident analysis straightforward.


Training and calibration. Over time, reviewing the audit trail helps identify common requests, frequent errors, or patterns where users are asking for things Copilot cannot handle well. This information can inform how Copilot is configured or how users are trained.




What the Audit Trail Does Not Capture

The audit trail records tool calls — the actions Copilot takes on your behalf. It does not record the full conversation transcript (the back-and-forth messages between you and Copilot). If a conversation produces five messages but only two of them trigger tool calls, the log will contain two entries.


This distinction matters for privacy: casual questions or clarifications that do not trigger tool execution are not logged as operational records.




Live Context Injection

Before you type your first message in any Copilot session, the system primes the AI model with a snapshot of your current iVendNext environment. This is called live context injection, and it happens automatically at the start of every conversation.


The injected context includes:


  • Company snapshot — your company name, base currency, and active fiscal year

  • Top customers — the customers with the highest recent transaction volume in your instance

  • Key items — items flagged for attention (for example, items with active reorder alerts or recently added items)

  • Overdue alerts — a summary of overdue documents across the system (overdue invoices, pending Purchase Orders, and similar)


This context is assembled from your live iVendNext data at the moment the conversation starts. It is not cached from a previous session, and it does not carry forward from one conversation to the next. Each session starts with a fresh snapshot.




Why Context Injection Matters

Without context injection, Copilot would need you to provide background in every conversation: which company you are working in, which customers are relevant, what the current state of the business looks like. This would make the experience slower and more error-prone — you would have to front-load every session with setup.



Quote
With context injection, Copilot already knows the shape of your current situation. When you ask "which of our top customers have overdue invoices?", it already has both the customer list and the overdue alerts. When you ask "what items should I be watching this week?", it has the reorder and attention flags.


Context injection also improves the accuracy of fuzzy matching. Because Copilot has a list of your top customers and key items in its context, it can make more confident matches when you refer to a customer or item by a partial name or abbreviation — the context narrows the candidate set before the matching algorithm runs.




Context Injection Is Not Memory

It is important to understand what live context injection is not. It is not a persistent memory of past conversations. Copilot does not remember what you asked last week, what documents you created last session, or any preferences you expressed in prior conversations.



Quote
Each conversation starts from the same baseline: the current state of your iVendNext data, injected fresh. There is no accumulated context across sessions, no user preference profile, and no history of past interactions carried forward.


This is by design. A persistent memory of past conversations would raise significant data governance questions — what is remembered, for how long, and who can see it. The live context model avoids these questions entirely by starting each session from a consistent, current, and auditable snapshot.




Using Context and Audit Together

The combination of live context and audit trail means that Copilot conversations are both informed and accountable. Context ensures responses are relevant to your current business state. The audit trail ensures that actions taken on the basis of those responses are recorded.



Quote

For a finance manager reviewing cash position, this means Copilot can answer questions grounded in today's GL data, and every query that ran to produce those answers is logged. For a purchasing manager acting on reorder alerts, it means Copilot already has the alert context, and every draft PO it creates is traceable.


Neither feature requires configuration by the end user. Both are active for every Copilot session, for every user, from the first conversation.




    • Related Articles

    • Security & Audit

      Overview When an AI assistant is given access to live business data, the natural question for any responsible organisation is: how is that access controlled, and what oversight exists? iVendNext AI Gateway is designed with two principles at its core ...
    • Setup and Audit

      Getting Mexico Localization Ready for Live Operations Before any CFDI can be generated, iVendNext needs to know how to reach FacturaAPI — the SAT-authorised PAC that handles all CFDI stamping. This is handled through a single configuration record in ...
    • Reason Code Master: Tracking POS Activities with Accountability

      Overview This article guides you through setting up, implementing, and using Reason Codes effectively to maintain transparency and accountability for Point of Sale (POS) activities. 1. What Are Reason Codes? Reason Codes are predefined labels ...
    • iVendNext AI Copilot - Appendix

      Limits, defaults & glossary Default limits at a glance Setting Default Notes Requests per minute, per user 10 Configurable by administrator Requests per day, per user 200 Configurable by administrator Actions per question 15 Multi-step questions may ...
    • iVendNext AI Copilot - Objection handling

      Cross-questions, answered The questions you will hear in the room, with answers grounded in how Copilot actually works. Can it see salaries, or data my staff should not see? No. Copilot can only access what the signed-in user is already permitted to ...