# Agent4

Agent4 is a rebuilt learning and assessment platform for SolidWorks modeling and ANSYS simulation education.

It separates the product into these roles:

- Knowledge standards: standard answers, extracted skillflows, teaching scripts, and assessment rules.
- Learning controller: teaching and testing sessions.
- C# backend: learning/testing API, SolidWorks extraction orchestration, and method-sensitive grading.
- Extractors: SolidWorks part and assembly feature extraction tools.
- Grader: compares student extracted operations with standard answers.
- Web workbench: teaching/testing UI.

## Current Scope

This first rebuild focuses on SolidWorks feature-process learning:

1. Search standard answers from the reducer knowledge framework and local skillflow JSON files.
2. Start a teaching session from a standard answer.
3. Generate step voice text from the expected SolidWorks feature operation.
4. Accept observed student steps or extract a submitted `.SLDPRT`.
5. Compare feature method and core parameters.
6. Start a testing session and produce a grade report.

## Run Backend

```powershell
cd D:\CSharpProjects\agent3\agent4
.\run_backend.ps1
```

Backend URL:

```text
http://127.0.0.1:7200
```

The default backend is now the C# API:

```text
backend-csharp/Agent4.Api
```

The earlier Python FastAPI backend remains as a fallback/reference and can be started with:

```powershell
.\run_backend_python.ps1
```

## Important APIs

```text
GET  /health
GET  /api/standards?query=榻胯疆
GET  /api/standards/{standard_id}
POST /api/teaching/sessions
POST /api/teaching/sessions/{session_id}/observations
POST /api/teaching/sessions/{session_id}/audit-part
POST /api/testing/sessions
POST /api/testing/sessions/{session_id}/submit
```

## Extractor Tools

The rebuilt project copies the existing extraction tools into:

```text
tools/modeling-process/PartFeatureAudit
tools/modeling-process/AssemblyKnowledgeAudit
```

`PartFeatureAudit` is the core for method-sensitive judgment. It can distinguish feature methods such as boss extrude, cut extrude, shell, loft, sweep, hole wizard, mirror, fillet, chamfer, linear pattern, and circular pattern.

## Import Standard Records

Extracted records such as `*_modeling_plan.json`, `*_skill_flow.json`, and
`*_skill_flow_validation.json` should be imported as standard-answer assets:

```powershell
cd D:\CSharpProjects\agent3
.\.venv\Scripts\python.exe agent4\scripts\import_standard_records.py --source "D:\Desktop\鎻愬彇璁板綍" --target "D:\CSharpProjects\agent3\agent4\data\standards"
```

The importer copies records into categorized folders and writes:

```text
agent4/data/standards/manifest.json
```

The manifest is the main lookup index for teaching and testing. The raw JSON
files remain the authority for executable and comparable feature traces.

## Architecture Direction

Agent4 should judge student work from extracted SolidWorks feature traces, not from UI button clicks.

```text
standard answer skillflow
  -> expected feature trace
student model or operation
  -> extracted feature trace
grader
  -> teaching feedback or test score
```

Final geometry comparison is secondary. Feature method correctness is primary for teaching.