AI agent for logistics coordinators
Detention and Demurrage Watch Agent
No container or trailer incurs avoidable detention or demurrage and every charge has a recorded cause
What it does
Containers and trailers sit past free time and the charge only appears on the invoice. Every day this agent tracks each container and trailer's free time against arrival and pickup status. It flags those near the limit and proposes the fix, such as booking pickup, asking the carrier for an extension, or arranging a return. After each action, it rechecks the status to see if the clock has stopped. If a charge still occurs, it logs the cause so the pattern can be fixed. The coordinator approves bookings and any dispute. Edge case: the port is closed for a holiday, so the agent asks for a free time extension instead of a pickup booking.
How it works
Follow the arrows from top to bottom. The orange dashed arrow is the loop: when a check fails, the agent goes back and tries again.
Read the steps as a list
- Daily free time scan runs
- Pull arrival dates, free time and current status
- Calculate days left for each unit
- Is any unit within the warning window?If not: leave it on the watch list and recheck tomorrow. Back to step 2.
- Propose a fix: pickup booking, extension or return
- Coordinator approves bookings and any extension requestThe agent waits here for your OK.
- Send the booking or request
- Recheck status after the action
- Has the clock stopped or the unit moved?If not: try the next fix and notify the coordinator. Back to step 4.
- Log the cause of any charge that still occurred
- Daily watch list updated
How it decides
A unit is at risk when remaining free time is below the time needed to pick up and return it. The proposed fix is the one that stops the clock soonest at the lowest cost.
- Warn when 2 days of free time remain
- Request an extension when pickup is not possible before expiry
- Prefer a return booking when empties are due
- Log a cause for every charge
Make it yours
Every agent is a starting point. You choose these settings for your own situation.
- Warning window (default 2 days)
- Carriers and ports covered
- Cost per day
- Where cause codes are logged
What keeps you in control
It always asks you first
- Bookings
- Extension requests
- Disputes
Hard limits
- Never pay or dispute a charge without approval
- Never book without approval
It stops when
- Done: all units cleared or charges explained
- Stop: terms are missing for a unit
Set it up
We guide you through the set-up, step by step
Members get the full set-up guide for this agent. No technical skills needed: you copy, paste and upload.
- One set of instructions to paste into your AI, with the clicks for ChatGPT, Claude, Microsoft 365 Copilot, Gemini and Grok
- The agent then walks you through connecting your own data, one source at a time
- A downloadable copy with the flow chart, the rules and the full guide