AI Agent (Claude)

ourCAD má vestavěného LLM agenta postaveného na Claude Sonnet 4.6. Napiš co chceš v přirozeném jazyce, agent volá modelovací tooly a sestaví parametrickou geometrii.

Spuštění

1. Otevři dokument (může být prázdný nebo už obsahovat geometrii).
2. Toolbar → Modeling 3D → AI agent (Claude)…
3. Otevře se chat dialog s textovým polem.

Jak to funguje

1. Pošleš zprávu (např. "udělej desku 60×40×8 mm s 4 dírami M6 v rozích").
2. Backend pošle zprávu do Anthropic API spolu s definicí 15 toolů a kontextem dokumentu.
3. Claude rozhodne, které tooly zavolat a v jakém pořadí.
4. Backend tooly vykoná přes loopback na vlastní HTTP API (s tvým tokenem, takže auth/ownership funguje stejně jako klikání).
5. Backend vrátí výsledek Claude, který může pokračovat dalším tool callem nebo skončit.
6. Frontend zobrazí transcript — uživatelské zprávy, Claude odpovědi, tool calls + výsledky — live přes SSE streaming.
7. Po dokončení se editor sám reloaduje a vidíš novou geometrii.

Tool sada (15 toolů)

Tool	Popis
get_features	Inspekce stavu dokumentu — list features s parametry
create_rectangle_sketch	Obdélník w×h v XY/XZ/YZ
create_circle_sketch	Kruh ⌀ d v XY/XZ/YZ
extrude_sketch	Sketch → solid (distance v mm)
revolve_sketch	Sketch → solid of revolution (angle v stupních, axis X/Y/Z)
create_hole	Cylindrická díra do tělesa (diameter, depth, x/y/z)
fillet	Zaoblit všechny hrany tělesa (radius)
chamfer	Zkosit všechny hrany tělesa (distance)
linear_pattern	Lineární pattern feature (count, spacing, direction X/Y/Z)
circular_pattern	Kruhový pattern (count, total_angle, axis)
boolean_union	A ∪ B — sjednocení dvou těles
boolean_subtract	A − B — odečtení
boolean_intersect	A ∩ B — průnik
translate_feature	Posunout těleso o dx/dy/dz mm
delete_feature	Smazat feature (kaskáda na dependents)

Příklady promptů

Jednoduchá geometrie

• "udělej desku 100×60×8 mm"
• "válec průměr 30 výška 50"
• "kostka 30×30×30"

S díry

• "deska 80×40×6 s dírou Ø8 uprostřed"
• "deska 100×100×10 s 4 dírami Ø6 v rozích, 10 mm od krajů"

Pokročilé

• "hřídel průměr 30 délka 100 se zápichem šířky 5 uprostřed"
• "L-profil 50×50×3 délka 200" (vyžaduje boolean_union nebo dva extrudy)
• "kruhový flange ⌀60 s 6 šrouby M6 po obvodu na ⌀45" (circular_pattern)

Iterace přes follow-up zprávy

Konverzace si pamatuje předchozí turny:

Turn 1: "udělej desku 100×60×10"
        → agent vytvoří rectangle + extrude

Turn 2: "ted přidej díru Ø10 uprostřed"
        → agent ví o body_id z předchozího kroku, vytvoří hole

Turn 3: "zaobli všechny hrany 2 mm"
        → fillet aplikován na celé těleso

Turn 4: "udělej z toho 4× linear pattern, vzdálenost 50 mm"
        → linear_pattern volání

Konverzační paměť

Frontend si drží celý transcript a posílá ho s každým novým Send. Tím má LLM kontext o předchozích krocích — žádný re-run, žádný re-prompt.

Tlačítko "Nová konverzace" wipuje stav — použij když chceš začít čistě nebo když začne agent zmatkovat (LLM si občas pamatuje moc).

Streaming

Endpoint /api/v1/agent/chat-stream používá Server-Sent Events. Při každé iteraci agenta (po Claude odpovědi) frontend dostane:

• status — "Iterace N — calling_claude"
• assistant_text — text bloky od Claude
• tool_call — jméno toolu + args
• tool_result — výsledek tool execution
• done — kompletní transcript + stats

Status banner v dialogu ukazuje aktuální fázi v real-time.

Coordinate convention

Agent zná tato pravidla, ale je dobré je vědět taky:

• Extrude na XY plane o H mm → tělo na Z=0..H (top face Z=H)
• Default sketch plane je XY (top view)
• Default direction pro hole je -Z (vrtání shora)
• Circle/rectangle sketch jsou centrované na origin
• Mass properties / kóty v mm

Limity

Agent dělá pouze sketch-based geometrii. Counterbore/countersink, custom 2D křivky (B-spline), sweep podél složité 3D křivky — to jsou věci ne v současné tool sadě. Pro to použij UI nebo low-level MCP toolset přes Claude Code.

Konfigurace

AI agenta zapíná správce instalace na straně serveru. Pokud aplikace hlásí, že agent není dostupný, obrať se na svého správce.

Další AI funkce

Auto-dimensioning (drawing)

V Drawing módu → Auto kóty 🤖 — vyber view, klikni tlačítko, agent navrhne ≤8 kót dle ISO 129 (overall bbox + diameters + dlouhé hrany).

Revize dokumentu

DocumentDialog → Verze tab → „AI revize" spustí PR-style audit feature tree proti zvolenému baselině (default HEAD).

Dialog vrátí strukturovanou odpověď:

• Verdict badge:
  • 🟢 ✓ Approve — bez problémů
  • 🔵 ⊙ Komentáře — drobné poznámky, lze pustit dál
  • 🔴 ⚠ Změny požadovány — blockery
• Shrnutí — italická věta o tom, co se změnilo a jak to vypadá
• Diff summary — +5 / −2 / ~3 features (added / removed / modified)
• Issues list — per-issue: severity (Chyba/Pozor/Info), kategorie, popis + „Locate" tlačítko (vybere feature ve FeatureTree)
• Baseline info — proti kterému commitu (SHA + první řádek commit zprávy)

Volá POST /api/v1/agent/document-review, trvá ~10–25 s. Užitečné před stagem do release branch.

Návrhy zjednodušení (Simplification)

Agent prochází feature tree a označí redundantní / nadbytečné features s návrhem „smazat" nebo „sloučit" (např. 0,1 mm fillet hned za extrude, který se utopil v dalším booleanu). FeatureTree item dostane 🤖 badge s tooltipem návrhu.

Návrhy topologie nad FEA výsledky

Po dokončení FEA simulace může agent analyzovat von Mises stress mapu a navrhnout strukturální úpravy:

• „Zde se soustřeďuje stress → přidat materiál (thicken wall)"
• „Zde je low stress → zde můžeš odebrat (local pocket / topology slimming)"

Návrhy jsou ve výsledkovém panelu jako inline hints. LLM-in-the-loop pomáhá zkrátit iteraci optimalizace topologie.

Jazyk komunikace agenta

Agent respektuje jazyk aplikace (Settings → Language → Auto / Čeština / English). Při češtině:

• Chat odpovědi v češtině
• Error hlášky v češtině
• DocumentReview verdict + issues v češtině
• GD&T návrhy s českými termíny (Kolmost místo Perpendicularity)

Přepínání bez nutnosti reloadu.

Náklady

Každý turn agent volá Claude API minimálně 1× (víc pokud má tool calls). Ceny per turn obvykle pod $0.05 pro jednoduchou geometrii, do $0.20 pro komplexní s mnoha kroky. Sleduj usage.input_tokens + output_tokens v Anthropic Console.

Co dál

• MCP Server — externí Claude Code/Desktop integrace s 30 tooly (víc než vestavěný agent)
• 3D Modeling — co všechno agent může technicky vytvořit
• Drawings — auto-kóty a AI revize
• Simulation — FEA s AI návrhy topologie