Spaces

Do and do not guide for your agent: port and marine services

This guide gives port and marine service owners a plain list of what an AI agent should and should not do in trucker and vessel agent chats. Each rule is short enough to copy into your own agent instructions.

Runs in your browser. Nothing you enter is sent anywhere or saved.

Before you start

Port staff know the rules by heart: do not guess a berth time, do not wave a truck through, do not talk about hazards on the phone. An AI agent has to be told those rules in plain words. This guide gives you a starting set written for the quay, the gate and the pilot station.

Read each line and change the words to match how your port works. Then give the final list to whoever sets up your agent, and keep a copy at the operations desk. Review it whenever a rule changes, a new service starts or a mistake is found.

Tick each one as you go. 0 of 10 done.

[ ] Do ask for the container number, vessel name or booking reference before answering a status question.
[ ] Don't promise a berth time, pilot slot, release or gate appointment that the planner has not confirmed.
[ ] Do give gate hours, cut-offs and document lists exactly as you wrote them.
[ ] Don't give advice on dangerous goods, spills, fires or vessel safety. Pass it to the duty officer.
[ ] Don't explain why a container is on a customs hold. Say the customs desk will contact them.
[ ] Do tell the sender who will reply and roughly when, every time a chat is handed over.
[ ] Don't share one customer cargo, consignee or vessel movement details with another party.
[ ] Don't argue about demurrage, detention or damage claims. Record the facts and pass it on.
[ ] Do keep replies short, calm and in plain words, even when the sender is angry.
[ ] Do say so honestly when you do not know, and hand the chat to a person.

Turn rules into examples

Rules work better with a sample line beside them. Beside the berth rule, add: I cannot confirm the berth time yet, our planner will update you here by two. Beside the hazard rule, add: I have passed this to our duty officer now.

Short examples teach the agent the tone you want. They also help new staff. A clerk joining the night shift can read the same page and answer in the same voice.

Add your own rules

Every port has local customs that deserve a line. Think about these.

  • Rules about which language to use with regular hauliers.
  • How to address a vessel master compared with a shipping line clerk.
  • What to say when a crane or weighbridge is out of order.
  • Which messages must be copied to the harbour master.

FAQ

How many rules should I give the agent?

A dozen clear rules beat fifty vague ones. Start with the ten that protect safety, money and trust, then add a new rule each time you find a real mistake in a chat.

Should the rules be different for truckers and vessel agents?

Often yes. Truckers need short answers about gates and documents. Agents expect more exact detail about berths and notice times. Write a small section for each group.

Can the agent break a rule if the sender insists?

No. Tell it that pressure, urgency or a threat is a reason to hand over to a person, not a reason to bend. People at the gate often push, and the rule must hold.

More free tools for ports, stevedores and marine services

Read the guide: Answer trucker and vessel agent messages at the port.