Amend Entities

Back to NLP Topics Amend Entity lets users change entity values during task execution. Example: a user books a flight and then changes the destination or travel date mid-conversation.

---

​

How It Works

1. Amend Identification — The platform’s built-in NLP detects the user’s intent to amend.
2. Amending Entities — Three flows based on utterance:
   • User refers to entity name: prompted for new value. (If entity appears multiple times, the most recently populated one is amended.)
   • User provides entity value: entity is updated. (If value matches multiple entities, user selects which to amend.)
   • User refers to both entity name and value: entity is updated directly.
3. Post-Amendment Behavior — Three options:
   • Re-execute dialog from the amended node (evaluating its connections).
   • Resume from the node where the amend was identified.
   • Resume from a specified node.

---

​

Configuration

Amend behavior is set at two levels. Task-level settings override app-level.

​

App Level

1. Go to Natural Language > NLU Config > Amend Entity.
2. Enable Allow amend entities.
3. Select a Dialog Resumption option:

   Option	Description
   Re-execute from amended entity	Resume by evaluating the amended entity’s connections. Optionally clear downstream entity values and/or skip previously displayed messages.
   Resume from amend identification node	Resume from the node where the amend was triggered.

4. (Optional) Enable Amend Hidden Entities to allow amendment of entities marked as Hidden.

​

Task Level

1. Go to Conversation Skills > Dialog Tasks → open the task.
2. Click ⋯ (More Options) > Manage Amend Behavior.
3. Select Customize for this task:

   Option	Description
   Don’t allow amend entities	Disables amend for this task.
   Re-execute from amended entity	Same as app-level; also has downstream clear and skip options.
   Resume from amend identification node	Resume from where the amend was triggered.
   Jump to a specific node	Routes to a chosen node for custom behavior. Context contains amended entity details (previous and current values).

   (Optional) Enable Amend Hidden Entities at the task level.

---

​

Amend Trigger Patterns

The platform recognizes these utterance patterns as amend requests. ~amend_synonyms includes: amend, change, modify, alter, update, replace, make, move, upgrade, want.