Ejemplo

El siguiente ejemplo muestra una solicitud con estado /message que incluye variables de contexto globales y específicas de la habilidad; también utiliza la propiedad options.return_context para solicitar que el contexto se devuelva con la respuesta. Esta opción sólo es aplicable si se utiliza el método con estado message, ya que el método sin estado message siempre devuelve el contexto.

service
  .message({
    assistant_id: '{assistant_id}',
    session_id: '{session_id}',
    input: {
      message_type: 'text',
      text: 'Hello',
      options: {
        'return_context': true
      }
    },
    context: {
      'global': {
        'system': {
          'user_id': 'my_user_id'
        }
      },
      'skills': {
        'main skill': {
          'user_defined': {
            'account_number': '123456'
          }
        }
      }
    }
  })
  .then(res => {
    console.log(JSON.stringify(res, null, 2));
  })
  .catch(err => {
    console.log(err);
  });

response=service.message(
    assistant_id='{assistant_id}',
    session_id='{session_id}',
    input={
        'message_type': 'text',
        'text': 'Hello',
        'options': {
            'return_context': True
        }
    },
    context={
        'global': {
            'system': {
                'user_id': 'my_user_id'
            }
        },
        'skills': {
            'main skill': {
                'user_defined': {
                    'account_number': '123456'
                }
            }
        }
    }
).get_result()

print(json.dumps(response, indent=2))

MessageInputOptions inputOptions = new MessageInputOptions.Builder()
  .returnContext(true)
  .build();

MessageInput input = new MessageInput.Builder()
  .messageType("text")
  .text("Hello")
  .options(inputOptions)
  .build();

// create global context with user ID
MessageContextGlobalSystem system = new MessageContextGlobalSystem.Builder()
  .userId("my_user_id")
  .build();
MessageContextGlobal globalContext = new MessageContextGlobal.Builder()
  .system(system)
  .build();

// build user-defined context variables, put in skill-specific context for main skill
Map<String, Object> userDefinedContext = new HashMap<>();
userDefinedContext.put("account_number","123456");
MessageContextSkill mainSkillContext = new MessageContextSkill.Builder()
  .userDefined(userDefinedContext)
  .build();
Map<String, MessageContextSkill> skillsContext = new HashMap<>();
skillsContext.put("main skill", mainSkillContext);

MessageContext context = new MessageContext.Builder()
  .global(globalContext)
  .skills(skillsContext)
  .build();

MessageOptions options = new MessageOptions.Builder()
  .assistantId("{assistant_id}")
  .sessionId("{session_id}")
  .input(input)
  .context(context)
  .build();

MessageResponse response = service.message(options).execute().getResult();

System.out.println(response);

En esta solicitud de ejemplo, la aplicación especifica un valor para user_id como parte del contexto global. Además, establece una variable de contexto definida por el usuario (account_number) como parte del contexto específico del conocimiento. Los nodos del diálogo pueden acceder a esta variable de contexto como $account_number.

Puede especificar cualquier nombre de variable que desee utilizar para una variable de contexto definida por el usuario. Si la variable especificada existe, se sobrescribe con el nuevo valor; si no, se añade una nueva variable al contexto.

La salida de esta solicitud incluye no solo la salida habitual, sino también el contexto, que muestra que se han añadido los valores especificados. Si utiliza el método message sin estado, estos datos de contexto se deben almacenar localmente y se deben volver a enviar al servicio watsonx Assistant como parte del siguiente mensaje. Si se utiliza el método stateful message, este contexto se almacena automáticamente y persiste durante toda la sesión.

{
  "output": {
    "generic": [
      {
        "response_type": "text",
        "text": "Welcome to the watsonx Assistant example!"
      }
    ],
    "intents": [
      {
        "intent": "hello",
        "confidence": 1
      }
    ],
    "entities": []
  },
  "user_id": "my_user_id",
  "context": {
    "global": {
      "system": {
        "turn_count": 1,
        "user_id": "my_user_id"
      }
    },
    "skills": {
      "main skill": {
        "user_defined": {
          "account_number": "123456"
        }
      }
    }
  }
}

Restauración del estado de la conversación

En algunos casos, tal vez sea conveniente restaurar una conversación a un estado anterior.

Puede utilizar la opción export en las solicitudes message con estado para especificar que desea que el objeto de contexto en la respuesta incluya datos de estado de sesión completos. Si especifica true para esta opción, el contexto de conocimiento devuelto incluye una propiedad state codificada que representa el estado de conversación actual.

Si utiliza la API message con estado, el servicio almacena datos de estado de la conversación solamente durante el tiempo de duración de la sesión. Sin embargo, si guardas estos datos de contexto (incluyendo state ) y los envías de vuelta al servicio con una petición de mensaje posterior, puedes restaurar la conversación al mismo estado, incluso si la sesión original expiró o fue borrada.

Si utiliza la API message sin estado, la propiedad state siempre se incluye en las respuestas (junto con el resto de context). Aunque las sesiones sin estado no caducan, puede seguir utilizando estos datos de estado para restablecer una conversación a un estado anterior.