DF Support DF Support

DFleet 3.2 AGV Configuration

5 min read · General

AGVs Page Overview

Navigate to Settings > AGVs to view and manage all connected AMRs. The AGVs page displays a table with the following columns for each registered AMR.

ColumnDescription
DFleet EndpointThe network endpoint address used to communicate with DFleet
NameThe assigned name of the AMR
HomeThe designated home station for the AMR
PriorityThe priority ranking used in AGV assignment policies
SkillsetIcons representing the AMR's capabilities (icons vary by AMR model)
ActiveWhether the AMR is currently active and available for task assignment
Last SeenTimestamp of the most recent communication from the AMR
OperationAction buttons for edit, swap, and delete operations

Applying AMR Skillset

By default, the skillset for each AMR is applied automatically when the AMR connects to DFleet. The active skillsets for a selected AMR are displayed in the bottom-left area of the AGVs page.

If the AMR skillset changes (for example, after a firmware update or hardware modification), you must manually update it in DFleet by clicking the hand icon in the Skillset column for that AMR.

AGV Assignment Policy

The AGV Assignment Policy is located at the bottom of the AMR list on the AGVs page. It determines how DFleet selects which AMR to assign when a task is created. You can enable or disable individual criteria and reorder them by drag and drop to set their priority.

CriteriaSorting Options
Recently UsedLeast Recently Used / Most Recently Used
Battery PercentageHighest First / Lowest First
Task CounterHighest First / Lowest First
Task Specific AGV PriorityN/A (uses per-task AGV priority settings)
Universal AGV PriorityN/A (uses the Priority value from AGV configuration)
Travel DistanceShortest First / Longest First
MileageLowest First / Highest First

For each criterion that supports sorting, you can configure whether it sorts from highest to lowest or vice versa. A configurable tolerance value is also available, which determines the margin within which two AMRs are considered equal for that criterion before falling through to the next one.

Pairing with AMR

To pair an AMR with DFleet, follow these steps to establish the connection between the AMR's onboard controller and the DFleet server.

  1. Log in to DFleet as a user with Supervisor privileges.
  2. Navigate to the AGVs tab under Settings.
  3. Copy the DFleet Endpoint URL displayed at the top of the page.
  4. Log in to the AGV's onboard interface (the AMR controller UI).
  5. Change the executor mode from Standalone to DFleet.
  6. Paste the DFleet Endpoint URL into the endpoint configuration field.
  7. Ensure the AMR is set to Activated mode.
  8. Back in DFleet, click the Edit button (pencil icon) for the AMR entry and change its status to Active.
  9. Perform a soft-reboot on both the AMR and DFleet to finalize the pairing.

AGV Configuration Page

Each connected AMR has its own dedicated configuration page, accessible by clicking the Edit (pencil icon) button in the Operations column. The configuration page is divided into General Settings and Dimension Profiles.

General Settings include the following options:

SettingDescription
AGV HomeDefine the home station that the AMR returns to when idle or when a return-home task is triggered
PrioritySet the priority ranking for this AMR, used by the Universal AGV Priority assignment policy
ActiveEnable or disable the pairing between this AMR and DFleet. Inactive AMRs are not assigned tasks
Minimum Battery LevelSet the minimum battery percentage. DFleet will not assign tasks to this AMR when its battery is below this threshold

Dimension Profiles allow you to configure the SVG representation for the AMR body and its payload. You can define up to 5 payload profiles per AMR, each with its own dimensions and shape. Use the "Select Dimension Profile" task action to switch between payload profiles during task execution.

Executor Settings

Executor Settings control the runtime behavior of each AMR, including which motions are permitted, automated task triggers, and initialization behavior.

Allowed Motions lets you enable or disable specific motions for the AMR. When a motion is disabled, DFleet's traffic controllers will plan paths that avoid requiring the restricted motion.

Task Triggers automate task assignment based on AMR state changes. Two trigger types are available:

AGV Idle Trigger — Automatically assigns an idle task to the AMR after a configurable timeout period. The following skip conditions can be enabled:

OptionDescription
Auto-abort when new task availableCancel the idle task if a higher-priority task becomes available
Skip if chargingDo not trigger the idle task if the AMR is currently charging
Skip if at homeDo not trigger if the AMR is already at its home station
Skip if at stationDo not trigger if the AMR is at any station
Skip if battery below minimumDo not trigger if battery is below the configured minimum level
Skip if trigger already ranDo not trigger again if the idle trigger has already fired since the last task completion

Battery Low Trigger — Automatically assigns a battery-low task (typically a charge task) when the AMR's battery drops below a configurable threshold. The same skip conditions as the AGV Idle trigger are available.

Initialization Task Template allows you to select one or more task templates that will be available for AMR initialization in the task runner. These templates run when the AMR first connects or is re-initialized.

Default Initialization enables auto-execution of the selected initialization task template after a configurable countdown timeout, without requiring manual confirmation.

Default App starts a default application automatically after the AMR controller starts, removing the need for an operator to manually launch it.

Default to Starting Task Runner in Paused State — When enabled, the task runner starts in a paused state, requiring manual resumption before the AMR will accept and execute tasks. This is useful for safety checks or supervised startup procedures.

Was this article helpful?

Still stuck? How can we help?

Reach out to our support team on WhatsApp for personalized assistance.

Chat with us on WhatsApp

Updated on August 26, 2026