Draft documents with AI

Published

November 20, 2026

Use AI drafting to write your documents from the evidence on your record, such as logged test results, record fields and metrics, plus the files, other documents and artifacts you add as context. You review every draft before it goes into the document.

How AI drafting works

The ​ValidMind drafting agent reads your record’s data and writes text for each section, following the section’s guidelines and any drafting instructions from the document template.1 You can draft in two ways:

  • Draft Document drafts every section of a Development or Validation in one run, including sections that have no blocks yet.
  • Draft Section drafts one section of any document you can edit, including Development, Validation, Monitoring and custom type documents.

The agent reads the following evidence:

  • The section’s guidelines from the document template
  • Test results logged to the record2
  • Record fields and metrics
  • Files attached to the record that you add as context
  • Other documents of the record that you add as context
  • On a validation report, the record’s model documentation, unless you leave it out
  • Artifacts of the record that you add as context, such as findings, limitations or policy exceptions, with the files attached to them
  • Other sections of the same document

The agent reads the record the way you see it. Fields and files that are hidden from you are left out, so a draft never contains values you can’t see.

Test results don’t need to be placed in the document as test-driven blocks. The agent reads the results logged to the record and writes about them. Drafts of development documentation compare the results with the acceptance criteria recorded on the record, and state failed tests, missing results and conflicts between record fields and test results plainly.

Every block you insert from a draft keeps a record of who requested it, which AI model wrote it, when it was accepted and which evidence it cites.

Prerequisites

Draft a whole document

  1. In the left sidebar, click Inventory.

  2. Select a record or find your record by applying a filter or searching for it.7

  3. In the left sidebar that appears for your record, click Documents and select the Latest tab.8

  4. Click on the Development or Validation document you want to draft.

  5. Locate Draft Document on the right, click to expand it, and click Draft Document.

    If the document was drafted before, the dialog opens on that draft so you can review it. Click Start New Draft to start over.

  6. (Optional) Under Instructions, add instructions for the draft, such as the tone to use or the points to emphasize.

    The box shows the instructions from the last whole-document draft. If the document has no earlier draft with instructions, it shows the template’s drafting instructions.9 You can edit or clear them.

  7. (Optional) Add files, other documents or artifacts from the record as extra context.10

  8. Click Draft Document.

    The agent first plans the blocks for sections that have none, then drafts each section. A section with its own drafting instructions in the template gets them in addition to the instructions in the box, both when its blocks are planned and when it is drafted. The dialog shows how many sections are drafted and about how much time is left. Each section opens for review as soon as it is drafted.

You can close the dialog while the draft runs. Until the run ends, the button shows Drafting with a spinner. Click it to reopen the dialog, where you can follow the progress or stop the draft after the current section with Stop Drafting. Sections drafted before you stopped stay available for review.

If a draft is already running for the document, the dialog tells you who started it. Click View progress to follow that draft, or Start new draft anyway to start your own.

Review and insert drafts

The Draft Document with AI dialog lists every section of the draft with its status. Nothing changes in your document until you insert a draft.

  1. Click a section to expand it, or click Expand All.

  2. Review each drafted block. If the block already has content in the document, click Compare with current to see the current text above the draft.

    Under each section, Sources lists the evidence the section’s draft cites. Click a source to preview it. For a test result, the preview shows the version the draft read.

  3. Clear the checkbox on any block you don’t want to insert, or click Deselect All.

    Blocks tagged New Block, and rows that end with “will be added on insert,” are blocks the agent proposes for a section that had none. They are added to the document’s template when you insert the section.

  4. Insert the blocks you kept:

    • To insert one section, click Insert # Blocks under that section.
    • To insert every checked block in the draft, click Insert all (# blocks).
  5. If a block you are inserting already has content, click Yes, Replace Content to confirm. Replacing content cannot be undone.

Inserted sections show when their blocks were accepted. A section that could not be drafted shows “We couldn’t draft this section” with “Start a new draft to try again. If the problem continues, contact your administrator.”

Draft a single section

  1. Open the document and go to the section you want to draft.

  2. Below the section title, click Draft Section.

    Draft Section appears on sections that have at least one text or test-driven block, and on sections that have no blocks yet. It doesn’t appear on a heading that only groups subsections.

  3. (Optional) Under Instructions, add instructions for this section.

    The box shows the instructions last used for this section, whether they came from Draft Section or from a whole-document draft. If the section has drafting instructions in the template, the box shows those until someone drafts the section with their own instructions.11

  4. (Optional) Add files, other documents or artifacts from the record as extra context.12

  5. Click Draft Section.

    While the agent works, the dialog shows the evidence it is reading. For a section with no blocks, the agent first plans the section’s blocks, then drafts them.

  6. Review the drafted blocks. Click Compare with current to see the current text of a block above the draft, and clear the checkbox on any block you don’t want to insert.

    For a section that had no blocks, the drafted blocks are tagged New Block, and rows that end with “will be added on insert” are planned test or metric blocks. Only the blocks you insert are added to the document’s template, together with the planned test and metric blocks.

  7. Click Insert into section, or Insert # blocks when the draft has more than one block. To drop the draft, click Discard.

  8. If a block you are inserting already has content, click Yes, Replace Content to confirm.

Add files, documents and artifacts as context

The agent reads only the files, documents and artifacts you add as context. If you add none, it drafts from the record’s test results, fields and metrics and the other sections of the same document. Add the files, documents and artifacts a draft should use, such as development documentation, training code, notebooks, a related report on the same record, or the open findings a report needs to describe. The agent treats them as primary source material.

  1. In the Instructions box, click and select one of the following:

    • Add Files to Context — Appears when the record has files the agent can read in an attachments field.13
    • Add Documents to Context — Appears when the record has other documents you can open.
    • Add Artifacts to Context — Appears when the record has artifacts you can read.
  2. Select the files, documents or artifacts you want the agent to read. Files are grouped by attachments field, with their upload date, uploader and size. Artifacts are grouped by artifact type, with their name, type, status, assignee, creation date and last update. Click a row to select it. You can select up to 10 documents.

  3. Click Add to Context.

The selected files, documents and artifacts show under your instructions. To remove one, click on it. The next time you open the dialog, it starts with the files, documents and artifacts from the last draft: the section’s last draft for Draft Section, and the last whole-document draft for Draft Document.

For a document added as context, the agent reads its outline first and then only the sections it needs. A section it cites shows under Sources with the document and section name. Click it to open that section. Only the latest version of each document can be added, and not the document you are drafting. If a document can’t be read, such as an uploaded PDF that hasn’t been processed yet, the draft continues without it.

On a validation report, Add Documents to Context lists the record’s model documentation first, labelled Model documentation and selected by default. Clear it to draft without it. The agent then neither reads the model documentation nor cites it. The model documentation doesn’t count toward the limit of 10 documents. The next draft and Regenerate Stale Sections keep your choice.

For an artifact added as context, the agent reads it the way the artifact’s page shows it to you, such as its title, type, status, severity, assignee, dates and the fields you can read, plus the files attached to it. Only the artifacts you select are read, not the record’s other artifacts. A cited artifact shows under Sources. Click it to open the artifact. If one of an artifact’s files can’t be read, the draft continues without it, and the draft review names the file under “Not read, so not used in this draft.”

Files and artifacts share a limit of 20 context items. Each file counts as one item, including each file attached to a selected artifact, and an artifact with no files counts as one. The dialogs show how many items are selected. Artifacts that would take the selection past 20 can’t be selected, and you can’t start a draft while the selection is over the limit. Clear a file or an artifact to bring it back under.

The agent reads PDFs and text files, such as code, notebooks, Markdown, YAML, JSON, CSV and plain text files. It reads notebooks as their text and code cells, without outputs or images. Images, video, audio, zip files and Office files such as .docx, .xlsx and .pptx are not offered. Text files larger than 10 MB are skipped, and only the first 100,000 characters of a long text file are read. If a file can’t be read, the draft continues without it.

Check the evidence behind a drafted block

Each block inserted from a draft shows an AI Draft tag. Click the tag to see:

  • The AI model that wrote the draft, who requested it, and when it was accepted. If someone edited the block afterwards, it also says “Edited since drafted with AI.”
  • Evidence used — The evidence this block cites, the same items as the Sources list in the review. Click an item to open it. A test result opens the exact version the draft read on the record’s Data page.14
  • Evidence reviewed — Everything the agent read while drafting the section, including evidence it did not use.

Tables and figures in drafted text

A draft can place a table or figure from a test result right where its text discusses that result, with a caption. These tables and figures are live:

  • They show the latest values when the test runs again, without a redraft.
  • You can move or delete them in the editor, but not edit them.
  • If the table or figure no longer exists, for example because the test was renamed, a “Result not found” notice shows in its place.
  • Exports include the actual table or figure at that position.15

A draft can also write its own short table with only the values a section discusses, such as precision for each class. The full result stays one click away in the block’s evidence.

Keep drafts current when evidence changes

When evidence that a drafted block cites changes, the block’s tag turns orange and reads Evidence updated. The same tag shows next to the section in the table of contents, and the Draft Document box on the right says how many sections reference updated evidence. Hover over the tag in the table of contents to see what changed.

For test results and record fields, a block is flagged only when the evidence it rests on changed in content:

  • A test result counts as changed when its values changed. A test that runs again with the same values does not flag the block. A result logged for the test under a new result ID also flags the block, and only a redraft picks it up.
  • A block written from record fields is flagged only when one of those fields changes. The reason names the field, such as “Purpose updated 2 hours ago.”

Other evidence, such as metrics, attachments, and documents and artifacts added as context, flags the block whenever it is updated, even if the values it cites stay the same. For a document, any edit flags the block, not only an edit to the section it cites. For an artifact, any edit to the artifact or to its files flags the block. Blocks drafted before evidence tracking are also flagged on any update.

To bring a flagged block up to date:

  1. Click the Evidence updated tag on the block and review what changed under Evidence has changed.

  2. Choose how to update it:

    • Update Values — Keeps the wording and changes only the values whose evidence changed. Review the highlighted changes, then click Update Block. If none of the cited values changed, click Mark Up to Date instead.
    • Redraft Section — Opens Draft Section for the block’s section so you can draft it again.16

Update Values warns you when a redraft is the better choice, for example when a test ran again as a new result or a conclusion may no longer hold. Edits you made by hand are kept. For a block drafted before evidence tracking, or a block that rests on fields you can’t see, Update Values can’t compare the values and asks you to redraft the section.

To update every flagged section at once, expand the Draft Document box on the right and use Update Values or Regenerate Stale Sections. Regenerate Stale Sections drafts each section with the files, documents and artifacts it was last drafted with.

When a section has insufficient source material

If the agent finds too little evidence for a block, it writes a short note in italics instead of a draft: “Insufficient source material to draft this section.” The note names what to add to the record, such as a model purpose or development documentation.

Add the missing information to the record, for example by completing record fields, logging test results or attaching files and adding them as context, then draft the section again. Replace or delete the note before you submit the document.

Get notified when a draft finishes

When you start a Draft Document run, My Inbox shows a Document draft in progress update with the run’s live progress. When the run finishes or fails, that update becomes the outcome update below and is marked unread. These updates are not emailed.17

  • Document draft is ready for review — Says how many sections had insufficient source material, if any. Click it to open the document with the drafts ready for review.
  • Document draft failed — Gives the reason. A failed Draft Section run also sends this update and names the section.

Stopping a draft sends no update.

Refine selected text

Use Refine text to have AI rewrite a passage you select in a document, for example to make it shorter or plainer, or to turn it into a table. The AI reads the passage with the rest of its block and can use the test results logged to the record. You review the suggestion before it replaces your text.

  1. Open the document and click the text block or test description you want to change.

  2. Select the passage, then click Refine text in the toolbar that appears next to the selection.

  3. (Optional) Describe how the text should change, such as “shorter,” “use a table to compare these results” or “add the ROC AUC plot after this paragraph.”

  4. Click Refine.

    A preview of the rewrite shows under Suggested text.

  5. Choose what to do with the suggestion:

    • Replace — Replaces the selected text with the suggestion.
    • Try again — Asks for a new suggestion. You can change your instructions first.
    • Cancel — Closes Refine text without changing your text.

Your text changes only when you click Replace. The new text is saved with the block like any other edit. Clicking outside the block also closes Refine text without changes.

  • Tables and figures — The suggestion can include lists and tables, and tables and figures from test results logged to the record. Images that were already in your selection are kept. Other images can’t be added.
  • Requests the AI can’t complete — If part of your request can’t be done, for example a plot for a test with no results on the record, a note above the preview explains why.
  • Numbers — If the suggestion leaves out numbers from your selection, or states numbers that aren’t in the block, a warning lists them under “Check the numbers.”
  • Track changes — With track changes on, Replace adds the rewrite as a suggested change that others can accept or decline.18
  • Who can use it — Refine text appears when you can edit the document. It doesn’t appear when you can only view or comment on a document. If the passage is too long, you are asked to select a shorter one.

What’s next