En esta página, se describen las prácticas recomendadas para usar la función de Redacción inteligente de Agent Assist. Consulta la guía práctica de Redacción inteligente para obtener más información sobre cómo implementar esta función llamando directamente a la API o el instructivo de la consola para obtener instrucciones sobre cómo implementar esta función con la consola de Agent Assist.
Terminología
Redacción inteligente usa los siguientes términos.
Texto base de la sugerencia
En esta sección, se define la terminología que se usa para Agent Assist.
El texto base de una sugerencia es el texto escrito parcialmente que usa Redacción inteligente para generar la sugerencia de texto completado. Este es el texto en el
current_text_input.text de
SuggestSmartComposeAnswersRequest.
Ejemplo: Si el agente humano escribe "Ho", una posible sugerencia podría ser "¿cómo estás?". En este caso, "Ho" es el texto base y "¿cómo estás?" es la sugerencia.
Texto extendido de la sugerencia
El texto extendido de una sugerencia se construye combinando la sugerencia con su texto base. Si el texto base contiene un sufijo que coincide con un prefijo de la sugerencia, se combinará la parte coincidente. Redacción inteligente hace coincidir sufijos y prefijos de manera que no distingue mayúsculas de minúsculas. Para evitar falsos negativos, te recomendamos que solo muestres una sugerencia cuando tenga un prefijo no vacío que coincida con un sufijo en el texto base.
Ejemplo: Si el texto base es "Ho" y la sugerencia es "¿cómo estás?", el texto extendido de la sugerencia sería "¿Cómo estás?".
Sugerencia disponible
Una sugerencia es disponible si se cumple lo siguiente:
- El texto base de la sugerencia es un prefijo del texto ya escrito.
- El texto escrito es un prefijo del texto extendido de la sugerencia, pero no es igual a él.
Ejemplo: La sugerencia "¿cómo estás?" con el texto base "Ho" es una sugerencia disponible cuando el texto ya escrito es "cómo a", pero no es una sugerencia disponible cuando el texto ya escrito es "h" o "¿cómo estás?".
Cómo solicitar una sugerencia
Te sugerimos que tu servidor envíe una
suggestSmartComposeAnswers
solicitud en cada carácter nuevo, a menos que ese carácter ya esté cubierto por una
sugerencia disponible. Esto aumenta la probabilidad de generar sugerencias de Redacción inteligente. Ten en cuenta que esto podría generar una alta qps. Si ves que las solicitudes se limitan debido a los límites de cuota, comunícate con Google para analizar una solución. Cuando construyas una solicitud, considera configurar max_results=3 para aumentar la cantidad de sugerencias recuperadas.
Cómo seleccionar una sugerencia
Seleccionar una sugerencia es una funcionalidad fundamental que se debe implementar antes de que puedas implementar Redacción inteligente en una IU de agente. La escritura puede ser rápida y hay cierta latencia en cualquier sugerencia de Redacción inteligente. Por lo tanto, es posible que las sugerencias no sean válidas cuando lleguen a la IU del agente. Para minimizar este problema, te recomendamos que renderices solo un subconjunto de sugerencias disponibles en la IU. Para un texto escrito determinado, se debe seleccionar una sugerencia si se cumple lo siguiente:
- Es una sugerencia disponible para el texto escrito.
- Su texto base tiene la mayor cantidad de caracteres entre todas las sugerencias disponibles.
- Si hay varias sugerencias que tienen el mismo texto base más largo, elige la opción con el rango de sugerencia más alto.
Ejemplo de flujo de trabajo:
- Un agente escribe "Ho".
- Se envía una solicitud con el mensaje actual "Ho".
- El agente siguió escribiendo "How".
- La sugerencia {"Hope you", "¿cómo estás?", "¿Cómo te va hoy?"} (basada en la entrada original "Ho") llega a la IU del agente.
- En este caso, "Hope you" ya no es una sugerencia válida, porque el agente escribió una palabra diferente. En cambio, se debe sugerir "¿cómo estás?".
Almacenamiento en caché
Te recomendamos que implementes el almacenamiento en caché como un par clave-valor, con el prefijo como clave y las sugerencias que muestra la API como valor. Se debe verificar el mapa para obtener una clave que coincida con la entrada del agente. Si el mapa no contiene una clave coincidente, se deben quitar los caracteres del final de la entrada del agente de uno en uno, y se debe verificar el mapa en cada iteración. Esto debe continuar hasta que se encuentre una sugerencia coincidente, no queden más caracteres para quitar de la entrada del agente o se alcance un límite de iteración (50 iteraciones es un número razonable). Cuando se encuentre la clave coincidente, se deben iterar las sugerencias. Para determinar si una sugerencia es válida, se combinan la clave (substring del prefijo) y la sugerencia, y luego se verifican con la entrada del agente. La sugerencia combinada y la entrada del agente deben superponerse por completo a partir de los primeros caracteres. Si no lo hacen, se debe verificar la siguiente sugerencia.
Un ejemplo con almacenamiento en caché:
- "Agente" escribe "H".
- Se verifica el mapa de par clave-valor para obtener sugerencias para el prefijo "H". No hay ninguna, y no quedan más caracteres para quitar del final de la entrada, por lo que se realiza una solicitud de sugerencias para "H".
- "Agente" sigue escribiendo "Ho".
- Se verifica el mapa de par clave-valor para obtener sugerencias para el prefijo "Ho". No hay ninguna, se verifica el mapa de par clave-valor para obtener sugerencias para el prefijo "H". No hay ninguna, y no quedan más caracteres para quitar del final de la entrada, por lo que se realiza una solicitud de sugerencias para "Ho".
- Se recibe una respuesta sin sugerencias de la solicitud enviada en el paso 2, y la respuesta se agrega a la caché para la clave "H".
- Se recibe una respuesta con las sugerencias {"Hope you", "¿cómo estás?", "¿Cómo te va hoy?"} de la solicitud enviada en el paso 4, y las sugerencias se agregan a la caché para la clave "Ho".
- Se verifica el par clave-valor para obtener sugerencias para el prefijo "Ho", hay sugerencias. Las sugerencias se repiten, y la clave y la sugerencia se combinan y se verifican con la entrada "Agente". La entrada "Agente" "Ho" se superpone a la primera sugerencia "Hope you", por lo que se muestra la sugerencia "pe you" al agente.
- "Agente" sigue escribiendo "How".
- Se verifica el par clave-valor para obtener sugerencias para el prefijo "How". No hay sugerencias, se verifica el mapa de par clave-valor para obtener sugerencias para el prefijo "Ho", hay sugerencias. Las sugerencias se repiten, y la clave y la sugerencia se combinan y se verifican con la entrada "Agente". La entrada "Agente" "How" se superpone a la primera sugerencia "¿cómo estás?", por lo que se muestra la sugerencia " cómo estás?" al agente.
Historial de conversación
Redacción inteligente se basa en el historial de conversación para funcionar correctamente. Si usas
Respuesta inteligente o cualquier otra función de Agent Assist a través de la
analyzeContent
API,
ya deberías estar cubierto. De lo contrario, debes llamar a la API de analyzeContent en cada mensaje completado antes de usar suggestSmartComposeAnswers para obtener sugerencias de Redacción inteligente. Consulta la guía práctica de Redacción inteligente para obtener más detalles.