Características del plan de pago

Las siguientes funciones sólo están disponibles para los usuarios de un plan Plus o superior. Plus

• Integración telefónica
• Puntos finales privados
• Buscar
• API dewatsonx Assistant v2
• Webhook de registro

La API de registros dev2 está disponible con una prueba gratuita del plan Plus.

Las siguientes características solo están disponibles para los usuarios de planes Enterprise. Enterprise

• Seguimiento de actividad
• Varios entornos
• Alterar temporalmente los valores predeterminados del sistema para las modalidades de respuesta
• Envío de sucesos a segmento

El tipo de plan de la instancia de servicio que está utilizando actualmente se muestra en la cabecera de la página. Puede actualizar de un tipo de plan a otro. Para obtener más información, consulte Actualización.

Explicación sobre los planes basados en usuarios

A diferencia de los planes basados en API, que miden el uso según el número de llamadas de API realizadas durante un mes, los planes Plus y Enterprise miden el uso según el número de usuarios activos mensuales.

Un usuario activo mensual (MAU) es cualquier usuario único que tiene al menos una interacción con su asistente o aplicación personalizada durante el mes natural de facturación.

Un usuario exclusivo se reconoce por el ID de usuario asociado con la persona que interactúa con su asistente. La conversación web y otras integraciones incorporadas establecen esta propiedad automáticamente.

Puede calcular MAU por su cuenta, para IBM Cloud y IBM Cloud Pak for Data. Para calcular MAU, utilice el punto final logs para exportar conversaciones. Para un mes determinado, cuente el número de ID de usuario exclusivos encontrados en los resultados. Los ID de usuario con más de 50 mensajes (llamadas de API) en un mes se cuentan más de una vez por cada 50 mensajes. En un caso de uso común, en el que cada ID de usuario representa un cliente que conversa con un asistente, el número promedio de mensajes por usuario suele ser mucho menor que 50 mensajes, por lo que no es habitual contar un ID de usuario más de una vez.

Especificación del ID de usuario con la API REST

Si utiliza un cliente personalizado con la API de watsonx Assistant, debe establecer la propiedad user_id en la carga útil del mensaje que el cliente envía al método message. La propiedad user_id se especifica en la raíz del cuerpo de la solicitud, como en este ejemplo:

{
  "input": {
    "message_type": "text",
    "text": "I want to cancel my order"
  },
  "user_id": "my_user_id"
}

En algunas versiones anteriores del SDK, la propiedad user_id no está soportada como parámetro de método de nivel superior. Como alternativa, puede especificar user_id dentro del objeto context.global.system anidado.

Para obtener más información sobre la propiedad user_id, consulte la documentación de referencia de la API:

• v2 sin estado /message
• v2 con estado /message

Si no se especifica el ID de usuario

Si utiliza una aplicación cliente personalizada y no establece un valor user_id, el servicio lo establece automáticamente en uno de los valores siguientes:

• session_id (solo API v2): propiedad definida en la API v2 API que identifica una única conversación entre un usuario y el asistente. Se proporciona un ID de sesión en las llamadas de API /message que generan las integraciones incorporadas. La sesión finaliza cuando un usuario cierra la ventana de conversación o cuando se alcanza el límite de tiempo de inactividad.

  Si utiliza la API de mensajes v2 sin estado, debe especificar el session_id en cada mensaje de una conversación en curso (en context.global.session_id).

• conversation_id (sólo API v1 ): Propiedad definida en la API v1 que se almacena en el objeto de contexto de una llamada a la API /message. Esta propiedad se puede utilizar para identificar varias llamadas de API /message asociadas a un solo intercambio de conversaciones con un usuario. Sin embargo, solo se utiliza el mismo ID si se retiene explícitamente el ID y se pasa de nuevo con cada solicitud que se realiza como parte de la misma conversación. De lo contrario, se genera un nuevo ID para cada nueva llamada de API /message.

Si la misma persona chatea con su asistente en tres ocasiones distintas durante el mismo periodo de facturación, la forma en que represente a ese usuario en la llamada a la API influirá en la forma en que se facturen las interacciones. Si identifica la interacción del usuario con un user_id, cuenta como un uso. Si identifica la interacción del usuario con un session_id, entonces cuenta como tres usos porque se crea una sesión separada para cada interacción.

Diseñe aplicaciones personalizadas para capturar un user_id o session_id exclusivo y pase la información a watsonx Assistant. Elija un ID que un humano no pueda identificar que no cambie durante el ciclo de vida del cliente. Por ejemplo, no utilice la dirección de correo electrónico de una persona como ID de usuario. De hecho, la sintaxis de user_id debe cumplir los requisitos de los campos de cabecera definidos en el RFC 7230.

Las integraciones incorporadas derivan el ID de usuario de las siguientes formas:

• En las integraciones de Facebook, la propiedad user_id se establece al ID de remitente que Facebook proporciona en su carga útil.
• En las integraciones de Slack, la propiedad user_id es una concatenación del ID de equipo, como, por ejemplo, T09LVDR7Y y el ID de miembro del usuario, como, por ejemplo, W4F8K9JNF. Por ejemplo, T09LVDR7YW4F8K9JNF.
• En la conversación web, puede establecer el valor de la propiedad user_id.

La facturación se gestiona por usuario activo mensual por instancia de servicio. Si un solo usuario interactúa con asistentes alojados por distintas instancias de servicio que pertenecen al mismo plan, cada interacción se trata como un uso distinto. Se le factura por separado la interacción del usuario con cada instancia de servicio.

Gestión de usuarios anónimos

Si la aplicación personalizada o el asistente interactúa con usuarios anónimos, puede generar un ID exclusivo universal (uuid) aleatorio para representar a cada usuario anónimo. Para más información sobre UUIDs, véase RFC 4122.

• En el caso de la conversación web, si no se pasa un identificador de usuario cuando comienza la sesión, la conversación web crea uno automáticamente. Crea una cookie de origen con un ID anónimo generado. La cookie permanece activa durante 45 días. Si el mismo usuario vuelve a su sitio más tarde durante el mes y vuelve a establecer una conversación con su asistente, la integración de la conversación web reconoce al usuario. Y solo se le facturará una vez si el mismo usuario anónimo interactúa con su asistente varias veces en un solo mes.

Si un usuario anónimo inicia una sesión y más tarde se identifica como la misma persona que ha enviado una solicitud con un ID conocido, se le facturará dos veces. Cada mensaje con un ID de usuario exclusivo se factura como un usuario activo independiente. Para evitar esta situación, puede solicitar a los usuarios que inicien sesión antes de iniciar una conversación. O bien, puede utilizar el ID de usuario anónimo para representar al usuario de forma coherente.

Centros de datos

IBM Cloud tiene una red de centros de datos globales que proporcionan ventajas en cuanto a rendimiento a sus servicios de nube. Consulte IBM Cloud centros de datos globales para obtener más información.

Puede crear instancias del servicio watsonx Assistant alojadas en los siguientes centros de datos: