---
title: "Qargo Intelligence: Assign fields tasks — what, why & how"
description: "Qi Assign fields tasks check a plain-language condition and, when it is met, automatically fill in fields on orders, loads, or stops."
url: https://help.qargo.com/us/articles/843273-qargo-intelligence-assign-fields-tasks-what-why-how
locale: us
updated: 2026-09-23
---

# Qargo Intelligence: Assign fields tasks — what, why & how

## Summary {#h_99c2290a02}

-   **What is it?**

    -   A new type of **Qi task** called **Assign fields**.
    -   When the task runs, it checks a condition. If the condition is met, it writes a value into one or more fields in Qargo.
    -   The rule is set up by describing it in plain language to a _chat agent_. No technical knowledge is needed.
-   **Why use it?**

    -   Standard Qi validation tasks can only add a _tag_. Many tags on one order or load make the overview hard to read, and a tag cannot hold a value.
    -   An Assign fields task stores a real value, such as a container no. or a booking instruction, in a field that can be shown in overviews, on documents, or in the customer portal.
-   **How does it work?**

    -   The task is created under **Configuration > Tasks** like any other task.
    -   The chat agent turns the description into a rule, which can be checked against a real order or load before saving.
    -   The value can be fixed (for example "BOOK TIMESLOT") or derived from current data (for example "the next Monday from today").
    -   The rule can overwrite an existing value or only fill the field when it is empty.

## Prerequisites {#h_32d62ed6c1}

-   _Qargo Intelligence (Qi)_ must be enabled for the tenant.
-   _Super Admin_ or _Admin_ permissions to configure tasks.
-   Any custom field the task should fill in must already exist.
-   Familiarity with tasks is helpful. See [Tasks – what, why & how?](https://help.qargo.com/us/articles/246335-tasks-what-why-how) and [Qi – validation tasks](https://help.qargo.com/us/articles/413235-qi-validation-tasks).

:::callout{tone="info"}
💬 Qargo Intelligence is an add-on. Contact the Qargo account manager if the **Qi task** option is not visible.
:::

## Use cases {#h_7933c0d3b0}

-   **Show the container or trailer number to customers:** when a resource is assigned to a load, write the container or trailer number into a custom field that is visible in the customer portal.
-   **Set booking instructions automatically:** set a dropdown field to "BOOK TIMESLOT" when a time slot time window has been selected.
-   **Replace tags with one clear value:** instead of several Qi tags stacking up on a load, store the outcome in a single field that is easy to read and filter on.
-   **Flag special goods:** set a field when the goods on an order meet a condition, such as specific UN numbers, so it stands out to planners.

## Terminology {#h_b1905a8163}

| Term | Definition |
| --- | --- |
| _Qi task_ | A task that uses Qargo Intelligence (AI) to check or update data automatically. |
| _Assign fields_ | The Qi task type that writes values into fields, instead of only adding a tag. |
| _Chat agent_ | The AI assistant in the task modal that turns a plain-language description into a rule. |
| _Condition_ | The check the rule makes first. Fields are only filled in when the condition is met. |
| _Static value_ | A fixed value that is always the same, for example "BOOK TIMESLOT". |
| _Derived value_ | A value derived from current data, for example a container no. or a calculated date. |
| _Humanized / Technical_ | Two views of the same rule: plain English, or the underlying expression the system runs. |
| _Validate_ | A check of the draft rule against one real order or load, showing what would change. |

* * *

## Creating an Assign fields task {#h_f6ace78c37}

### Open a new Qi task {#h_1445e6970d}

1.  **Navigate** to **Configuration > Tasks**.
2.  **Select** the object the task belongs to, for example **Orders** or **Loads**.
3.  **Click** **Add** to open the new task modal.
4.  **Select** **Qi task** as the **Task type**.
5.  **Confirm** that the **Assign fields** type is selected. The _chat agent_ panel opens.

:::callout{tone="info"}
📚 Selecting a different Qi task version closes the chat agent and returns to the standard tag-based Qi task.
:::

![](https://help.qargo.com/media/f2ef15f8daf4-image.png)

### Describe the rule {#h_1b3360ed8f}

1.  **Describe** the rule in the chat panel in plain language. Include the condition and the field and value to set, for example: _"When a container is assigned, set the Container no. custom field on the order to the container no."_

    ![](https://help.qargo.com/media/b1f4bbd3a2f2-image.png)

2.  **Answer** any follow-up questions from the chat agent. It guides the description until the rule is clear.

    ![](https://help.qargo.com/media/c39011f8a833-image.png)

3.  **Review** the rule in plain language, using the **Humanized** view. Switch to **Technical** to see the underlying expression if needed.

    ![](https://help.qargo.com/media/e27bd60d1f3d-image.png)

4.  **Choose** whether the value may overwrite an existing value, or should only be written when the field is empty.

:::callout{tone="info"}
📚 Use the exact name of the field to fill in, and of the field to read from. Similar fields (for example a resource's display name and its container no. field) can hold different data.
:::

### Validate the rule {#h_8bb194fb55}

1.  **Click** **Validate**. A search box opens.
2.  **Select** one order or load to test against. Only one record can be validated at a time.
3.  **Review** the result:

    -   **Rule applies**: the condition is met, and the fields are shown with their values before and after.
    -   **Rule doesn't apply**: the condition is not met for this record, so nothing would change.
4.  **Refine** the description in the chat and validate again until the result is correct.

![](https://help.qargo.com/media/ac37c0a62328-image.png)

![](https://help.qargo.com/media/ab89acec6632-image.png)

:::callout{tone="note"}
‼️ The rule is generated by AI and can be wrong even when it looks right. **Validate against several records**, including ones where the rule should not apply, before
:::

### Save the rule and the task {#h_30f4d84af5}

1.  **Click** **Save rule** in the chat panel. The chat closes and the modal shows an overview of the configured rule.

    ![](https://help.qargo.com/media/03862c1e2ede-image.png)

2.  **Complete** the remaining task settings, such as the name and when the task should run in the workflow.
3.  **Save** the task. It appears on the task page with its rule.

![](https://help.qargo.com/media/6048104cb83c-image.png)

![](https://help.qargo.com/media/6ae64e32a4b4-image.png)

:::callout{tone="info"}
🧰 **_Save rule_** must be clicked in the chat panel before the task itself is saved.
:::

### Edit an existing rule {#h_61113eeda0}

1.  **Open** the task on the task page and click **Edit**.
2.  **Update** the rule through the chat agent, which opens again for changes.
3.  **Validate** and **save rule** again before saving the task.

* * *

## What happens when the task runs {#h_0916e756a5}

-   The task runs at the point in the workflow it is scheduled for.
-   The condition is checked using data from orders, shipments, loads, and stops.
-   When the condition is met, the value is written to the chosen field(s). The field then shows on the order, load, or stop like any manually entered value and stays editable.
-   A field that is already shown in the customer portal also shows the new value there. No extra setup is needed.

:::callout{tone="note"}
‼️ Like all tasks, **_Assign fields tasks_** do not re-run automatically when data changes later. If the source data changes, the task must be run again to update the field.
:::

## Limitations {#h_e5810a9bac}

-   **No automatic re-run:** the task does not re-run when the input data is updated.
-   **Supported objects:** conditions use order, shipment, load, and stop data. Invoice and credit memo tasks cannot use the **Assign fields** type.
-   **Not yet supported as targets:** time windows, vehicle categories, stop extras, freight extras, and incidents. These are planned for a future release.
-   **Early stage:** the feature is new and still being improved. Feedback on the chat agent and setup screens is welcome through the Qargo account manager.


## Troubleshooting {#h_596f5148da}

| Issue | Cause / resolution |
| --- | --- |
| Saving the task shows an error with no description. | The rule was not saved in the chat panel. Click **Save rule** in the chat first, then save the task. |
| The chat panel keeps loading and never finishes. | Refresh the page and try again. If it keeps happening, create the task again and contact Qargo Support. |
| The task ran but no field was filled in. | The condition was not met, or the rule reads the wrong data. Use **Validate** on the same record to see whether the rule applies, and refine the description. |
| The wrong value was written (for example a reference number instead of a container no.). | The chat agent picked a similar field. Name the exact source field in the description, check the **Humanized** view, and validate again. |
| An existing value was not replaced. | The rule is set to only fill empty fields. Edit the rule and allow it to overwrite existing values. |
| The field shows an old value after a trailer or container was changed. | Tasks do not re-run automatically. Run the task again on the order or load. |
| **Assign fields** is not available. | Qi is not enabled for the tenant, or the task object does not support it (for example invoices). Contact the Qargo account manager about Qi. |


## Related articles

- [Configuration – Chat-based validation rules for order capture](https://help.qargo.com/us/articles/709425-configuration-chat-based-validation-rules-for-order-capture.md)
- [Video: Chat-based validation rules (Qargo Intelligence)](https://help.qargo.com/us/articles/709280-video-chat-based-validation-rules-qargo-intelligence.md)
- [Qargo Intelligence (Qi): order scanning](https://help.qargo.com/us/articles/864323-qargo-intelligence-qi-order-scanning.md)
- [Configuration - Use rules to auto-assign fields.](https://help.qargo.com/us/articles/545498-configuration-use-rules-to-auto-assign-fields.md)
- [Qargo Intelligence chat agent: what it is and when to use it](https://help.qargo.com/us/articles/626078-qargo-intelligence-chat-agent-what-it-is-and-when-to-use-it.md)
