IBM Cloud Docs
Visión general de la API de watsonx Assistant

Visión general de la API de watsonx Assistant

Puede utilizar las API REST de watsonx Assistant y los SDK correspondientes para desarrollar aplicaciones que interactúen con el servicio.

Aplicaciones cliente

Para crear un asistente virtual u otra aplicación cliente que se comunique con un asistente en tiempo de ejecución, utilice la API v2. Puede desarrollar un cliente de cara al cliente que se pueda desplegar para uso de producción, una aplicación que intermedie la comunicación entre un asistente y otro servicio o una aplicación de prueba.

Al utilizar la API de tiempo de ejecución v2 para comunicarse con el asistente, la aplicación puede beneficiarse de las siguientes características:

  • Gestión automática de estado. La API de ejecución v2 gestiona cada sesión con un usuario, almacenando y manteniendo todos los datos de contexto que su asistente necesita para una conversación completa.

  • Facilidad para desplegar asistentes. Además de dar soporte a clientes personalizados, un asistente se puede desplegar fácilmente en canales de mensajería populares como Slack y Facebook Messenger.

  • Control de versiones. Puede guardar una instantánea de su contenido y vincular su asistente a esa versión específica. Luego puede continuar actualizando la versión de desarrollo sin que afecte al asistente de producción.

  • Capacidades de búsqueda. La API de tiempo de ejecución v2 se puede utilizar para recibir respuestas de la integración de búsqueda. Cuando se envía una consulta que el asistente no puede responder, la integración de búsqueda puede encontrar la mejor respuesta de los orígenes de datos configurados.

Para obtener más información, consulte la Referencia de API dewatsonx Assistant v2.

La API watsonx Assistant v1 admite el método /message que envía la entrada del usuario directamente al espacio de trabajo utilizado por un diálogo. La API de ejecución v1 se admite principalmente por compatibilidad. Si utiliza el método v1 /message, debe implementar su propia gestión de estado, y no puede aprovechar el mantenimiento de versiones ni ninguna de las otras características de un asistente.

Creación de aplicaciones

La API v1 proporciona métodos que permiten a una aplicación crear o modificar habilidades de diálogo, como alternativa a la construcción gráfica de una habilidad mediante la interfaz de usuario clásica Watson Assistant. Una aplicación de creación utiliza la API para crear y modificar conocimientos, intenciones, entidades, nodos de diálogo y otros artefactos que componen un conocimiento de diálogo. Para más información, consulte la Referencia de la API v1.

Los métodos de creación v1 crean y modifican espacios de trabajo en lugar de competencias. Un espacio de trabajo es un contenedor para el diálogo y los datos de entrenamiento (por ejemplo, intenciones y entidades) dentro de un conocimiento de diálogo. Si crea un nuevo espacio de trabajo mediante la API, aparecerá como una nueva habilidad de diálogo en la interfaz de usuario clásica Watson Assistant.

Para ver una lista de los métodos de API disponibles, consulte Resumen de métodos de API.