{"uid":"cap_V2MKjCYnIxGNWv-6GBhTv","slug":"cloud-world-model-simulation-explain-21711ae7","name":"Cloud World Model – Simulation Explain","description":"Simulate AWS, GCP, Azure, OCI, and DigitalOcean cloud infrastructure without provisioning real resources. Built for Canvas Cloud AI learners and agents.","url":"https://www.cloudworldmodel.ai/api/simulations/%7BsimulationId%7D/explain","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"beginnerMode":{"type":"boolean","description":"Return a simplified, jargon-free explanation"}}},"responseSchema":{"type":"json","example":{"explanation":"Your simulation is experiencing high CPU utilization (82%) because the traffic load of 8 000 RPS exceeds the capacity of the current 3-node cluster. The autoscaler has not yet triggered because CPU has not been above the 75% threshold for the required 2-step cooldown window."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2Jhp7ywpT53kASNBE3Xop","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a plain-language or technical explanation of what is currently happening in a running cloud infrastructure simulation","exampleAgentPrompt":"I'm running a cloud simulation on Cloud World Model and I'm not sure what's going on — can you explain the current state of simulation abc-123 in simple, beginner-friendly terms so I can understand what's happening with my cluster?","exampleUseCases":[{"title":"Beginner understanding a CPU spike","prompt":"My Cloud World Model simulation is showing some kind of CPU issue and I have no idea what it means — can you explain simulation xyz-789 in plain language, no jargon please?"},{"title":"Diagnosing why autoscaler didn't fire","prompt":"In my simulated AWS environment (simulation id: sim-456), the autoscaler didn't seem to kick in even though traffic was high — can you explain what happened in technical detail?"},{"title":"Instructor reviewing student simulation","prompt":"I need a technical explanation of what's going on in simulation stu-001 so I can walk my students through why their simulated GCP cluster failed under load — full technical detail please."}],"resultDescription":"A natural-language explanation string describing the current state of the simulation, including metrics, root causes, and system behavior (e.g. CPU utilization percentage, RPS, autoscaler threshold status). In beginner mode the explanation avoids jargon; in standard mode it is technical.","failureModes":["simulationId not found or expired — 404 with unknown simulation error","simulationId path variable missing or malformed — 400 bad request","simulation not yet in a state that can be explained (still initializing) — may return empty or pending explanation","service unavailable if simulation backend is down — 503","payment not attached or insufficient — 402 Payment Required"],"whenToPreferThis":"Use this endpoint when a user or agent needs to understand the current state or behaviour of an already-running cloud simulation rather than starting or modifying one. It is ideal for educational contexts (Canvas Cloud AI learners), post-incident review of simulation runs, and agent-driven diagnosis loops where the agent needs to read back what the simulation is experiencing before deciding next steps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:02.917Z","isFirstParty":false}