Objetos

ChatRequest

Campos

• messagesarray of ChatMessageobligatorio

  items ≥ 1

• collectionstring

  Predeterminado: "default"

• tagsarray of string | null
• exportstring | null
• card_idsarray of string | null

  items ≤ 50

• streamboolean

  Predeterminado: false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  No tomar la respuesta de la caché de respuestas (el botón «Get a fresh answer» —obtener una respuesta nueva— bajo una respuesta en caché). La respuesta nueva sustituye la entrada en caché.

  Predeterminado: false

• languagestring | null

  Idioma de la respuesta: un código ISO 639-1 (de, en, ru, …) para responder en ese idioma. Con auto o sin el campo, el idioma se detecta a partir de la pregunta. La interfaz envía de forma explícita el idioma de una sugerencia en otro idioma (Starter.language).

• scopeChatScope | null

  Alcance de la pregunta: varias colecciones, una fuente, etiquetas y un período. Las colecciones del alcance sustituyen a collection. Una fuente limita la respuesta a su colección (y a sus propias tarjetas). Las etiquetas se añaden a tags. El período limita las respuestas financieras a ese período. Solo se puede seleccionar lo que el usuario puede ver (colecciones: collections.no_access/collections.not_found; fuente: sources.not_found). Con conversation_id, el alcance se guarda en la conversación. Sin el campo, se aplica el alcance de la conversación; null o un alcance vacío lo borra.

• request_idstring

  Clave de idempotencia de la pregunta. Envíe la misma clave en cada reintento del flujo de una misma pregunta (un reintento tras una desconexión; aquí Last-Event-ID no continúa el flujo y solo se registra). Un reintento con la clave de una respuesta ya guardada no crea una segunda pregunta: el resultado guardado se envía de nuevo como un único evento done (y un token con el texto), aunque se haya agotado el límite de preguntas o de créditos. Si la respuesta anterior todavía se está generando para un cliente desconectado, esa generación se detiene y la respuesta se genera de nuevo.

  length ≤ 64

• version_ofinteger (int64)

  Crea una versión nueva del turno de esta pregunta en la conversación (question_id del historial de la conversación): una pregunta editada (texto nuevo en messages), una respuesta regenerada (el mismo texto, normalmente con bypass_cache) o la misma pregunta con otro quality (por ejemplo, precise después de una respuesta fast). Se conserva el par anterior de pregunta y respuesta. Los turnos posteriores permanecen en su rama y se ocultan del historial mientras está seleccionada la versión nueva (FeedItem.versions, POST /v1/conversations/{conv_id}/versions). El historial que se usa para la respuesta es la rama seleccionada hasta este turno. El quality de una versión no cambia la configuración de la conversación. Requiere conversation_id; una pregunta de otra conversación devuelve 404 questions.not_found.

• qualitystring

  Equilibrio entre velocidad y precisión de la búsqueda en la que se basa el resultado: fast es más rápido, precise es más preciso. Predeterminado: precise.

  Valores permitidos: fastprecise

Se usa en

• POST/v1/chatTransmitir una respuesta del asistente (SSE)