Atualizar estado

Visão geral

A ferramenta Atualizar estado permite que seu agente defina uma ou mais variáveis dinâmicas enquanto uma conversa está em andamento. Assim como outras ferramentas do sistema, ela altera apenas o estado interno da conversa — nunca chama uma API externa ou uma função do lado do cliente.

Use-a para registrar informações conforme uma chamada acontece, por exemplo, sinalizando que uma conversa deve ser escalada, armazenando um valor fornecido pelo usuário ou calculando um valor derivado de outras variáveis dinâmicas.

Para aplicar atualizações de estado em um ponto fixo de um workflow, em vez de sempre que o LLM chama uma ferramenta, use um nó de atualização de estado. Ele aceita as mesmas atualizações de estado.

Funcionalidades

• Várias atualizações por chamada: Uma única chamada de ferramenta pode atribuir até 50 variáveis dinâmicas de uma vez.
• Valores baseados em expressões: Cada valor é o resultado de uma expressão, que pode combinar constantes, variáveis dinâmicas existentes, valores que o LLM extrai da conversa e operadores.
• Extração pelo LLM apenas quando necessária: A ferramenta só pede ao LLM para extrair parâmetros para as atualizações que precisam disso. Atualizações criadas inteiramente com constantes e/ou variáveis dinâmicas existentes não adicionam parâmetros à chamada de função.
• Disponibilidade imediata: Assim que a ferramenta é executada, as variáveis dinâmicas atualizadas ficam disponíveis para o restante da conversa — prompts posteriores, outras chamadas de ferramentas e substituições podem fazer referência a elas, assim como a qualquer outra variável dinâmica.

Como funciona

Cada atualização de estado atribui o resultado de uma expressão a uma variável dinâmica:

variable_name = expression

Uma expressão é de um dos tipos a seguir, e as expressões podem ser aninhadas umas nas outras para criar uma lógica mais complexa:

Por exemplo, a atualização de estado a seguir define should_escalate como true se o LLM avaliar que o usuário está frustrado ou se uma variável dinâmica retry_count já for maior que 3:

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

Configuração

Casos de uso

• Sinalizadores de escalonamento: Defina uma variável dinâmica (por exemplo, should_escalate) que um sistema posterior ou regra de negócio verifica, conforme mostrado no guia de integração com o Genesys.
• Registro de informações extraídas: Armazene como uma variável dinâmica um valor fornecido pelo usuário (número do pedido, preferência, departamento escolhido) para uso posterior na conversa.
• Valores derivados: Calcule um valor a partir de outras variáveis dinâmicas, como incrementar um contador ou combinar duas variáveis em uma.

Objetivo: Permitir que o agente atualize uma ou mais variáveis dinâmicas com base na conversa, sem chamar uma API externa.

Condições de acionamento: o LLM deve chamar esta ferramenta quando:

• A conversa fornecer informações que devem ser registradas (por exemplo, um indicador de escalonamento, uma opção escolhida ou um valor fornecido pelo usuário)
• Uma atualização de estado configurada depender de um valor que o LLM precisa avaliar ou extrair da conversa

Parâmetros:

Os parâmetros da função dependem de como a ferramenta foi configurada. Cada atualização de estado configurada que usa um valor extraído pelo LLM adiciona uma propriedade ao esquema, nomeada de acordo com a variável dinâmica dessa atualização e tipada como string, number ou boolean. Atualizações de estado criadas apenas com constantes ou outras variáveis dinâmicas não adicionam parâmetros.

Formato de chamada da função:

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

Implementação: o agente avalia cada expressão configurada usando os parâmetros extraídos e as variáveis dinâmicas atuais da conversa e, em seguida, atribui os resultados às variáveis dinâmicas correspondentes. Nenhuma solicitação externa é feita.

Perguntas frequentes