operation: "create" is the default operation. It needs one of prompt or content, and optionally format: docx (Word + PDF), pdf (PDF only), pptx
(PowerPoint + PDF), xlsx (Excel + PDF) or artifact (a web page with its data). If you leave it out, Doconda infers it
from your prompt.
Inside a Word file or a PDF, Doconda decides on its own what kind of document it is (report, letter, contract, memo, minutes) and gives it
its base layout: a contract gets a serif font, justified text and numbered clauses; a letter, no page numbers.
When in doubt, a report. You don’t pick it: describe it in prompt and adjust the look with style.
- From your text
- From a sentence
- With your files
How it’s made
The same for every format, the way a good professional works at their computer: an AI agent reads the format’s manual, writes a small program that builds the file, runs it in an isolated sandbox (no internet), checks it and, when something is wrong, fixes the program and runs it again (it never patches the file by hand). Then it delivers it and Doconda reviews it one last time.
Everything stays editable: text, shapes, charts and formulas, not pictures.
Images
Word, PowerPoint and Excel can include images, yours or from the internet:- Yours: upload them with
POST /files(PNG, JPEG, GIF or WebP) and pass them insources, alongside your documents if any (up to 10 images). Doconda works out on its own what each file is: documents are material to write from, and images go inside the document, where they fit. - With your own Markdown,
sourcesonly holds images: place them on their own line with(img:1is the first image insources,img:2the second…). - From the internet: the AI can search for an image when it adds something (a place, a product, a logo); in your Markdown,
or a direct link. The source goes in the caption and the report flags each one (image.web_source) so you can check you’re allowed to use it. - In Word they’re centred and fitted to the width, with their caption; in PowerPoint, next to the slide text; in Excel, beside the table.
- If an image can’t be placed, the document still comes out and the report says so (
image.unavailable).
Quality levels
quality sets how much effort goes into the file. The path is the same at every level (the one
above); what changes is the model, how many steps the agent may take and how many times it looks at
the pages. Each level has its own price (pricing).
With
auto, max_quality sets a cap: "max_quality": "standard" never goes above standard. The document says which
level was used and why in quality (requested, level, reason), and the path in route (agent, or fast if
the agent isn’t available).
For example, “Presentation for investors” usually goes to best; “Draft minutes of the meeting”, to fast. If you ask
for comments or tracked changes when you edit, or to use your template, auto picks best.
If the agent can’t finish, Doconda makes it on its fast path (it writes the text and its engine lays it out), says so
(agent.fallback) and, if it was best, charges it as standard. The quality.chosen, agent.step and
agent.checked events show the progress.
Copy the design of a file
Put the file whose look you want to copy (a presentation, a Word, an Excel, a PDF or a picture) insources and say it
in the request: “with the design of our template”. Doconda tells which source is the design; the rest stays material
for the content. The design.chosen event says which file it used.
- A presentation for a presentation: the agent uses it as the template (copies its slides and fills them).
- Any other pair (a reference Word, a PDF, a screenshot): the agent copies its fonts, colours, margins, header and footer, logo and cover.
- At any level. If the agent couldn’t finish, the document gets its own design and the report says so
(
design.not_copied).
Options
string
A name to find it later (“Malasaña flat lease”, up to 200 characters). Also works for review,
edit and read. Files download with that name (
Malasana flat lease.docx).object
Your own key-value pairs (each value up to 500 characters), returned as is.
What Doconda understands and checks on its own
- The format, if you don’t say. From a sentence (“a residential lease…”, “a presentation for the board…”) Doconda
infers the
format, the kind of document, the language and, for an artifact, whether its data is shared or per visitor. If the format isn’t clear, the document fails withformat_unclear(and isn’t charged) instead of guessing. Therequest.understoodevent says what it understood (formatandtype) and how confident it is. - Sources with instructions for the AI. If a source tries to tell the AI to do something else, it isn’t followed and the
report flags it (
source.instructions). - Data you didn’t provide. Before delivering, the agent removes figures, dates and citations that aren’t in your
request or your sources (or leaves a visible gap such as [DATA]). If one still slips through, the report flags it
(
content.unsupported_fact), so you can check it before sending it. - Legal citations. Articles, laws, regulations and rulings that don’t come from your request or your sources are
flagged (
content.unsupported_citation); if the AI isn’t sure, they’re left as information to check by hand (content.citation_to_review). - Harmful requests. Documents meant to deceive or cause harm (forgeries, impersonation, pages asking for
passwords or cards) fail with
request_refusedand aren’t charged; if in doubt, they’re made and the report flags it (request.review). - The industry and its checklist. Doconda recognises the industry (legal, healthcare, accounting…) and the type of document
within it, and writes following its guide; your instructions take precedence over it. When it’s done it checks the industry’s
“before delivery” checklist: the
quality.checkedevent gives a score from 0 to 100 and every item that isn’t met appears in the report (quality.check_failed). - Long sources. If your sources don’t fit in full, Doconda keeps the passages about what you’re asking for
(
source.selectedsays how much was used). - Key data. The report includes
key_data: amounts, dates, tax IDs and IBANs in the document, with their role (main amount, signing date, due date…). - Reader test. Doconda imagines the questions a reader of the document will ask, and another AI, which only sees the
document, tries to answer them. Whatever it can’t find appears in the report (
content.unclear: “doesn’t give the start date”), as do internal contradictions (content.contradiction). Only when the AI writes the text.
The first three, in the regions where our judgment model is active (elsewhere,
format is required). The reader test, in all of them.