[{"data":1,"prerenderedAt":323},["ShallowReactive",2],{"guide:\u002Finternal\u002Fdata-room\u002Fplace-documents-with-ai":3,"related:\u002Finternal\u002Fdata-room\u002Fplace-documents-with-ai":316},{"id":4,"title":5,"audience":6,"body":7,"canonical_url":285,"collection":286,"description":287,"extension":288,"feature_flags":289,"is_draft_preview":290,"legends":291,"meta":299,"navigation":300,"order":301,"path":302,"reading_minutes":303,"related":304,"seo":307,"slug":308,"status":309,"stem":310,"tour_ids":311,"type":313,"updated_at":314,"__hash__":315},"guides\u002Finternal\u002Fdata-room\u002Fplace-documents-with-ai.md","Place documents with AI","internal",{"type":8,"value":9,"toc":276},"minimark",[10,14,19,56,60,180,184,190,212,216,228,232,245,254,260],[11,12,13],"p",{},"Placing files one by one is fine for a handful of documents. For a whole upload, let the app do the first pass: it reads each unplaced Workspace file, compares it with the folders and placeholders in your Dataroom and their placement instructions, and proposes a slot for every file that clearly fits. You then review the proposals in one place. Nothing is placed until you accept a suggestion, and a file the AI is unsure about is simply left in the Workspace for you.",[15,16,18],"h2",{"id":17},"before-you-start","Before you start",[20,21,22,42,49],"ul",{},[23,24,25,26,30,31,35,36,41],"li",{},"The Dataroom has a structure to place into: folders and, ideally, placeholders with a short ",[27,28,29],"strong",{},"Placement instruction"," each. The instructions are what the AI matches against, so ",[32,33,34],"em",{},"Signed board minutes, one file per meeting"," produces better suggestions than an empty field. See ",[37,38,40],"a",{"href":39},"\u002Finternal\u002Fdata-room\u002Fbuild-the-dataroom-structure","Build the Dataroom structure",".",[23,43,44,45,48],{},"The files are uploaded and show ",[27,46,47],{},"Ready"," in the Workspace.",[23,50,51,52,55],{},"The data room is in ",[27,53,54],{},"Preparation",", or you are adding files to a published room whose structure already contains the right slots.",[15,57,59],{"id":58},"steps","Steps",[61,62,63,95,117,138],"ol",{},[23,64,65,66,69,70,73,74,77,78,81,82,85,86,89],{},"Start the AI in one of two ways. If you are uploading now, choose ",[27,67,68],{},"Place with AI"," in the upload dialog: the files are uploaded to the Workspace and, as soon as each one has been processed, its placement suggestion is created automatically, with nothing further to run. For files that are already in the Workspace, open the ",[27,71,72],{},"⋮"," menu next to ",[27,75,76],{},"Upload"," on the ",[27,79,80],{},"Dataroom"," tab and select ",[27,83,84],{},"Scan Workspace",". Both are offered only once the Dataroom has a structure, because that is what the AI matches the files against.",[87,88],"br",{},[90,91],"img",{"alt":92,"src":93,"title":94},"The Dataroom ⋮ menu with Scan Workspace","\u002Fmedia\u002Fplace-documents-with-ai\u002Fscan-workspace.png","Scan Workspace looks at every unplaced file; files that are already in the Dataroom are left alone.",[23,96,97,98,101,102,105,106,109,110,112],{},"Wait for the scan. It runs as a job in the background and reports its progress at the bottom of the page; a large batch can take a few minutes. When it finishes, the ",[27,99,100],{},"Review suggestions"," button at the top shows a red dot, and in the Workspace each file with a proposal shows a marker in its ",[27,103,104],{},"Index"," column with a tick to accept and a cross to reject right there. The filter next to the search field narrows the list to ",[27,107,108],{},"Pending suggestion",", so you can see at a glance what the AI proposed and what it skipped.",[87,111],{},[90,113],{"alt":114,"src":115,"title":116},"The Workspace filtered to Pending suggestion, with the marker in the Index column and the Review suggestions button","\u002Fmedia\u002Fplace-documents-with-ai\u002Fworkspace-pending-suggestions.png","A suggestion is a proposal, not a placement: the file is still only in the Workspace until you accept it.",[23,118,119,120,122,123,126,127,130,131,133],{},"For anything more than a couple of files, select ",[27,121,100],{}," to open ",[27,124,125],{},"Review Index suggestions",". The list on the left names every file with a proposal; selecting one shows on the right where it would go, whether that target is a folder or a placeholder, the name the file will carry in the index, and the ",[27,128,129],{},"AI rationale",": a short explanation of what the document is and why that slot was chosen. Search by filename, path or reasoning to find a particular file.",[87,132],{},[90,134],{"alt":135,"src":136,"title":137},"The Review Index suggestions dialog with one suggestion selected","\u002Fmedia\u002Fplace-documents-with-ai\u002Freview-index-suggestions.png","The rationale says what the AI read in the document. Accept places the file at the target; the tree below lets you choose a different one first.",[23,139,140,141,173,175,176,179],{},"Decide each suggestion:",[20,142,143,153,160,167],{},[23,144,145,148,149,152],{},[27,146,147],{},"Accept"," places the file at the proposed target with the proposed name. Tick several rows and use ",[27,150,151],{},"Accept selected"," for a batch.",[23,154,155,156,159],{},"To move it somewhere else, pick a folder or placeholder in the tree on the right and select ",[27,157,158],{},"Save target",", then accept.",[23,161,162,163,166],{},"Edit the ",[27,164,165],{},"Filename in Index"," if the proposed name is not what buyers should read. The name follows the project's AI file naming convention; the original filename stays in the Workspace.",[23,168,169,172],{},[27,170,171],{},"Reject"," drops the proposal and leaves the file in the Workspace.",[87,174],{},"A suggestion whose target no longer exists, for example because the placeholder was deleted, is marked ",[27,177,178],{},"Needs retarget"," and cannot be accepted until you choose a new target.",[15,181,183],{"id":182},"how-the-ai-decides","How the AI decides",[11,185,186,187,189],{},"The AI reads the processed text of each unplaced file and compares it with the Dataroom: folder names, placeholder names and, above all, the ",[27,188,29],{}," on each placeholder. A file gets at most one suggestion, and only when one slot is a clearly better fit than the rest; a file that could go in two places, or matches nothing, is left without a suggestion rather than guessed. That is why a scan over a hundred files typically proposes slots for most of them and leaves a handful for you.",[11,191,192,193,195,196,199,200,203,204,207,208,41],{},"Three things follow from this. Add or reword placeholders and instructions first, then run ",[27,194,84],{}," again; a rescan only looks at files that still have no placement. A suggestion made before the structure changed may point at a target that has since been deleted or moved, and is marked ",[27,197,198],{},"Target missing"," or ",[27,201,202],{},"Placeholder missing"," until you retarget it. And a file the AI keeps skipping is not stuck: place it by hand with ",[27,205,206],{},"Place in Dataroom","; see ",[37,209,211],{"href":210},"\u002Finternal\u002Fdata-room\u002Fplace-documents-in-the-dataroom","Place documents in the Dataroom",[15,213,215],{"id":214},"check-the-result","Check the result",[11,217,218,219,221,222,224,225,227],{},"Accepted files show their new index reference in the Workspace's ",[27,220,104],{}," column, appear under their placeholder on the ",[27,223,80],{}," tab, and the completion counter at the bottom of the Dataroom rises. The ",[27,226,100],{}," button no longer shows a dot once every suggestion has been handled.",[15,229,231],{"id":230},"if-something-goes-wrong","If something goes wrong",[233,234,236],"problem",{"title":235},"I don't see Place with AI in the upload dialog",[11,237,238,239,241,242,244],{},"The option appears only once the Dataroom has a structure to place into. A new project's Dataroom is empty until you apply a template, generate a structure, clone one or import one; see ",[37,240,40],{"href":39},". Until then uploads go to the Workspace, and you can run ",[27,243,84],{}," later. The option is also absent when placements are not possible at all, for example in a locked data room.",[233,246,248],{"title":247},"The scan found nothing to suggest",[11,249,250,251,253],{},"Suggestions are made only for files that clearly fit a folder or placeholder. Check that the Dataroom has placeholders for the kind of documents you uploaded and that their placement instructions describe them, then run ",[27,252,84],{}," again.",[233,255,257],{"title":256},"Scan Workspace is greyed out",[11,258,259],{},"The Workspace is empty, or a scan is already running. Wait for the job at the bottom of the page to finish.",[233,261,263],{"title":262},"A file was placed in the wrong slot",[11,264,265,266,268,269,271,272,275],{},"Accepting is the same as placing by hand: on the ",[27,267,80],{}," tab, open the file's ",[27,270,72],{}," menu and choose ",[27,273,274],{},"Move",". While the data room is in Preparation, placements can be moved or removed freely.",{"title":277,"searchDepth":278,"depth":278,"links":279},"",2,[280,281,282,283,284],{"id":17,"depth":278,"text":18},{"id":58,"depth":278,"text":59},{"id":182,"depth":278,"text":183},{"id":214,"depth":278,"text":215},{"id":230,"depth":278,"text":231},"https:\u002F\u002Fdocs.vdr.valutico.dev\u002Finternal\u002Fdata-room\u002Fplace-documents-with-ai","data-room","Let the app propose a Dataroom slot for every uploaded file that clearly fits, then accept, retarget or reject each suggestion.","md",[],false,{"review-index-suggestions":292,"scan-workspace":294,"workspace-pending-suggestions":296},[129,293,147],"Target",[295,84],"Menu next to Upload",[297,298,100],"Workspace filter","Index column with the suggestion",{},true,8,"\u002Finternal\u002Fdata-room\u002Fplace-documents-with-ai",5,[305,306],"how-the-dataroom-index-works","place-documents-in-the-dataroom",{"title":5,"description":287},"place-documents-with-ai","published","internal\u002Fdata-room\u002Fplace-documents-with-ai",[312],"index-manager","task","2026-09-29T13:21:45+02:00","N3w2AzZmd9tHRjC7AVOPBQNF9omecps1M2ZgcLbKekY",[317,321],{"title":318,"description":319,"path":320,"audience":6,"slug":305},"How the Dataroom index works","Folders, placeholders, index numbers and mapped files: the model behind the Dataroom, and every control that shapes it.","\u002Finternal\u002Fdata-room\u002Fhow-the-dataroom-index-works",{"title":211,"description":322,"path":210,"audience":6,"slug":306},"Move uploaded files into their Dataroom folders and placeholders, by hand or by reviewing AI suggestions.",1790706827421]