Mettre à jour l’état

Vue d’ensemble

L’outil Mettre à jour l’état permet à votre agent de définir une ou plusieurs variables dynamiques pendant une conversation. Comme les autres outils système, il modifie uniquement l’état interne de la conversation. Il n’appelle jamais d’API externe ni de fonction côté client.

Utilisez-le pour enregistrer des informations au fil d’un appel, par exemple pour signaler qu’une conversation doit être transmise à un niveau supérieur, stocker une valeur fournie par l’utilisateur ou calculer une valeur dérivée d’autres variables dynamiques.

Fonctionnalités

• Plusieurs mises à jour par appel : un seul appel d’outil peut attribuer jusqu’à 10 variables dynamiques à la fois.
• Valeurs basées sur des expressions : chaque valeur est le résultat d’une expression, qui peut combiner des constantes, des variables dynamiques existantes, des valeurs extraites de la conversation par le LLM et des opérateurs.
• Extraction par le LLM uniquement si nécessaire : l’outil demande au LLM d’extraire des paramètres uniquement pour les mises à jour qui le nécessitent. Les mises à jour entièrement fondées sur des constantes et/ou des variables dynamiques existantes n’ajoutent aucun paramètre à l’appel de fonction.
• Disponibilité immédiate : dès que l’outil s’exécute, les variables dynamiques mises à jour sont accessibles dans le reste de la conversation. Les invites ultérieures, les autres appels d’outils et les remplacements peuvent tous y faire référence, comme à toute autre variable dynamique.

Fonctionnement

Chaque mise à jour d’état attribue le résultat d’une expression à une variable dynamique :

variable_name = expression

Une expression appartient à l’un des types suivants. Les expressions peuvent être imbriquées les unes dans les autres pour créer une logique plus complexe :

Par exemple, la mise à jour d’état suivante définit should_escalate sur true si le LLM estime que l’utilisateur est frustré, ou si une variable dynamique retry_count est déjà supérieure à 3 :

should_escalate = (llm: "User sounds frustrated with the conversation") OR (retry_count > 3)

Configuration

Cas d’utilisation

• Indicateurs d’escalade : définissez une variable dynamique, par exemple should_escalate, qu’un système en aval ou une règle métier vérifie, comme indiqué dans le guide d’intégration Genesys.
• Enregistrement des informations extraites : stockez une valeur fournie par l’utilisateur, comme un numéro de commande, une préférence ou le service choisi, dans une variable dynamique afin de l’utiliser plus tard dans la conversation.
• Valeurs dérivées : calculez une valeur à partir d’autres variables dynamiques, par exemple en incrémentant un compteur ou en combinant deux variables en une seule.

Objectif : permettre à l’agent de mettre à jour une ou plusieurs variables dynamiques selon la conversation, sans appeler d’API externe.

Conditions de déclenchement : le LLM doit appeler cet outil lorsque :

• La conversation fournit des informations qui doivent être enregistrées (par exemple, un indicateur d’escalade, une option choisie ou une valeur fournie par l’utilisateur)
• Une mise à jour d’état configurée dépend d’une valeur que le LLM doit évaluer ou extraire de la conversation

Paramètres :

Les paramètres de la fonction dépendent de la configuration de l’outil. Chaque mise à jour d’état configurée qui utilise une valeur extraite par le LLM ajoute une propriété au schéma, nommée d’après la variable dynamique de cette mise à jour et de type string, number ou boolean. Les mises à jour d’état créées uniquement à partir de constantes ou d’autres variables dynamiques n’ajoutent aucun paramètre.

Format d’appel de fonction :

{
  "type": "function",
  "function": {
    "name": "update_state",
    "arguments": "{\"should_escalate\": true}"
  }
}

Implémentation : l’agent évalue chaque expression configurée à l’aide des paramètres extraits et des variables dynamiques actuelles de la conversation, puis attribue les résultats aux variables dynamiques correspondantes. Aucune requête externe n’est effectuée.

FAQ