Skip to main content

Hacer pregunta

POST 
/api/widget/projects/:projectId/ask

Envía una pregunta a AI Findr dentro de una conversación de proyecto. Este endpoint admite respuestas en modo streaming y no streaming, permitiendo experiencias de chat en tiempo real o patrones simples de solicitud-respuesta.

Campos de solicitud:

  • query (requerido): La pregunta o mensaje del usuario
  • conversationId (opcional): ID de conversación obtenido desde el endpoint de creación de conversación. Si se omite, se creará automáticamente una nueva conversación
  • stream (opcional): Habilitar respuesta en streaming con Server-Sent Events (por defecto: true)
  • filters (opcional): Cadena JSON para filtrar fuentes de conocimiento durante la recuperación
  • context (opcional): Datos de contexto adicionales enviados directamente a la IA para proporcionar respuestas más relevantes. Utilízalo para incluir información sobre la página actual del usuario, escenario, datos de formularios, o cualquier otra información contextual que ayude a la IA a dar respuestas más precisas y personalizadas.

Streaming vs No Streaming:

  • Streaming (por defecto): Devuelve Server-Sent Events con fragmentos de respuesta en tiempo real, eventos de recuperación de conocimiento y respuesta final
  • No streaming: Devuelve la respuesta completa una vez finalizado el procesamiento

Server-Sent Events (Modo Streaming): Cuando el streaming está habilitado, recibirás estos tipos de eventos:

  • knowledge-retrieved: Fuentes de conocimiento encontradas y recuperadas de tu contenido
  • answer-delta: Fragmentos en tiempo real de la respuesta de la IA a medida que se genera
  • answer-full: Respuesta final completa con el ID del mensaje de respuesta
  • error: Información de error si ocurre algún problema durante el procesamiento

Flujo de respuesta:

  1. Se recuperan fuentes de conocimiento de tu contenido ingresado
  2. La IA genera la respuesta basada en el conocimiento recuperado, historial de conversación y contexto proporcionado
  3. La respuesta se devuelve ya sea como eventos de streaming o como respuesta completa

Request​

Responses​

Stream de Server-Sent Events (modo streaming)