Drawbly

Drawbly technical notebook

Understand the system. Then draw your version.

Short technical explanations built around a question, a useful diagram and an editable example. Start with the system you need to explain.

Start here · AI systems

How does an AI agent actually use a tool?

Follow a single request through the model, an allowed tool call and the final answer. The diagram shows where the application checks and runs the call.

Read the workflow
Request, agent runner, trace tool and answer connected in a loop

Understand a system

Read the flow

Each example stays small enough to inspect, then links to a drawing you can change.

A retrieved page attempts to turn an instruction into a file-send call, which an application permission gate blocksAI systems · security exampleWhen a tool result tries to give ordersTrace a poisoned vendor page through an attempted file send and permission check. Four workshop events are replayed: eight seats opened, two reserved, two released by cancellation, and three reserved, leaving fiveBackend systems: worked exampleEvent sourcing: why keep old events?Replay a seat reservation, cancellation and read model to find the current value. Three quote API timeouts open a circuit breaker, which blocks the next request locally before one recovery probe succeedsBackend systems: worked exampleWhen does a circuit breaker stop a call?Follow five requests through closed, open and half-open states. Six requests straddle a ten-second boundary: a fixed window accepts all six, while a token bucket accepts three and rejects threeBackend systems: worked exampleWhy can six API requests pass at once?Compare a fixed-window reset with a refilling token bucket using the same arrivals. A browser app keeps verifier V and sends challenge H(V); code C plus V passes the token check, while stolen C alone failsBackend systems: worked exampleWhy a stolen OAuth code fails with PKCETrace a calendar connection through the S256 challenge, token check and its limit. A code push at 10:01 reaches a CI dashboard by webhook or a scheduled API poll at 10:05Backend systems: worked exampleWebhooks vs polling for a CI dashboardFollow one push, then compare missed delivery, duplicate events and recovery. Keyword and vector result lists both rank a fictional T-17 token rotation guide second, then merge it to firstAI systems · worked exampleHow hybrid search picks RAG contextCompare two candidate lists, their rank merge and the checks before answering. A report export shown as a flowchart of decisions and a sequence of client, API and worker messagesDiagram choice · worked exampleSequence diagram or flowchart?Compare the next decision with the message handoff for one report export. A RAG test separates a missing 400 rule in retrieval from an answer that contradicts the correctly retrieved ruleAI systems · worked exampleWhere did the RAG answer fail?Test one question at the retrieval boundary and again at the final claim. An API retry guide split between a 400 status code and its do-not-retry instruction, compared with a complete sectionAI systems · worked exampleWhere should a RAG chunk end?Keep a rule with its condition, then test the retrieved passage. A question about a late parcel is embedded and matched to a delayed-delivery policy passage, then checked for source and versionAI systems · worked exampleHow vector search finds RAG contextFollow a late-delivery question from embedding to a verified policy passage. One agent with two tools compared with a lead that delegates two independent searchesAI systems · decision guideWhen does a second agent help?Compare one context with two research workers and inspect the handoff. A changed email path moves from a direct API call to a queue and workerArchitecture · review practiceKeep the diagram currentA small code change that makes an old arrow wrong—and a way to catch it. An AI app host passes a read_issue request through an MCP client to an issue server, then receives the issue dataAI systems · worked exampleMCP client vs server: one tool callSee which part chooses the action, speaks the protocol and reads the issue. Two paths in a RAG pipeline: prepare documents, then retrieve context for a questionAI systems · illustrated guideWhat is a RAG pipeline?Separate the preparation step from what happens when someone asks a question. A lost response makes a retry create a second orderBackend systems · worked exampleA timeout, a retry and two ordersSee why a repeated request can create duplicate work, then compare the safer path. A trace walkthrough highlights the child span that dominates a slow requestBackend systems · worked exampleFind the slow part of a traceThree passes through a trace reveal where to investigate first. Browser, service, database and email provider in a small web appArchitecture · editable starterMap a small web appGive a teammate a useful first view of the system and change its labels.

Make the explanation clearer

Draw less. Show the difference.

Start with the Draft → Review → Publish bottleneck in the three-label diagram walkthrough; inspect the finished Drawbly drawing and try the same constraint on your own idea. Then watch the seven-second example in the drawing video pacing guide and compare when its labels, arrows and final highlight appear. The visual guides cover the canvas controls.

Browse editable diagrams