Guide d'accès aux variables de contexte

Modifier en ligne

Les variables de contexte permettent aux agents d'accéder à des informations spécifiques au canal provenant de systèmes externes. Ce guide explique comment configurer et accéder aux variables de contexte, en prenant comme exemple concret le Genesys Bot Connector.

Activation de la variable de contexte

Pour activer les variables de contexte dans votre agent, définissez les paramètres suivants dans le fichier YAML de configuration de votre agent :

context_access_enabled: true

context_variables:
    - channel
    - other_variable_name

context_access_enabled: Doit être défini sur true pour activer l'accès aux variables de contexte
context_variables: Liste des clés de variables de contexte spécifiques auxquelles l'agent a accès

Accéder aux variables de contexte

On accède aux variables de contexte à l'aide de la syntaxe des accolades : {variable_name}Exemple :

instructions: You have access to everything under the {channel} context variables.

Structure contextuelle du Genesys Bot Connector

Ce qui est transmis

"channel": {
    "genesys_bot_connector": {
        "bot_session_id": "<botSessionId>",
        "conversation_id": "<genesysConversationId>",
        "parameters": {
            // Custom parameters from Genesys
         }
    }
}

Les paramètres (ou valeurs d'entrée) sont transmis via le parameters champ de la requête Genesys Bot Connector et deviennent disponibles en tant que variables de contexte.

Exemple de données fournies par Genesys :

"parameters": {
    "user_name": "Jon Snow",
    "priority": "high"
}

Comment l'agent accède aux données

Compte tenu du paramètre d'entrée user_name: "Jon Snow", la directive de l'agent pourrait se présenter comme suit (en supposant qu'il existe un outil simple nommé get_hello_message).

Option 1. Indiquez explicitement quelle variable utiliser.

guidelines:
    - display_name: simple hello message
      condition: If the user just wants a hello message
      action: Use the get_hello_message tool to generate hello message, use {channel.genesys_bot_connector.parameters.user_name} for the name.

Option 2. Demandez à l'agent d'utiliser la « valeur » d'une sous-clé (il est important de préciser qu'il faut utiliser la valeur)

guidelines:
    - display_name: simple hello message
      condition: If the user just wants a hello message
      action: Use the get_hello_message tool to generate hello message, use {user_name} value in the context for the name.

Exemple de configuration d'agent

...

name: customer_service_agent

description: Agent that handles customer service inquiries

instructions: You are a helpful customer service agent. Access user information from {channel} context variables.

context_access_enabled: true

context_variables:
    - channel
  
guidelines:
    - display_name: Personalized greeting
      condition: When starting a new conversation
      action: Greet the customer using {user_name} value from the context.

    - display_name: Priority handling
      condition: If {channel.genesys_bot_connector.parameters.priority} is "high"
      action: Acknowledge the urgent nature and expedite the request. Say "I see this is a high priority matter for you."

...