Docs

SysModeler — User Manual

13. The AI Agent (Chatbot)

SysModeler embeds an AI Agent that understands your model and can build, modify, and explain it through natural-language conversation.

13.1 Where to find it

  • As a panel in the workspace (right sidebar), so you can chat while you model.
  • As a dedicated chat view for longer sessions.
  • Undock it into a separate window for multi-monitor workflows.
  • Focus/unfocus the chat input with Alt + C.

13.2 Threads & session management

  • Use the dropdown to select or rename existing conversations.
  • Click + to open a new chat session.
  • History is saved and reloaded when you reopen a thread.
  • Use the message menu to jump to specific points in long conversations (Navigation & Layout).

13.3 System diagnostics

Monitor connection health via the WebSocket Connection indicator, and open the Help button for prompt guides and assistance.

13.4 Providing context

  • Add Attachment — upload local files, image references, or screenshots into the prompt context.
  • Mention File/Context (@mention) — tag specific project files or SysML models to pull their raw syntax directly into the AI's active context for analysis.
  • Add Reference to Chat — from the canvas, insert a selected node into the chat context to ask about it specifically (Section 10.5).

13.5 What the Agent can do

  • Answer domain-specific SysML questions and questions about your model.
  • Create, update, and delete diagram elements from natural language. When an action completes, affected elements are highlighted automatically and the diagram refreshes.
  • Generate model artifacts — code and structural definitions.
  • Stream responses live, with the steps it takes (tool actions) shown inline in a muted style; changed files are clickable, additions in green and removals in red.

13.6 Working with AI output

  • Copy message — copy any response or prompt.
  • Download code / tables — export a generated code snippet, or generated data tables into CSV/Excel.
  • Open file from path — click file paths mentioned in a response to open them directly in the editor.

13.7 Credits

AI Agent usage consumes credits from your plan. Organization accounts start with 3,000 free credits that refill monthly; if you hit your limit before the refill, AI actions pause until the allowance renews or your plan is upgraded (Billing). Ordinary modeling is unaffected. Viewers can use the AI to ask questions even though they cannot edit.