Shipment Exception Agent
Finds the shipments that matter, not the ones that are merely late
- 7hard rules
- Things it must never do, enforced in every run
- 5handover rules
- Conditions where it stops and gives the work to a person
- 7output fields
- A structured result, not a paragraph you have to re-read
- ≤5steps per run
- Bounded work: at most 4 tool calls, enforced by the runtime
Read-only by design. This agent has no path to sending, spending, publishing or committing anything. Where that limit is the product, removing it would remove the reason to trust the output.
Overview
A tracking dashboard tells you status. A logistics team does not need status — it needs to know which fifteen of nine hundred shipments will hurt, and to tell someone before the customer notices.
This agent reads your shipment data and ranks exceptions by consequence, not by lateness. A two-day slip on stock replenishment is noise; two hours on a time-critical delivery is not, and a dashboard sorted by delay shows them the same way.
For each exception it says what is known, what the carrier has actually committed to, and what follow-up would resolve it. It drafts the customer message where one is warranted — stating what happened and what you are doing, never inventing a new arrival date. A promised date nobody committed to is how one late delivery becomes a lost account.
Benefits
The real exceptions, first
Attention spent where a delay actually costs something.
Customers told before they ask
The difference between an apology and a complaint.
No promises you cannot keep
It will not invent a date to make a message sound better.
What it does
Ranks by consequence
What a delay costs, not how long it is. A dashboard sorted by lateness hides the ones that matter.
Separates committed from estimated
What the carrier actually committed to, and what is a projection. They are treated very differently.
Spots the silent shipment
No scan for three days is often worse news than a reported delay, and no dashboard flags it.
Drafts the customer message
What happened and what you are doing — with no invented arrival date.
Names the follow-up
Which carrier, what to ask, what reference to quote.
Sends nothing
Drafts for a person to send. It contacts no customer and no carrier.
What this changes
What this changes about your week
- It takes over
- Finding the fifteen shipments out of nine hundred that will actually hurt.
- Done today by
- A coordinator, every morning, in a tracking dashboard.
- How often
- Daily.
- Typical manual effort
- Triaging a day's exceptions properly is two hours.
Why Logistics & Supply Chain in particular. It ranks by consequence rather than lateness, and it will not invent a delivery date — a promise nobody made is how one late shipment becomes a lost account.
Runs unattended
Started by you or by an event, and it finishes on its own. Nothing waits for someone to be at a desk.
The same standard every time
The two-hundredth item is held to the bar the first one was. Consistency is the part people cannot sustain.
It cannot act on its own
Shipment Exception Agent has no path to sending, spending or committing. That limit is why its output is safe to act on.
How it runs
This agent runs server-side through the PROMIVO runtime. Each run is logged step by step and every tool call is permission-checked before it executes.
- 1InputValidated against the agent input schema
- 2Modelclaude-sonnet-5 with automatic fallback
- 3Toolsextract_structured_data
- 4PermissionsRuns READ actions automatically; anything higher waits for approval
- 5OutputStructured result matching the output schema
- 6LoggingTokens, duration and every step recorded
Demo
Demo dataIllustrative sample output, abridged.
Input
{
"shipments": [
{
"carrier": "Regional Freight",
"reference": "SHP-8842",
"timeCritical": true
}
]
}Output
{
"escalate": true,
"disclaimer": "Dates are only those a carrier has actually given, attributed to that carrier. No delivery date has been estimated, no cause has been assigned that the tracking data does not record, and no customer or carrier has been contacted.",
"exceptions": [
{
"why": "Time-critical, and two days past the promised date with a customs hold recorded.",
"known": "Held at customs since Tuesday. Carrier recorded 'documentation query'.",
"unknown": "Which document. The carrier has not said, and no new date has been given.",
"followUp": "Ask Regional Freight which document is queried, quoting SHP-8842. Ask for a released-by date.",
"reference": "SHP-8842",
"consequenceRank": 1,
"carrierCommitted": "None. The carrier has committed to no revised date.",
"draftCustomerMessage": "Your order is held at customs over a documentation query. We are working with the carrier to identify what is needed and will update you as soon as we know more. We do not yet have a revised delivery date and would rather tell you that than guess."
}
],
"silentShipments": [
"SHP-8790 — no tracking event for 4 days."
],
"escalationReason": "A time-critical shipment is held at customs with no revised date."
}Requirements
Integrations
No integrations required.
Before you start
- Shipment records with promised dates
- Tracking events, where available
- Requires the All-Access plan or higher
Use cases
Morning exception review
Nine hundred shipments down to the fifteen that need action.
A late high-value order
What is known, what to ask the carrier, what to tell the customer.
Carrier performance
Which lanes and carriers generate the exceptions.
Pricing
All-Access
Billed monthly through your PROMIVO subscription. Cancel at any time.
Runs consume your plan allowance for agent executions and tokens. See plan limits
FAQ
Does it contact carriers or customers?
No. It drafts, ranks and explains. Sending on your behalf means committing your business to something, which stays with a person.
Will it estimate a new delivery date?
Only where the carrier has given one, and it will say that is the carrier's estimate. It will not produce a date of its own — an invented date is how one late delivery becomes a lost account.
What data does it need?
Whatever you have: shipment records, tracking events, promised dates. It works with partial data and says what it could not assess.
Reviews
Reviews open once customers have run this agent.
Need this agent to work differently?
Tell us what to change and our team will scope a customised version for your business.
Customize this agent