Skip to main content
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.
El Markdown admite títulos, párrafos, listas, tablas, negrita/cursiva, enlaces, saltos de página e imágenes. El texto se usa tal cual.

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. Todo queda editable: textos, formas, gráficos y fórmulas, no imágenes.

Imágenes

Word, PowerPoint y Excel pueden llevar imágenes, tuyas o de internet:
  • Tuyas: súbelas con POST /files (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); cambian el modelo, cuántos pasos puede dar el agente y cuántas veces mira las páginas. Cada nivel tiene su precio (precios). 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, 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

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).
object
Clave-valor tuyo (cada valor hasta 500 caracteres), se devuelve tal cual.
Usa ?dry_run=true para validar la petición y el estilo sin generar nada.

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