Skip to main content
DiagramAI can create a new diagram or modify the diagram currently open in the editor. In both cases, describe the structure you want rather than only the visual style.

​
Choose a diagram type

Use Auto when the structure makes the intended format clear. Select a type when you need a specific notation.

​
Structure your prompt

A useful prompt usually contains:
  1. The diagram type and purpose
  2. The components or participants
  3. The order or relationships
  4. Important branches, boundaries, or exceptions
  5. Labels that must appear
Use product and domain names consistently. Explicit names produce more useful labels than phrases such as “the service” or “the database.”

​
Create a new diagram

1

Choose the destination

Open the folder where the diagram should be stored, or stay at the workspace root.
2

Open AI generation

Select AI generate, choose a diagram type, and enter your prompt.
3

Submit and review

Submit the request. DiagramAI validates the generated draw.io document, creates a file, and opens the editor.

​
Modify the current diagram

Open the AI panel inside the editor and describe the change in relation to the existing diagram.
DiagramAI reads the current diagram before applying the request. If generation fails or the returned document is invalid, the canvas is not replaced.

​
Credit usage

  • DiagramAI estimates whether your balance is sufficient before sending a request.
  • A successful request consumes credits based on its actual token usage.
  • A failed request does not consume credits.
  • AI requests in a personal workspace use your personal balance.
  • AI requests in a team workspace use the organization’s shared balance.
See Plans, credits, and billing for included balances and purchase rules.
AI output can be incomplete or inaccurate. Review a diagram before relying on it for implementation, operations, security, or other important decisions.