Cette page décrit les bonnes pratiques à suivre pour utiliser la fonctionnalité de rédaction intelligente d'Agent Assist. Pour en savoir plus sur l'implémentation de cette fonctionnalité en appelant directement l'API, consultez le guide d'utilisation sur la rédaction intelligente ou le tutoriel sur la console pour obtenir des instructions sur l'implémentation de cette fonctionnalité à l'aide de la console Agent Assist.
Terminologie
La rédaction intelligente utilise les termes suivants.
Texte de base de la suggestion
Cette section définit la terminologie utilisée pour Agent Assist.
Le texte de base d'une suggestion est le texte partiellement saisi que la rédaction intelligente utilise pour générer la suggestion de texte complété. Il s'agit du texte dans le
current_text_input.text de
SuggestSmartComposeAnswersRequest.
Exemple : Si l'agent humain saisit "Co", une suggestion possible peut être "Comment allez-vous ?". Dans ce cas, "Co" est le texte de base et "Comment allez-vous ?" est la suggestion.
Texte étendu de la suggestion
Le texte étendu d'une suggestion est créé en fusionnant la suggestion avec son texte de base. Si le texte de base contient un suffixe qui correspond à un préfixe de la suggestion, la partie correspondante est fusionnée. La rédaction intelligente met en correspondance les suffixes et les préfixes sans tenir compte de la casse. Pour éviter les faux négatifs, nous vous recommandons de n'afficher une suggestion que lorsqu'elle comporte un préfixe non vide qui correspond à un suffixe dans le texte de base.
Exemple : Si le texte de base est "Co" et que la suggestion est "Comment allez-vous ?", le texte étendu de la suggestion est "Comment allez-vous ?".
Suggestion disponible
Une suggestion est disponible si :
- Le texte de base de la suggestion est un préfixe du texte déjà saisi.
- Le texte saisi est un préfixe du texte étendu de la suggestion, mais n'est pas égal à celui-ci.
Exemple : La suggestion « Comment allez-vous ? » avec le texte de base « Co » est une suggestion disponible lorsque le texte déjà saisi est « Comment a », mais ce n’est pas une suggestion disponible lorsque le texte déjà saisi est « C » ou « Comment allez-vous ? ».
Demander une suggestion
Nous vous suggérons de demander à votre serveur d'envoyer une
suggestSmartComposeAnswers
requête pour chaque nouveau caractère, sauf si ce caractère est déjà couvert par une
suggestion disponible. Cela augmente la probabilité de générer des suggestions de rédaction intelligente. Sachez que cela peut générer un qps élevé. Si vous constatez que les requêtes sont limitées en raison des limites de quota, veuillez contacter Google pour discuter d'une solution. Lorsque vous créez une requête, envisagez de définir max_results=3 pour augmenter le nombre de suggestions récupérées.
Sélectionner une suggestion
La sélection d'une suggestion est une fonctionnalité essentielle qui doit être implémentée avant de pouvoir implémenter la rédaction intelligente dans une interface utilisateur d'agent. La saisie peut être rapide et il existe une latence pour toute suggestion de rédaction intelligente. Par conséquent, les suggestions peuvent ne plus être valides au moment où elles atteignent l'interface utilisateur de l'agent. Pour minimiser ce problème, nous vous recommandons de n'afficher qu'un sous-ensemble des suggestions disponibles dans l'interface utilisateur. Pour un texte saisi donné, une suggestion doit être sélectionnée si :
- Il s'agit d'une suggestion disponible pour le texte saisi.
- Son texte de base comporte le plus grand nombre de caractères parmi toutes les suggestions disponibles.
- S'il existe plusieurs suggestions qui ont le même texte de base le plus long, choisissez l'option avec le rang de suggestion le plus élevé.
Exemple de workflow :
- Un agent saisit "Co".
- Une requête est envoyée avec le message actuel "Co".
- L'agent continue à saisir "Comment".
- La suggestion {"J'espère que vous allez bien", "Comment allez-vous ?", "Comment allez-vous aujourd'hui ?"} (basée sur l'entrée d'origine "Co") atteint l'interface utilisateur de l'agent.
- Dans ce cas, "J'espère que vous allez bien" n'est plus une suggestion valide, car l'agent a saisi un mot différent. Au lieu de cela, "Comment allez-vous ?" doit être suggéré.
Mise en cache
Nous vous recommandons d'implémenter la mise en cache sous forme de mappage clé-valeur, avec le préfixe comme clé et les suggestions renvoyées par l'API comme valeur. Le mappage doit être vérifié pour une clé qui correspond à l'entrée de l'agent. Si le mappage ne contient pas de clé correspondante, les caractères doivent être supprimés de la fin de l'entrée de l'agent un par un, le mappage étant vérifié à chaque itération. Cela doit continuer jusqu'à ce qu'une suggestion correspondante soit trouvée, qu'il n'y ait plus de caractères à supprimer de l'entrée de l'agent ou qu'une limite d'itération soit atteinte (50 itérations est un nombre raisonnable). Lorsque la clé correspondante est trouvée, les suggestions doivent être itérées. Pour déterminer si une suggestion est valide, la clé (sous-chaîne de préfixe) et la suggestion sont fusionnées, puis vérifiées par rapport à l'entrée de l'agent. La suggestion fusionnée et l'entrée de l'agent doivent se chevaucher complètement à partir des premiers caractères. Si ce n'est pas le cas, la suggestion suivante doit être vérifiée.
Exemple d'utilisation de la mise en cache :
- "Agent" saisit "C".
- Le mappage clé-valeur est vérifié pour les suggestions concernant le préfixe "C". Il n'y en a pas, et il n'y a plus de caractères à supprimer de la fin de l'entrée. Une demande de suggestions pour "C" est donc effectuée.
- "Agent" continue à saisir "Co".
- Le mappage clé-valeur est vérifié pour les suggestions concernant le préfixe "Co". Il n'y en a pas. Le mappage clé-valeur est vérifié pour les suggestions concernant le préfixe "C". Il n'y en a pas, et il n'y a plus de caractères à supprimer de la fin de l'entrée. Une demande de suggestions pour "Co" est donc effectuée.
- Une réponse sans suggestions est reçue de la requête envoyée à l'étape 2, et la réponse est ajoutée au cache pour la clé "C".
- Une réponse avec les suggestions {"J'espère que vous allez bien", "Comment allez-vous ?", "Comment allez-vous aujourd'hui ?"} est reçue de la requête envoyée à l'étape 4, et les suggestions sont ajoutées au cache pour la clé "Co".
- Le mappage clé-valeur est vérifié pour les suggestions concernant le préfixe "Co". Des suggestions sont disponibles. Les suggestions sont mises en boucle, la clé et la suggestion étant fusionnées et vérifiées par rapport à l'entrée "Agent". L'entrée "Agent" "Co" chevauche la première suggestion "J'espère que vous allez bien". La suggestion "espère que vous allez bien" est donc affichée à l'agent.
- "Agent" continue à saisir "Comment".
- Le mappage clé-valeur est vérifié pour les suggestions concernant le préfixe "Comment". Aucune suggestion n'est disponible. Le mappage clé-valeur est vérifié pour les suggestions concernant le préfixe "Co". Des suggestions sont disponibles. Les suggestions sont mises en boucle, la clé et la suggestion étant fusionnées et vérifiées par rapport à l'entrée "Agent". L'entrée "Agent" "Comment" chevauche la première suggestion "Comment allez-vous ?". La suggestion "allez-vous ?" est donc affichée à l'agent.
Historique de la conversation
La rédaction intelligente s'appuie sur l'historique des conversations pour fonctionner correctement. Si vous utilisez
la réponse suggérée ou toute autre fonctionnalité d'Agent Assist via l'API
analyzeContent,
vous devriez déjà être couvert. Sinon, vous devez appeler l'API analyzeContent pour chaque message terminé avant d'utiliser suggestSmartComposeAnswers pour obtenir des suggestions de rédaction intelligente. Pour en savoir plus, consultez le guide pratique sur la rédaction intelligente.