SOLIDWORKS errors
These are document problems, not CADABRA problems. Ask Agent why the document is failing: it rebuilds, reads the diagnostics, and reports the root cause before it changes anything.
Start by asking Agent why
Open the failing document, pick Agent on the mode pill, and describe the symptom. Agent diagnoses before it repairs.
- It reads the document type, units and active configuration, and walks the whole FeatureManager design tree.
- It forces a rebuild and reads the feature warnings, and the component warnings as well on an assembly. You will see the rebuild happen in the SOLIDWORKS window.
- It checks external references and reports the broken and missing ones by name.
The rebuild is why this beats reading the error list. A stale list describes the document as it was before your last change; the diagnosis describes it as it is now.
Where the diagnostics show a problem it opens the affected feature and quotes the specific message rather than paraphrasing it. On a sketch fault it reads the parent sketch. On an assembly it validates the mates and finds the mates on any component carrying a warning.
Nothing is repaired until you ask. See finding out why a rebuild fails.
Worked examples
Send these in Agent Mode with the failing document open. Selecting the feature first is not required, naming it is enough.
- Cut-Extrude3 failed to rebuild. What happened?
- Rebuilds, quotes the diagnostic on Cut-Extrude3, then opens the feature and its parents to name what it lost. The report separates the error your last change caused from errors already in the file, and the blast radius lists the downstream features that depend on it.
- Why are there dangling relations in Sketch7?
- Reads the parent sketch and lists the broken and dangling relations, each row naming the entities it binds. The cause is a relation pointing at an edge or face that a parent feature no longer produces, so the fix is upstream of the sketch, not in it.
- This part has a broken external reference. Which one, and what consumes it?
- Runs the external reference check on its own and returns each row with the owning feature, the referenced entity, the owning component and the status. A missing file and an unresolved in-context reference report differently, so you know whether to repair a path or repair the geometry.
- Sketch2 is over-defined. Which constraints conflict?
- Reports the sketch constraint status, which is one of
UnderConstrained,FullyConstrained,OverConstrained,NoSolutionorInvalidSolution, and lists the relations with the indices that identify them, so you can delete the specific one rather than hunting. - The bracket will not mate correctly in this assembly. What is wrong?
- Validates every mate, including sub-assembly mates, and sorts them into healthy, suppressed, over-defined and error. It then finds the mates on the component you named, and checks interference or distance when clearance is the suspect.
Ask Mode, the read-only fallback
Ask Mode is on every plan including Free, and it reads the same document: the feature tree, the current selection, the assembly summary, and up to 12 features already in error or warning.
What it does not do is rebuild. It reports the errors SOLIDWORKS recorded at the last rebuild, so on a document you have edited since, the list can be stale. It also does not run the mate validation, the sketch introspection or the external reference check as a required step, though it can call them when the question points at them.
It changes nothing, which makes it safe on a released or checked-out file. When the answer implies a change it offers a Run in Agent handoff rather than making one. See Ask Mode.
Errors that appear after a CADABRA edit
The cause is the same as any other downstream failure: a feature depended on something the edit changed. What is different is the recovery.
CADABRA compares the rebuild errors before and after each operation, so an error it caused is reported differently from one that was already in the file. If a single operation fails after changing a value, the captured value is restored and re-read to confirm the restore, and if that restore fails the message names what could not be put back.
Revert is a feature-tree diff, not a SOLIDWORKS undo record. It deletes the features the run added and names them, names any it could not delete, and reports an in-place change that added no feature as not undone. Read what revert really does first, then decide between reverting and repairing.
Ask Agent to rebuild and check the document afterwards. It will tell you whether the tree is clean, which is the one thing the run itself cannot promise you.
Getting it fixed
A diagnosis changes nothing. Take the root cause it gives you to one of these.
- Fix it now: ask Agent for the repair, which it performs as native feature operations.
- See the repair first: ask Agent for the plan and approve it.
- The document is a drawing rather than a part or assembly: every prompt on an active drawing routes through Drawings Mode regardless of the mode on the pill, and needs Drawings access.
Nothing verifies that the repaired geometry is the geometry you wanted. CADABRA can tell you the rebuild is clean; it cannot tell you the result is right. Review it.