An AI Freight Analyst with 16 Tools

Zorost Intelligence — Tue, 11 Nov 2025 09:00:00 +0000

Pull-quote: “The AI analyst is not a chatbot bolted on the side. It is the center of the platform.”

Why this matters

Most freight intelligence platforms have followed the same pattern with generative AI: keep the existing dashboards, add a chatbot in the corner, ship a press release. The chatbot answers FAQ-class questions and sometimes summarizes a dashboard. Senior freight analysts ignore it.

FreightCortex is built around the AI analyst, not the other way around. The analyst is a multi-tool agent with sixteen callable tools that can pull data, run statistical tests, run simulations, and produce structured outputs. It is more like a junior analyst with access to the full platform than like a chatbot.

The 16 tools

#	Tool	What it does
1	`query_corridor_metrics`	Lane-level KPIs (cost, transit time, capacity, on-time %)
2	`query_carrier_metrics`	Carrier-level KPIs and ranking
3	`query_origin_destination_flows`	OD-pair flows with filters
4	`compute_anomaly_score`	Z-score / isolation forest / CUSUM on a metric series
5	`run_capacity_simulation`	What-if capacity reduction or expansion
6	`run_demand_simulation`	What-if demand shock scenarios
7	`run_disruption_simulation`	What-if disruption (port closure, weather, strike)
8	`run_routing_simulation`	Reroute optimization under constraints
9	`run_modal_shift_simulation`	Mode-shift impact (truck ↔ rail ↔ intermodal)
10	`run_emissions_simulation`	CO₂ impact under scenarios
11	`run_network_stress_test`	Network-wide stress scenarios
12	`compute_shortest_path`	Multi-modal shortest path
13	`compute_betweenness`	Node centrality
14	`compute_communities`	Network communities
15	`generate_report`	Compose structured report from analytical session
16	`generate_chart`	Render a specific chart type with provided data

Each tool is a typed contract: inputs, outputs, and side effects are documented. Every call is logged with the requesting question, the parameters, the result, and timestamps.

Why typed tools matter

The single most important architectural decision in agent design is whether your tools have contracts. Untyped tools — give the model a vague description and let it improvise — are unreliable. Typed tools — with explicit input schemas, output schemas, and validation — are reliable.

FreightCortex’s analyst will not call a tool with an invalid input. The schema rejects the call before it reaches the data layer. That eliminates an entire class of failure that plagues unconstrained agents.

What this lets analysts do

A typical session: an analyst asks “what’s driving the cost increase on the Atlanta-Dallas corridor over the last quarter?” The analyst:

Calls query_corridor_metrics for Atlanta-Dallas with a 90-day window
Calls compute_anomaly_score on the cost series
Calls query_carrier_metrics to see which carriers’ rates moved
Calls run_capacity_simulation to test whether the increase tracks capacity changes
Generates a structured report with charts

This is fifteen minutes of senior-analyst work. With FreightCortex, it is one question and a structured answer with citations.

Closing

A chatbot bolted on a dashboard is a feature. An AI analyst at the center of the platform is a product. The difference shows up the moment senior analysts compare them in real engagements.