> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doconda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Salida estructurada frente a salida en archivo

> La salida estructurada es JSON que cumple un esquema; la salida en archivo es un documento binario, como un DOCX o un XLSX.

La **salida estructurada** (*structured output*) es la respuesta de un modelo de lenguaje en un formato que cumple un
esquema, normalmente JSON validado con JSON Schema, para que un programa la lea sin ambigüedad. La **salida en
archivo** es un documento terminado, como un [DOCX](/glossary/docx), un [XLSX](/glossary/xlsx) o un PDF, que una persona
abre con su programa. Son complementarias: la primera es para máquinas; la segunda, para personas.

## Por qué importa al generar documentos con IA

* Un modelo no devuelve archivos binarios de forma fiable; produce texto o JSON que otro paso convierte en archivo.
* Junto al archivo, un informe estructurado (estado, avisos con código y posición) permite que la aplicación decida
  sin abrir el documento.
* Para un [agente](/glossary/ai-agent), devolver el archivo entero gasta contexto; un enlace y un resumen bastan.
* Extraer el contenido de un archivo como texto (por ejemplo, [Markdown](/glossary/markdown)) es el camino inverso.

## Con Doconda

Cada documento devuelve sus archivos en `outputs` (el Word y su PDF, por ejemplo) y un informe en JSON. Cada aviso de
[revisión](/guides/review) trae su código, su gravedad y su posición (`pages`, o `sheet` y `cells` en Excel). Los
enlaces de descarga caducan a los 5 minutos y se piden otros con `GET /documents/{id}/outputs` ([Quickstart](/quickstart)).

## Relacionado

* [Qué es la llamada a herramientas](/glossary/tool-calling)
* [Qué es Markdown](/glossary/markdown)
* [Qué es una API de generación de documentos](/glossary/document-generation-api)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.