OpenDialog Docs
opendialog.aiStart BuildingTalk to an expert
  • GETTING STARTED
    • Introduction
    • Getting ready
    • Billing and plans
    • Quick Start AI Agents
      • Quick Start AI Agent
      • The "Start from Scratch" AI Agent
        • Chat Management Conversation
        • Welcome Conversation
        • Topic Conversation
        • Global No Match Conversation
        • Supporting LLM Actions
        • Semantic Classifier: Query Classifier
      • A Process Handling AI Agent
  • STEP BY STEP GUIDES
    • AI Agent Creation Overview
    • Add a new topic of discussion
    • Use knowledge sources via RAG
    • Adding a structured conversation
    • Add a 3rd party integration
    • Test and tweak your AI Agent
    • Publish your AI Agent
  • CORE CONCEPTS
    • OpenDialog Approach
      • Designing Conversational AI Agents
    • OpenDialog Platform
      • Scenarios
        • Conversations
        • Scenes
        • Turns and intents
      • Language Services
      • OpenDialog Account Management
        • Creating and managing users
        • Deleting OpenDialog account
        • Account Security
    • OpenDialog Conversation Engine
    • Contexts and attributes
      • Contexts
      • Attributes
      • Attribute Management
      • Conditions and operators
      • Composite Attributes
  • CREATE AI APPLICATIONS
    • Designing your application
      • Conversation Design
        • Conversational Patterns
          • Introduction to conversational patterns
          • Building robust assistants
            • Contextual help
            • Restart
            • End chat
            • Contextual and Global No Match
            • Contextual FAQ
          • Openings
            • Anatomy of an opening
            • Transactional openings
            • Additional information
          • Authentication
            • Components
            • Example dialog
            • Using in OpenDialog
          • Information collection
            • Components
            • Example dialog
            • Using in OpenDialog
            • Additional information
          • Recommendations
            • Components
            • Example dialog
            • Additional information
          • Extended telling
            • Components
            • Example dialog
            • Additional information
          • Repair
            • Types of repair
            • User request not understood
            • Example dialog
            • Additional information
          • Transfer
            • Components
            • Example dialog
            • Additional information
          • Closing
            • Components
            • Example dialog
            • Using in OpenDialog
            • Additional information
        • Best practices
          • Use Case
          • Subject Matter Expertise
          • Business Goals
          • User needs
            • Primary research
            • Secondary research
            • Outcome: user profile
          • Assistant personality
          • Sample dialogs
          • Conversation structure
          • API Integration Capabilities
          • NLU modeling
          • Testing strategy
          • The team
            • What does a conversation designer do
          • Select resources
      • Message Design
        • Message editor
        • Constructing Messages
        • Message Conditions
        • Messages best practices
        • Subsequent Messages - Virtual Intents
        • Using Attributes in Messages
        • Using Markdown in messages
        • Message Types
          • Text Message
          • Image Message
          • Button Message
          • Date Picker Message
          • Audio Message
          • Form Message
          • Full Page Message
          • Conversation Handover message
          • Autocomplete Message
          • Address Autocomplete Message
          • List Message
          • Rich Message
          • Location Message
          • E-Sign Message
          • File Upload Message
          • Meta Messages
            • Progress Bar Message
          • Attribute Message
      • Webchat Interface design
        • Webchat Interface Settings
        • Webchat Controls
      • Accessibility
      • Inclusive design
    • Leveraging Generative AI
      • Language Services
        • Semantic Intent Classifier
          • OpenAI
          • Azure
          • Google Gemini
          • Output attributes
        • Retrieval Augmented Generation
        • Example-based intent classification [Deprecated]
      • Interpreters
        • Available interpreters
          • OpenDialog interpreter
          • Amazon Lex interpreter
          • Google Dialogflow
            • Google Dialogflow interpreter
            • Google Dialogflow Knowledge Base
          • OpenAI interpreter
        • Using a language service interpreter
        • Interpreter Orchestration
        • Troubleshooting interpreters
      • LLM Actions
        • OpenAI
        • Azure OpenAI
        • Output attributes
        • Using conversation history (memory) in LLM actions
        • LLM Action Analytics
    • 3rd party Integrations in your application
      • Webhook actions
      • Actions from library
        • Freshdesk Action
        • Send to Email Action
        • Set Attributes Action
      • Conversation Hand-off
        • Chatwoot
    • Previewing your application
    • Launching your application
    • Monitoring your application
    • Debugging your application
    • Translating your application
    • FAQ
    • Troubleshooting and Common Problems
  • Developing With OpenDialog
    • Integrating with OpenDialog
    • Actions
      • Webhook actions
      • LLM actions
    • WebChat
      • Chat API
      • WebChat authentication
      • User Tracking
      • Load Webchat within page Element
      • How to enable JavaScript in your browser
      • SDK
        • Methods
        • Events
        • Custom Components
    • External APIs
  • Release Notes
    • Version 3 Upgrade Guide
    • Release Notes
Powered by GitBook
On this page
  • The basics
  • Attribute Management in action
  • Create a new attribute within your scenario
  • View and select existing attributes
  • Navigate attributes within the message editor
  • Where to find
  • Intents
  • Conditions
  • Message editor
  • Structure
  • How to use
  • Vocabulary
  • Creating a new dynamic attribute
  • Adding an existing attribute
  • Frequently asked questions
  1. CORE CONCEPTS
  2. Contexts and attributes

Attribute Management

Use OpenDialog Attribute Management to create new attributes throughout your conversation, and easily access existing attributes.

PreviousAttributesNextConditions and operators

Last updated 1 year ago

This section outlines how to personalise your conversation through the use of existing attributes, and how to create new attributes throughout the conversation engine.

The basics

Attribute Management allows you to view all (reserved & dynamic) available attributes for your conversation in a central section on the scenario level, as well as in the message editor.

It allows you to:

  • Easily select any pre-existing attribute for use from a drop-down list

  • Create a new dynamic attribute on a need-to-have basis throughout the journey

  • Set your attribute name, type, example value and description

  • View the type, example value and description for any pre-existing attribute

By integrating Attribute Management into your workflow, you can streamline the process of personalising conversations. Whether you're modifying existing attributes or introducing new ones on the fly, this feature simplifies the customisation process, enhancing the efficiency of your interactions.

Attribute Management in action

Create a new attribute within your scenario

With Attribute Management, you can easily create your attributes by clicking the 'Create new attribute' button. From here, you can create your new attribute by choosing its name and type. You can also add an example or description to your new attribute, to help you remember it for next time.

View and select existing attributes

By using the drop-down section within the scenario sidebar, or by entering { within the message editor, you can easily navigate through a list of existing attributes and select your desired one quickly and efficiently

Navigate attributes within the message editor

Attribute management also works within the message editor. Here you can view, select and create attributes by simply opening a new curly brace { . This will open up the attribute dropdown function in-line, giving you access to all the attribute management functions without having to leave the page.

Where to find

The Attribute Management function can be found in the sidebar of the conversation designer at each component level within the conditions section, and also within the 'Advanced Intent Settings' sidebar. You can also access this functionality within the message editor.

Intents

To access the Attribute Management feature within the intents sidebar for a given scenario:

  • Go to your workspace overview (Scenarios)

  • Select the scenario you would like to update

  • Select the intent you would like to add an attribute to

  • Click 'Add conditions, actions and attributes' at the bottom of the sidebar

  • Select 'Add new attribute'

  • Start to type your chosen attribute into the 'Set attribute value' input field

Conditions

To access the Attribute Management feature within the conditions sidebar for a given scenario:

  • Go to your workspace overview (Scenarios)

  • Select the scenario you would like to update

  • Open the conversation designer for your chosen scenario

  • Select 'Add new condition' from within the sidebar

  • Start to type your chosen attribute into the 'If' input field

Message editor

To access the Attribute Management feature within the message editor for a given scenario:

  • Go to your workspace overview (Scenarios)

  • Select the scenario you would like to update

  • Select the message section under 'Design' in the left-hand menu

  • Select the message you would like to edit

  • Click within the 'Text' block for your chosen message

  • Activate Attribute Management by inputting an opening curly brace {

Structure

drop-downAttribute management has two main components accessible via the autocomplete drop-down menu - the selection of existing attributes and the creation of new attributes.

Both the creation of new attributes and the selection of existing attributes are accessible through the custom conditions section within the conversation designer sidebar, as well as through the advanced intent settings section. This functionality can also be accessed within the message editor and within the text block. To activate you simply need to enter an opening curly brace.

How to use

Vocabulary

Below, we outline the vocabulary used throughout this section to describe the different types of attributes.

A reserved attribute is an attribute that is global to the OpenDialog system. These attributes are used across all scenarios and cannot be modified or deleted. All reserved attributes can be viewed and accessed via the attribute drop-down list.

A dynamic attribute is an attribute that is specific to your chosen scenario. These attributes are created by you through using the 'create new attribute' functionality. These attributes, once created, are then ready to view and use throughout your chosen scenario.

Creating a new dynamic attribute

If the attribute you want to use doesn't exist within a scenario, you can add a new attribute to the list. Within the conversation designer sidebar, there are two ways to do this. The first is simply to click the 'Create new attribute' button that is located underneath the text input field. This will take you straight to the attribute creation section.

The second way to create a new attribute is through the drop down itself. If you aren't sure whether the attribute you want has been created or not, you can go ahead and type it into the input field anyway. If the attribute isn't in existence, a "no results found" symbol will pop up. From here, you can click the button at the bottom of the drop-down field to bring up the create attribute section.

This functionality is also the same within the message editor. See the image below for an example:

Once you have selected to create a new attribute, the attribute creation modal will pop up on your screen. From here, you can input:

  • Attribute name

  • Attribute type

  • Attribute value

  • Attribute description

Once you are happy with all of the completed fields, you can click the 'Save attribute' button at the bottom of the modal, or simply press enter. Once this is done, your attribute will be saved and added to the list of existing attributes for your scenario. This attribute can now be accessed via the drop-down list and used throughout your conversations.

Adding an existing attribute

To add an existing attribute within the conditions panel, find the input field under 'If'. From here, start typing in the name of the attribute you wish to add. As soon as you do this, a dropdown will appear containing a list of all your pre-existing attributes. As you continue to type the name of your chosen attribute, the list will narrow down, making the attribute easier to find.

Once you have found your chosen attribute, simply click on the item within the list.

Once you have selected your attribute, you can click the information icon button on the right-hand side of the input field to find out further information about the attribute that you have chosen. For example, the attribute type, value, and description.

An attribute can also be selected within the message editor. To do this, navigate to the message you want to edit, click within the text block, or add a new text block if there isn't already one there. To add a new attribute, open the drop-down menu by opening a curly brace { . From here, you can start typing an attribute name, which will bring up the list of attributes to choose from. Once you have found your chosen attribute, either click on the item within the list or press enter.

Frequently asked questions

I can't find the attribute I want in the drop-down list, what should I do?

If you can't find the attribute you are looking for, first double-check that your spelling is correct. If you have checked your spelling, and it is still not showing up in the list, that means the attribute probably doesn't exist. You can go ahead and add a new attribute by clicking "Create new attribute".

How do I delete or edit an attribute?

To delete or change a dynamic attribute that you've created, simply add "/admin/dynamic-attributes" to the end of your URL whilst in your OpenDialog workspace. This will take you to your attribute management dashboard where you can customise your list of attributes.

OpenDialog Attribute Management lets you create new attributes on a need-to-have basis throughout the conversation engine.
The attribute input field can be accessed within the advanced intent settings section in conversation designer sidebar.
The attribute management input field can be accessed under the custom conditions section of the conversation designer sidebar.
The attribute input field can be accessed within the message editor section of the conversation designer
Click the 'Create new attribute' button to create a new attribute for your scenario.
Click the button at the bottom of the drop down field to create a new attribute.
Click the button at the bottom of the drop down field to create a new attribute within the message editor.
Use the 'Add new attribute' modal to create a new dynamic attribute for your scenario.
Start typing your chosen attribute into the text field to bring up the attribute dropdown selection.
Click the information icon button on the right hand side of the input field to find out further information about an attribute.
Open a curly brace to activate the attribute management input field within the message editor.