> ## 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.

# Crear

> Un documento nuevo desde una frase, desde tu Markdown o usando tus ficheros.

`operation: "create"` es la operación por defecto. Necesita **uno** de `prompt` o `content`, y opcionalmente `format`: `docx` (Word + PDF), `pdf` (solo el PDF), `pptx`
(PowerPoint + PDF), `xlsx` (Excel + PDF) o `artifact` (una página web con sus datos). Si no lo pones, Doconda lo deduce
de tu `prompt`.

Dentro de un Word o un PDF, Doconda decide solo qué clase de documento es (informe, carta, contrato, memo, acta) y le da
su maquetación base: un contrato, con letra serif, justificado y cláusulas numeradas; una carta, sin números de página.
Si duda, informe. Tú no lo eliges: descríbelo en `prompt` y ajusta el aspecto con `style`.

<Tabs>
  <Tab title="Desde tu texto">
    ```json theme={null}
    {
      "format": "docx",
      "content": { "markdown": "# Solicitud de vacaciones\n\nEstimada Sra. García: ..." },
      "style": "títulos azules"
    }
    ```

    El Markdown admite títulos, párrafos, listas, tablas, negrita/cursiva, enlaces, saltos de página e [imágenes](#imágenes). El texto se usa tal cual.
  </Tab>

  <Tab title="Desde una frase">
    ```json theme={null}
    {
      "format": "docx",
      "prompt": "Reporte de la ley de vivienda con títulos azules y centrado"
    }
    ```

    Un modelo escribe el contenido y entiende el estilo pedido en la misma frase.
  </Tab>

  <Tab title="Con tus ficheros">
    ```json theme={null}
    {
      "format": "pdf",
      "prompt": "Resume esto en 2 páginas",
      "sources": ["file_01JAB3..."]
    }
    ```

    Sube antes los ficheros con [`POST /files`](/api-reference/introduction), o usa un documento que ya hizo Doconda por su id (`doc_…`). En `sources` van tus documentos (Word, PowerPoint, Excel, PDF, también `.doc`, `.ppt` y `.xls`, TXT o Markdown, hasta 5) y tus [imágenes](#imágenes) (hasta 10), juntos. [Otras formas de pasar ficheros](/guides/extract#cuatro-formas-de-pasar-un-fichero).
  </Tab>
</Tabs>

## Cómo se hace

Igual en todos los formatos, como trabaja un buen profesional con su ordenador: un agente de IA lee el manual del
formato, escribe un pequeño programa que construye el archivo, lo ejecuta en una caja aislada (sin internet), lo
comprueba y, si algo está mal, **corrige el programa** y lo vuelve a ejecutar (nunca parchea el archivo a mano). Luego
lo entrega y Doconda lo revisa una última vez.

| `format` | Cómo lo construye | Cómo lo comprueba |
| - | - | - |
| `docx`, `pdf` | Un programa con docx-js; el aspecto va en los estilos de Word (Normal, Título 1…), así el archivo sigue siendo editable. El PDF sale de ese Word. | Validador de Word, nuestra revisión y las páginas convertidas en imágenes. |
| `pptx` | Con una plantilla (la que elige Doconda de su biblioteca, o la tuya): copia sus diapositivas, las ordena y cambia sus textos. Sin plantilla: un programa con pptxgenjs, con su tema, diseños con nombre y gráficos nativos; el tema se guarda en el PowerPoint, para que lo que añadas después lo siga. 16:9. | Validador de PowerPoint (contra la plantilla, si la hay) y las diapositivas en imágenes. |
| `xlsx` | Un programa con openpyxl: fórmulas de verdad (no números copiados), supuestos en sus propias celdas, `INDEX`/`MATCH` en vez de `XLOOKUP` o `FILTER`. Prueba dos o tres fórmulas antes de escribir el resto. | Recalcula todas las fórmulas hasta que no queda ningún error (`#REF!`, `#DIV/0!`…) y mira las hojas. |
| `artifact` | Un plan de diseño corto, comprueba qué puede hacer la página (datos en `doconda.db`, librerías permitidas) y escribe un único HTML con todo dentro. Ver [artifacts](/guides/artifacts). | Capturas en ordenador y en móvil, y corrige lo que se ve mal. |

Todo queda editable: textos, formas, gráficos y fórmulas, no imágenes.

```json theme={null}
{ "format": "pptx", "content": { "markdown": "# Informe Q3\n\n## Ventas\n\n- Crecen un 12 %\n\n| Mes | Importe |\n|---|---|\n| Julio | 12.300 € |" } }
```

## Imágenes

Word, PowerPoint y Excel pueden llevar imágenes, tuyas o de internet:

```json theme={null}
{
  "format": "docx",
  "prompt": "Informe de la reforma de la oficina con las fotos",
  "sources": ["file_presupuesto.pdf...", "file_foto1.jpg...", "file_foto2.jpg..."]
}
```

* **Tuyas**: súbelas con [`POST /files`](/api-reference/introduction) (PNG, JPEG, GIF o WebP) y pásalas en `sources`,
  junto a tus documentos si los hay (hasta 10 imágenes). Doconda distingue solo qué es cada fichero: los documentos son
  material para escribir y las imágenes van dentro del documento, donde encajan.
* **Con tu propio Markdown**, `sources` solo lleva imágenes: apúntalas en su propia línea con `![Pie de foto](img:1)`
  (`img:1` es la primera imagen de `sources`, `img:2` la segunda…).
* **De internet**: la IA puede buscar una imagen cuando aporta (un lugar, un producto, un logotipo); en tu Markdown,
  `![Pie de foto](web:qué buscar)` o un enlace directo. Se pone la fuente en el pie de foto y el informe avisa de cada
  una (`image.web_source`) para que compruebes que puedes usarla.
* En Word van centradas y ajustadas al ancho, con su pie; en PowerPoint, junto al texto de la diapositiva; en Excel,
  al lado de la tabla.
* Si una imagen no se puede poner, el documento sale igual y el informe lo dice (`image.unavailable`).

## Niveles de calidad

Con `quality` eliges cuánto esfuerzo se pone en el archivo. **El camino es el mismo en todos los niveles** (el de
[arriba](#cómo-se-hace)); cambian el modelo, cuántos pasos puede dar el agente y cuántas veces mira las páginas. Cada
nivel tiene su precio ([precios](/guides/account#precios)).

| `quality` | Modelo | Pasos | Veces que mira las páginas | Comprobaciones del texto |
| - | - | - | - | - |
| `fast` | rápido | 25 | 1 | datos que no has dado |
| `standard` | redactor | 40 | 2 | + calidad, datos clave y prueba del lector |
| `best` | el mejor disponible | 60 | 4 | + calidad, datos clave y prueba del lector |
| `auto` (por defecto) | Doconda elige el nivel que necesita tu petición. Ante la duda, el más barato. | | | |

Con `auto`, `max_quality` pone un tope: `"max_quality": "standard"` no pasa nunca de estándar. El documento dice qué
nivel se usó y por qué en `quality` (`requested`, `level`, `reason`), y el camino en `route` (`agent`, o `fast` si el
agente no está disponible).

Por ejemplo, «Presentación para inversores» suele ir a `best`; «Borrador del acta de la reunión», a `fast`. Si pides
comentarios o control de cambios al [editar](/guides/edit), o usar tu plantilla, `auto` elige `best`.

Si el agente no puede terminar, Doconda lo hace por su camino rápido (escribe el texto y lo maqueta su motor), lo avisa
(`agent.fallback`) y, si era `best`, lo cobra como `standard`. Los eventos `quality.chosen`, `agent.step` y
`agent.checked` enseñan el avance.

## Copiar el diseño de un archivo

Pasa en `sources` el archivo cuyo aspecto quieres copiar (una presentación, un Word, un Excel, un PDF o una imagen) y
dilo en la petición: «con el diseño de nuestra plantilla». Doconda reconoce qué fuente es el diseño; el resto sigue
siendo material para el contenido. El evento `design.chosen` dice qué archivo usó.

* **Una presentación para una presentación**: el agente la usa como plantilla (copia sus diapositivas y las rellena).
* **Cualquier otra combinación** (un Word de referencia, un PDF, una captura): el agente copia sus fuentes, colores,
  márgenes, cabecera y pie, logo y portada.
* En cualquier nivel. Si el agente no pudo terminar, el documento sale con un diseño propio y el informe lo avisa
  (`design.not_copied`).

## Opciones

<ParamField body="name" type="string">
  Un nombre para encontrarlo después («Contrato piso Malasaña», hasta 200 caracteres). Vale también para revisar,
  editar y leer. Los ficheros se descargan con ese nombre (`Contrato piso Malasana.docx`).
</ParamField>

<ParamField body="metadata" type="object">
  Clave-valor tuyo (cada valor hasta 500 caracteres), se devuelve tal cual.
</ParamField>

<Tip>Usa `?dry_run=true` para validar la petición y el estilo sin generar nada.</Tip>

## Lo que Doconda entiende y comprueba solo

* **El formato, si no lo dices.** Con una frase ("un contrato de alquiler…", "una presentación para el comité…") Doconda
  deduce el `format`, la clase de documento, el idioma y, en un artifact, si sus datos son compartidos o de cada
  visitante. Si el formato no está claro, el documento falla con `format_unclear` (y no se cobra) en vez de adivinar.
  El evento `request.understood` dice qué entendió (`format` y `type`) y con qué seguridad.
* **Fuentes con órdenes para la IA.** Si una fuente intenta decirle a la IA que haga otra cosa, no se sigue y el
  informe lo avisa (`source.instructions`).
* **Datos que no has dado.** Antes de entregar, el agente quita las cifras, fechas y citas que no están en tu
  petición ni en tus fuentes (o deja un hueco visible como \[DATO]). Si aun así queda alguna, se marca en el informe
  (`content.unsupported_fact`), para que la revises antes de enviarlo.
* **Citas legales.** Artículos, leyes, reglamentos y sentencias que no vienen de tu petición ni de tus fuentes se
  marcan (`content.unsupported_citation`); si la IA no está segura, quedan como información para revisar a mano
  (`content.citation_to_review`).
* **Peticiones dañinas.** Documentos para engañar o hacer daño (falsificaciones, suplantaciones, páginas que piden
  contraseñas o tarjetas) fallan con `request_refused` y no se cobran; si hay dudas, se hacen y el informe lo avisa
  (`request.review`).
* **El sector y su lista de control.** Doconda reconoce el sector (legal, sanidad, gestoría…) y el tipo de documento
  dentro de él, y escribe siguiendo su guía; tus instrucciones mandan sobre ella. Al terminar comprueba la lista
  «antes de entregar» del sector: el evento `quality.checked` da una nota de 0 a 100 y cada punto que no se cumple
  sale en el informe (`quality.check_failed`).
* **Fuentes largas.** Si tus fuentes no caben enteras, Doconda se queda con los pasajes que tratan de lo que pides
  (`source.selected` dice cuánto se usó).
* **Datos clave.** El informe incluye `key_data`: importes, fechas, NIF/CIF e IBAN del documento, con su papel
  (importe principal, fecha de firma, vencimiento…).
* **Prueba del lector.** Doconda imagina las preguntas que se hará quien lea el documento y otra IA, que solo ve el
  documento, intenta contestarlas. Lo que no encuentre sale en el informe (`content.unclear`: «no dice la fecha de
  inicio»), igual que las contradicciones internas (`content.contradiction`). Solo cuando el texto lo escribe la IA.

<Note>Las tres primeras, en las regiones donde está activo nuestro modelo de juicios (en las demás, `format` es obligatorio). La prueba del lector, en todas.</Note>


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