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.
- Desde tu texto
- Desde una frase
- Con tus ficheros
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 ensources, 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,
sourcessolo lleva imágenes: apúntalas en su propia línea con(img:1es la primera imagen desources,img:2la segunda…). - De internet: la IA puede buscar una imagen cuando aporta (un lugar, un producto, un logotipo); en tu Markdown,
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
Conquality 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 ensources 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.
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 conformat_unclear(y no se cobra) en vez de adivinar. El eventorequest.understooddice qué entendió (formatytype) 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_refusedy 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.checkedda 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.selecteddice 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.