Skip to main content
Skip table of contents

Context in HALO

Context in HALO is a powerful tool designed to standardize operations within your agents and tools, enhancing consistency and security across workflows. This guide explains how to create and manage context effectively.

What is context

Context is a way to provide environmental information about the conversation with the user. It can help to streamline the use of agents and tools. You can think of it like the background information of a conversation. Information like what language is being used or what time it is.

Accessing Context

You can find the Context option in the navigation panel at the bottom of the left-side menu. This feature simplifies the process of standardizing essential values, such as tool labels and API keys, ensuring uniformity across all HALO applications.

image-20250311-100134.png

Creating and Managing Context

Creating a New Context

  • Initiate Creation: Click the blue "+" sign to create a new context.

  • Name: Enter a clear context name that accurately represents the content and purpose of the context. This aids in easy identification and management.

image-20250311-100244.png

Defining Default Values

  • Default Value: In the default value field, input standardized values to be used whenever the context is invoked. This can be a tool name, API key, or any repetitive information that ensures uniform application throughout HALO.

Security and Privacy

  • Private Setting: You can set the context as private to secure sensitive data, such as API keys. This measure is essential for maintaining confidentiality within your profile.

Utilizing Allowed Values

  • Automatic Correction: Define allowed values to automatically replace common typos or abbreviations with the default value. This feature is particularly useful for standardizing names or terms prone to misspellings, such as company names.

Types of context

There are system and non-system context types. A filter can be applied at the top left to filter on all, or one of the two types.

  • System context: managed by HALO itself, not editable. Currently the following system context definitions are set:

    • language

    • channel

    • current_datetime

    • audience

    • media

  • Non-system context: managed by you, and editable.

Automatically set context

Some context are set by HALO as a convenience. The following context definitions are automatically set:

context

set when

allowed values

system context

phone_number

A conversation is started via WhatsApp

n/a

no

chatId

A conversation is initiated

n/a

no

language

A conversation is initiated

n/a

yes

current_datetime

A conversation is initiated

n/a

yes

channel

A conversation is initiated

Apple Business Chat,

iMessage,

WhatsApp,

Line,

Push,

RCS,

SMS,

Viber,

Voice,

Facebook Messenger,

MobilePush,

CXWebConversations,

Instagram,

Telegram Messenger,

Slack,

Microsoft Teams

yes

media

A media object (file) is uploaded to the conversation

n/a

yes

the media system context consists out of a list of all uploaded media items in the conversation. See the below data object for more details:

JSON
[{
  "type": "media", 
  "mime_type": "file mime type (e.g. image/png)", 
  "name": "filename", 
  "data": "base64 encoded representation of the file", 
  "data_uri": "reference to where the file is stored within the HALO system",
  "metadata": {
    "image_height": 1336, 
    "image_width": 1550
  }
}, ...]

Benefits of Context

Employing context within HALO helps maintain consistency and efficiency across your agents and tools by standardizing inputs. This leads to streamlined processes and enhances the accuracy of interactions with external systems.

Example usage

  • As a global value, whenever a change is required, such as an updated API key, you only need to modify the context value without manually adjusting each instance across HALO.

  • As a way to specify which knowledge resources should be used for what. For example, a context with name audience and values internal and external , for which internal can be assigned to an knowledge resource which is for internal use only, and vice versa.
    Please note that if you use context for knowledge resources, you should assign all resources a context.

Optimizing Workflow with Context

By effectively managing context, you ensure a high level of standardization and security in your HALO environment. Implement these practices to optimize your agents’ performance and improve workflow efficiency, leading to more reliable and accurate operations.

Video

Please watch the video on Context in HALO below.

https://vimeo.com/1062768479/d0fd262bde

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.