Prácticas recomendadas para usar los extremos de la API de Conversational Analytics en la API de Looker

Los extremos de la API de ConversationalAnalytics de Looker te permiten crear experiencias de análisis conversacionales personalizadas en tus aplicaciones integradas. Estas APIs reflejan los endpoints que potencian la función de análisis conversacional de Looker y proporcionan las mismas funciones dentro de la API de Looker. Incluyen operaciones de creación, actualización, lectura y eliminación (CRUD) para agentes, conversaciones y mensajes, así como una API de chat para interactuar con el agente conversacional. Para garantizar un proceso de desarrollo sin problemas y un rendimiento óptimo, es importante comprender ciertas limitaciones y seguir las prácticas recomendadas cuando se usan estas APIs.

Flujo de trabajo típico

Un flujo de trabajo típico para una conversación de varios turnos implica el uso conjunto de agentes, conversaciones, mensajes y APIs de chat.

  1. Crea un agente: Si no tienes uno, crea un agente con POST /agents. El agente está configurado para usar modelos y exploraciones específicos de Looker.
  2. Crea una conversación: Inicia una conversación nueva asociada a un agente con POST /conversations. Se devolverá un ID de conversación.
  3. Enviar un mensaje: Para cada turno de la conversación, llama a POST /conversational_analytics/chat con conversation_id y el mensaje del usuario. Este extremo devuelve uno o más mensajes del sistema del agente.
  4. Persist messages: El extremo /conversational_analytics/chat no conserva el mensaje del usuario ni los mensajes del sistema que se devuelven. Para mantener el historial de conversaciones en los turnos posteriores, debes conservar tanto el mensaje del usuario como los mensajes del sistema llamando a POST /conversations/:conversation_id/messages después de llamar a la API de chat.

Recomendaciones

Sigue estas recomendaciones para obtener los mejores resultados:

  • Persiste todos los mensajes: Después de cada llamada a /conversational_analytics/chat, asegúrate de llamar a POST /conversations/:conversation_id/messages para guardar tanto el mensaje del usuario de ese turno como todos los mensajes del sistema que devuelve la API de chat. Esto es fundamental para las conversaciones de varios turnos.
  • Controla la transmisión: Cuando sea posible, usa la capacidad de transmisión de la API de chat para proporcionar comentarios al usuario mientras el agente procesa la información. Los mensajes que se reciben durante la transmisión se pueden usar para indicar que el agente está "pensando".

Limitaciones y consideraciones

Cuando uses los extremos de la API de ConversationalAnalytics, ten en cuenta las siguientes limitaciones:

  • Persistencia de mensajes: Es tu responsabilidad conservar los mensajes con el extremo POST /conversations/:conversation_id/messages. Si no se conservan los mensajes después de cada llamada a /conversational_analytics/chat, no se mantendrá el historial de conversaciones y el agente no tendrá contexto para las preguntas de seguimiento en una conversación de varios turnos.
  • Compatibilidad con la transmisión: La API de chat es una API de transmisión, lo que te permite recibir mensajes a medida que los genera el agente, lo que puede mejorar la experiencia del usuario para las búsquedas de larga duración. Sin embargo, no todos los lenguajes del SDK de Looker admiten la transmisión. Si usas un SDK que no admite la transmisión continua, la API devolverá la respuesta completa de forma síncrona después de que se generen todos los mensajes. Si la transmisión es esencial y no es compatible con el lenguaje de tu SDK, es posible que debas realizar llamadas HTTP directamente para usar la transmisión.