Salida estructurada

Haz preguntas tipadas y recibe respuestas calibradas en cada resultado, en la misma llamada.

Agrega questions a cualquier búsqueda y cada resultado vuelve con respuestas tipadas. Sin una segunda pasada de LLM, sin parsear texto: cada respuesta es una probabilidad, una opción o un puntaje.

const res = await ts.search('el Presupuesto 2027', {
  mode: 'normal',
  questions: {
    menciona_cifra: {
      type: 'boolean',
      instructions: '¿La nota menciona un monto de dinero concreto?',
    },
    postura: {
      type: 'choice',
      instructions: '¿Qué postura tiene la nota sobre el presupuesto?',
      criteria: { a_favor: null, critica: null, neutral: 'Informa sin tomar partido.' },
    },
    impacto: {
      type: 'score',
      instructions: '¿Cuánto afecta a los hogares?',
      criteria: ['Nada', 'Poco', 'Moderado', 'Mucho', 'Muchísimo'],
    },
  },
});

const respuestas = res.results[0]?.answers?.values;

Tipos de pregunta

`type`	`criteria`	Respuesta
`boolean`	Opcional: qué cuenta como `true` y qué como `false`.	La `probability` de que la afirmación sea cierta.
`choice`	Obligatorio: las opciones como claves, cada una con una descripción opcional. Al menos dos.	La opción elegida (`choice`), las `probabilities` de cada una y una `confidence`.
`score`	Obligatorio: los peldaños de una escala ordenada, del más bajo al más alto. Al menos dos.	Un `score` interpolado en la escala, las `probabilities` de cada peldaño y una `confidence`.

Hasta 8 preguntas por pedido. Las claves son letras, números, - o _, de hasta 40 caracteres.

Cómo leer las respuestas

results[0].answers

{
  "basis": "article",
  "values": {
    "menciona_cifra": { "type": "boolean", "probability": 0.93 },
    "postura": {
      "type": "choice",
      "choice": "critica",
      "probabilities": { "a_favor": 0.07, "critica": 0.81, "neutral": 0.12 },
      "confidence": 0.81
    },
    "impacto": { "type": "score", "score": 2.6, "confidence": 0.74 }
  }
}

basis dice sobre qué se respondió: article si la nota se leyó, headline si sólo estaban el titular y la bajada. Usa normal o deep si necesitas respuestas sobre el texto.
Una probabilidad boolean entre 0.35 y 0.65 significa sin decidir, no un sí débil.

Las respuestas son parte de la respuesta, así que quedan en caché con ella durante 10 minutos. No se reusan entre preguntas distintas.

Salida estructurada

Tipos de pregunta

Cómo leer las respuestas

En esta página