/manage-agents page.
Six-step Agent Builder wizard
Navigate to/create-agent (or click Create Agent in the sidebar) to open the wizard. Progress through all six steps before deploying.
Step 1 — Identity: Choose a template or start from scratch
Give your agent a name (alphanumeric, hyphens, spaces; up to 64 characters) and select an agent type from the dropdown. Available types include: Shipment Risks, Freight Index, Diesel Price, Labor Strikes, Logistics Hiring, Border Wait Times, Port Congestion, and Carrier Closures.Add an optional description and tags to keep your agent library organized. The system auto-generates a unique Agent ID (
agt_xxxxxx) that you can reference in the run log.Alternatively, skip to Step 3 and select data sources directly to build from scratch.Step 2 — Behavior: Configure decision model and autonomous actions
Select a decision model: Heuristic (rule-based), ML (machine learning), or Hybrid. Set a confidence threshold (50–99%) that determines how certain the agent must be before firing an alert. Lower thresholds produce more alerts; higher thresholds produce fewer, higher-confidence ones.Toggle autonomous actions on or off. Available actions include: Auto-Reroute Shipments, Escalate to Manager, Recommend Carrier Switch, Rate Lock Advisory, and Inventory Buffer Alert. Agents with no actions enabled run in passive monitor mode—they still scan signals and generate the run log, but take no outbound action.
Step 3 — Data Sources: Select signals to monitor
Check each data feed you want the agent to poll. Available sources:
Select at least one source to pass validation. Selecting more sources increases the agent’s signal coverage and credit consumption per run.
| Source | What it covers |
|---|---|
| Freight Index API | Container, dry bulk, trucking, air, and rail indices |
| Diesel Prices (EIA) | Weekly regional US diesel pricing |
| Weather Disruptions | NOAA severe weather alerts |
| Port Congestion | Vessel queue, berth utilization, dwell times |
| Border Wait Times | CBP commercial crossing wait times |
| Labor Strikes | Active and upcoming labor actions |
| Political Disruptions | Sanctions and trade policy changes |
| Carrier Closures | Shutdown and seasonal closure calendars |
| Airspace Closures | FAA NOTAM and TFR data |
Step 4 — Schedule: Set monitoring frequency and send time
Configure when and how often the agent runs:
- Active Days: toggle individual days of the week (Mon–Sun)
- Polling Interval: every 5 min, 15 min, 30 min, 1 hour, 4 hours, or once daily
- Timezone: choose from US and Canadian time zones or UTC
- Active Hours (optional): restrict runs to a specific time window (e.g., 06:00–22:00)
Step 5 — Alerts: Define alert topics and conditions
Add one or more alert rules. Each rule specifies:
- Rule Name: a short label for the alert type
- Severity: Info, Warning, or Critical
- Condition: a natural-language or expression-style trigger (e.g.,
disruption_probability > 70%) - Recipient Emails: comma-separated list of addresses to notify
- Cooldown: minimum time between repeat alerts for the same rule (15 min, 30 min, 1 hour, or 2 hours)
Step 6 — Preview: Review and activate
The Preview step shows a configuration completion percentage and a validation checklist. All required fields must be green (✓) before you can deploy. Warnings (⚠) flag optional items like missing alert rules or no autonomous actions.Review the Agent Summary (name, type, decision model, data sources, schedule, alert rules), then click Deploy Agent to activate. Your agent appears immediately in the Your Custom Agents list below the wizard. Click Save Draft at any point to preserve your progress without activating.
Built-in agent templates
Chainomics ships six curated agents that are pre-configured and ready to run immediately from/manage-agents. These are distinct from custom agents you build in the wizard.
Daily Briefing Agent
Sends an AI-generated email brief covering the top critical logistics issues for the day. Draws from live freight signals across weather, ports, border waits, diesel, and more. Configure frequency, send time, and data sources to match your team’s morning workflow.
Shipment Disruption Agent
Monitors your shipment portfolio for high-risk disruptions and delayed deliveries. Fires an email alert when flagged shipments breach the configured risk threshold or carry a “Delayed” status. Configurable per risk level and maximum shipments per email.
Border Wait Times Agent
Monitors US-Mexico and US-Canada border crossings for delays, lane closures, and congestion. Alerts when commercial wait times at key crossings breach Critical thresholds. Configurable per crossing and severity level.
Port Congestion Agent
Tracks vessel queues, berth utilization, and dwell times across major North American ports. Flags congestion spikes that affect drayage and container availability. Outputs a port-level alert email when configured thresholds are breached.
Labor Strikes Agent
Monitors active, threatened, and negotiating labor actions across maritime, rail, and trucking sectors. Alerts on high-impact disruptions so you can pre-position inventory or arrange alternative routing before a stoppage takes effect.
Diesel Price Agent
Tracks regional diesel fuel prices across the US, Canada, and Mexico. Alerts on significant week-over-week price swings and emerging trends that affect fuel surcharge calculations.
Managing your agents
Navigate to/manage-agents to view, configure, and control all built-in agents from a single two-panel interface.
Left panel — agent list: All six built-in agents are listed with a status indicator: green (running), yellow (paused), or blue-pulsing (currently executing a run).
Right panel — agent detail: Selecting an agent shows:
- Agent name, type, and current status badge
- Current configuration (frequency, send time, max messages, state)
- Configure & Run button to open the agent’s settings dialog and trigger an immediate run
- Pause / Resume toggle to suspend scheduled runs without deleting the configuration
- Run History tab with a table of recent runs (date, status, alerts generated, sources scanned, tokens used)
- Active Alerts tab listing unread alerts from the most recent runs