Actualizar estado

Resumen

La herramienta Actualizar estado permite a tu agente establecer una o varias variables dinámicas mientras una conversación está en curso. Al igual que otras herramientas del sistema, solo modifica el estado interno de la conversación; nunca llama a una API externa ni a una función del lado del cliente.

Úsala para registrar información a medida que avanza una llamada; por ejemplo, para indicar que una conversación debe escalarse, almacenar un valor proporcionado por el usuario o calcular un valor derivado de otras variables dinámicas.

Funcionalidad

• Varias actualizaciones por llamada: Una sola llamada a la herramienta puede asignar hasta 10 variables dinámicas a la vez.
• Valores basados en expresiones: Cada valor es el resultado de una expresión, que puede combinar constantes, variables dinámicas existentes, valores que el LLM extrae de la conversación y operadores.
• Extracción mediante LLM solo cuando es necesaria: La herramienta solo pide al LLM que extraiga parámetros para las actualizaciones que lo requieren. Las actualizaciones creadas íntegramente a partir de constantes o variables dinámicas existentes no añaden ningún parámetro a la llamada de función.
• Disponibilidad inmediata: Cuando se ejecuta la herramienta, las variables dinámicas actualizadas están disponibles para el resto de la conversación: prompts posteriores, otras llamadas a herramientas y anulaciones pueden hacer referencia a ellas, igual que a cualquier otra variable dinámica.

Cómo funciona

Cada actualización de estado asigna el resultado de una expresión a una variable dinámica:

variable_name = expression

Una expresión pertenece a uno de los siguientes tipos, y las expresiones pueden anidarse entre sí para crear una lógica más compleja:

Por ejemplo, la siguiente actualización de estado establece should_escalate en true si el LLM considera que el usuario está frustrado o si una variable dinámica retry_count ya es mayor que 3:

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

Configuración

Casos de uso

• Indicadores de escalado: Establece una variable dinámica (por ejemplo, should_escalate) que compruebe un sistema posterior o una regla de negocio, como se muestra en la guía de integración de Genesys.
• Registro de información extraída: Almacena como variable dinámica un valor proporcionado por el usuario (un número de pedido, una preferencia o el departamento elegido) para usarlo más adelante en la conversación.
• Valores derivados: Calcula un valor a partir de otras variables dinámicas, por ejemplo, incrementando un contador o combinando dos variables en una.

Objetivo: Permitir que el agente actualice una o varias variables dinámicas según la conversación, sin llamar a una API externa.

Condiciones de activación: El LLM debe llamar a esta herramienta cuando:

• La conversación proporcione información que deba registrarse (por ejemplo, una marca de escalado, una opción elegida o un valor proporcionado por el usuario)
• Una actualización de estado configurada dependa de un valor que el LLM deba evaluar o extraer de la conversación

Parámetros:

Los parámetros de la función dependen de cómo esté configurada la herramienta. Cada actualización de estado configurada que use un valor extraído por un LLM añade una propiedad al esquema, con el nombre de la variable dinámica de esa actualización y el tipo string, number o boolean. Las actualizaciones de estado creadas solo con constantes u otras variables dinámicas no añaden ningún parámetro.

Formato de llamada de función:

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

Implementación: El agente evalúa cada expresión configurada usando los parámetros extraídos y las variables dinámicas actuales de la conversación, y después asigna los resultados a las variables dinámicas correspondientes. No se realiza ninguna solicitud externa.

Preguntas frecuentes