51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# CAD Agent Studio
|
|
|
|
CAD Agent Studio is a two-pane web app for agent-driven CAD work:
|
|
|
|
- left pane: agent chat, uploads, provider/model selection, and Viewer context cards
|
|
- right pane: embedded 3D preview and CAD edit toolbar
|
|
|
|
## Setup
|
|
|
|
Configure providers in `../../config/llm.config.yaml`. Prefer putting secrets in
|
|
the environment:
|
|
|
|
```bash
|
|
OPENAI_API_KEY=...
|
|
OPENAI_BASE_URL=https://api.openai.com/v1
|
|
DEEPSEEK_API_KEY=...
|
|
```
|
|
|
|
`OPENAI_BASE_URL` can point at an OpenAI-compatible third-party endpoint.
|
|
|
|
For local-only setups, providers may also use `apiKey: sk-...` directly in the
|
|
YAML. If `apiKeyEnv` accidentally contains a key value instead of an environment
|
|
variable name, the server treats it as a direct key for compatibility.
|
|
|
|
## Run
|
|
|
|
```bash
|
|
npm install
|
|
npm run dev -- -H 127.0.0.1 -p 53821
|
|
```
|
|
|
|
Open `http://127.0.0.1:53821`.
|
|
|
|
## CAD Flow
|
|
|
|
Uploads are stored under `../../models/agent-studio/<taskId>`. STEP/STP uploads
|
|
write a `cad-task.json` manifest and are converted to an STL preview sidecar
|
|
for the embedded right-pane WebGL renderer.
|
|
|
|
CAD Agent Studio does not start the standalone CAD Viewer service. Generated
|
|
models keep STEP as the primary CAD artifact and export STL as a preview mesh.
|
|
The right-pane toolbar mirrors the CAD Viewer edit tool set and interaction
|
|
shape, but tool picks are attached to the next agent request as structured
|
|
`cadViewer.editIntent` / `cadViewer.selection` context instead of being copied
|
|
to the clipboard. The handoff is silent in the UI: no success modal, no copied
|
|
text panel.
|
|
|
|
Modification requests create revision folders with `edit-request.json`. The
|
|
generation adapter should apply that request to the editable source recorded in
|
|
`cad-task.json`; STEP-only uploads are marked as reconstructed edits.
|