Chat Assistant

The AI chat assistant (H key) lets you interact with your design through conversation. The AI panel has four tabs: Chat, Spec, Code, and Map.

Capabilities

Action	Example prompt
Design	”Design a cafe with POS, kitchen, and order queue”
Ask	”What’s the weakest part of this architecture?”
Modify	”Add a cache between the API and database”
Analyze	”Which components are single points of failure?”
Explain	”Why is the queue backing up?”
Subsystem	”Zoom into the API gateway”

How it works

Type your message in the chat input and press Send. The AI uses your canvas context and conversation history to generate a response.

Review before apply

Every AI change goes through review. The chat shows a diff of proposed component and connection changes. Click Apply to accept or Reject to dismiss. This applies to first drafts, layout changes, and iterative modifications.

Component-specific chat

Select a component and use the chat to focus discussion on that single component. The AI will set behaviors, metrics, and requirements scoped to your selection.

Behavior assignment

Ask the AI to set component behaviors:

“Make the queue component filter out requests with priority < 3”

The AI will assign the appropriate behavior mode and configure its parameters. All 12 behavior modes are supported: passthrough, transform, filter, queue, split, delay, condition, retry, rate limit, circuit breaker, batch, and replicate.

File attachments

Attach files (.py, .txt, .md, .js, .ts, .json, etc.) to provide additional context. Useful for importing existing specs, requirements docs, or code snippets that inform your design.

• Up to 5 files per message
• Max 50KB per file
• Max 32,000 characters total (message + attachments)

Guided next steps

After each interaction, the AI suggests follow-up actions as clickable chips to push your design forward through the full loop: draft, simulate, stress test, analyze, revise.

Conversation context

The AI keeps the last 6 messages in full context. Older messages are compressed to 200 characters to save tokens while preserving conversation continuity.

Limits

• 32,000 character input limit per message (including attachments)
• 500 AI credits per month (Pro)
• Chat is a Pro feature

---

Spec tab

The Spec tab generates a full Product Requirements Document from your current canvas.

1. Open the AI panel with H
2. Click the Spec tab
3. Click Generate AI Spec

The AI analyzes your components, connections, behaviors, and simulation results to produce a structured markdown document covering:

• Overview (executive summary)
• Architecture (pattern and reasoning)
• Components (type, role, behavior, interfaces, dependencies)
• Data Flow (end-to-end trace, fan-out/fan-in, filtering, queuing)
• Failure Modes and Resilience (bottlenecks, cascade paths, hardening recommendations)
• Non-Functional Requirements (throughput, latency, capacity, scaling)
• Implementation Notes (tech stack, integration points, monitoring)
• Open Questions (3-5 gaps in the design)

You can copy the spec to clipboard or download it as a .md file.

Spec is a Pro feature.

---

Code tab

The Code tab generates a complete, runnable Python script from your canvas design.

1. Open the AI panel with H
2. Click the Code tab
3. Click Generate Python

The AI maps your components to Python classes with real implementation logic based on their descriptions and behaviors:

• Queue behavior maps to deque
• Retry maps to exponential backoff
• Circuit breaker maps to a state machine
• Rate limit maps to a sliding window
• Scaled components use ThreadPoolExecutor
• Protocol-appropriate client libraries (requests, grpc, websockets, pika, etc.)

The output includes a run_pipeline() function wiring everything together and a if __name__ == "__main__" entry point.

You can copy the code to clipboard or download it as a .py file.

Code is a Pro feature.