Fragmento estado de la sesión del bot

La información de esta página de ayuda se aplica tanto a Studio como a Desktop Studio.

El snippet Bot Session State es obligatorio en su script cuando se utilizan acciones que tienen la propiedad botSessionState. Esto incluye acciones como Textbot Exchange y Voicebot Exchange (de aquí en adelante, ambas acciones se denominan simplemente Exchange). La propiedad botSessionState debe configurarse correctamente para que sus agentes virtualesClosed A software application that handles customer interactions in place of a live human agent. funcionen como se espera. Para hacer esto, debe crear este snippet en su script y configurar las acciones correctamente como se muestra en las secciones siguientes.

The botSessionState property must be configured with the variable that holds the unique identifier for the conversation between the contact and the virtual agent. It is automatically assigned by the virtual agent provider. The identifier prevents a new session from being created with every turn in the conversation and helps the virtual agent maintain context between turns.

El proveedor crea el identificador cuando comienza la conversación y lo pasa al script con la primera respuesta. El script almacena el identificador en la variable indicada en la propiedad botSessionStateVarName (out) de la acción Exchange. Finalmente, el script pasa el identificador del turno anterior desde la propiedad botSessionStateVarName (out) a la propiedad botSessionState.

Sus scripts nunca se deben escribir en esta propiedad ni en su variable. Su script debe estar configurado correctamente para usar el identificador de estado de sesión del bot.

Este snippet es obligatorio a menos que use Google Dialogflow CX, donde puede establecer una identificación de conversación personalizada en el snippet Carga útil personalizada snippet que cumple la misma función que el snippet Bot Session State. Se utiliza una identificación de conversación personalizada al transferir contactos de una instancia de Dialogflow CX a otra. Si no usa ninguna de las DOs identificaciones, se genera una nueva identificación de sesión para cada turno de la conversación y su agente virtual no mantendrá el contexto de la conversación. Si esto ocurre, no se generan errores, pero el sistema no funcionará como se espera.

Configuración de Script

Cuando usa una acción de Intercambio, se requiere un mínimo de DOs instancias de la acción en su script. La propiedad botSessionState en cada una de las acciones Exchange debe configurarse de manera diferente:

  • The first instance of the Exchange action is located right after the Begin action at the start of the script. Configure it as follows: 
    • botSessionState: Esto debe estar vacío.
    • botSessionStateVarName (out): Configure con el nombre de la variable donde desea que el script almacene el identificador.
  • The second Exchange action is located later in the script. Configure it as follows: 
    • botSessionState: Configure con la variable utilizada en botSessionStateVarName (out) en la primera instancia de la acción Exchange. La variable debe contener el identificador de estado de sesión del bot en formato JSON.
    • botSessionStateVarName (out): Configure con el nombre de la variable en la que desea que el script almacene el identificador.
  • The third and any subsequent instances of the Exchange action are optional. If your script includes these instances, configure them as follows: 
    • botSessionState: Configure con la variable usada en botSessionStateVarName (out) en la instancia anterior de la acción Exchange. La variable debe contener el identificador de estado de sesión del bot en formato JSON. El identificador de estado de la sesión del bot no suele cambiar entre turnos. Sin embargo, en caso de que cambie, la acción debería estar configurada para captar el cambio.
    • botSessionStateVarName (out): Configure con el nombre de la variable donde desea que el script almacene el identificador.

Es necesaria esta configuración para todos los agentes virtuales.

Verifique que la propiedad botSessionState esté configurada correctamente

Puede usar un script trace para confirmar que esta propiedad esté configurada correctamente.

  1. Ejecute un rastreo de script en una interacción entre el agente virtual y un contacto. Puede usar un rastreo o capturar un rastreo de un ANI o DNIS específico (solo para interacciones de voz).
  2. En la ventana de seguimiento, haga clic en la línea que corresponde a la primera acción Virtual Agent Hub (Voicebot Exchange o Textbot Exchange).
  3. En la lista variables, marque la variable botSessionState. Su valor debe ser nulo (vacío).
  4. En la ventana de seguimiento, haga clic en la siguiente línea después de la primera acción Virtual Agent Hub.
  5. Nota el valor de la variable botSessionState.
  6. En la ventana de seguimiento, haga clic en la línea del seguimiento que corresponde a cualquier acción Virtual Agent Hub posterior.
  7. Verifique el valor de la variable botSessionState. Debe ser el mismo que en el paso 5.

Convertir el identificador de estado de la sesión del bot a JSON

El contenido de la Variable utilizada en la propiedad botSessionStateVarName (out) debe convertirse a JSON y pasarse a la propiedad botSessionState de la segunda acción Exchange en su script. Para hacer esto, puede incluir código en una acción Snippet o puede configurar la propiedad directamente. Both approaches are acceptable. However, the benefit of creating a variable in a Snippet to hold the converted object is that it makes it easier to see where the conversion is happening.

Use una Acción de Snippet

  1. Configure la propiedad botSessionStateVarName (out) de la acción Exchange con el nombre de la variable que contendrá el identificador de estado de sesión. Por ejemplo, botSessionState.
  2. Agregue la siguiente línea al Snippet que se ubica antes de la acción de Intercambio en su script:

    ASSIGN botSessionStateOut = botSessionStateOut.asJSON()

    Use el nombre de la variable que use en su script.

  3. Configure la propiedad botSessionState en la acción Exchange con el nombre de la variable que usó en la declaración ASSIGN. Por ejemplo, botSessionStateOut.

Convertir en propiedad

Si convierte la variable en la propiedad botSessionState, use la variable botSessionStateVarName (out) con la asJSON()función. Por ejemplo:

  • botSessionStateVarName (out): botSessionState
  • botSessionState: botSessionState.asJSON()

Transferencia de contactos de un Agente virtual a otro

Para configurar la transferencia de contactos entre agentes virtuales, debe configurar correctamente los id de estado de sesión del bot. Cada agente virtual debe tener su propio id de estado de sesión del bot único. Esto ayuda a que cada agente virtual mantenga el contexto de la conversación en la que participa.

  • Agente virtual 1: Configure las variables de estado de la sesión del bot como se describe anteriormente en esta página.

  • Agente virtual 2: Configurado de la misma manera, utilizando una variable diferente en botSessionStateVarName (out) para almacenar el id de estado de la sesión del bot. Asegúrese de que, en la primera llamada a este agente virtual, la propiedad botSessionState esté vacía. El primer turno de la conversación devuelve un id de estado de sesión del bot único a la variable en botSessionStateVarName (out).
  • Todos los agentes virtuales subsiguientes: Configúrelos de la misma manera que el agente virtual 2, utilizando una Variable única para el id de estado de la sesión del bot.

Este método funciona con todos los proveedores de agentes virtuales admitidos, a menos que esté transfiriendo entre DOs agentes virtuales de Google Dialogflow CX. En este caso, se requiere un método diferente.