> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diagram.eoeok.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 AI 创建图表

> 选择图表类型、编写有效提示词，并使用 AI 调整生成结果。

DiagramAI 可以创建新图表，也可以修改编辑器中当前打开的图表。无论哪种方式，都应优先描述需要的结构，而不只是视觉样式。

## 选择图表类型

当描述已经能够明确图表结构时，可以使用**自动**。如果必须遵循特定图表表达方式，请直接选择类型。

| 类型   | 提示词中应包含的内容         |
| ---- | ------------------ |
| 流程图  | 起点、终点、步骤、判断条件和分支结果 |
| 架构图  | 系统、服务、存储、外部依赖和数据流  |
| 时序图  | 参与者、消息顺序、响应和异常路径   |
| ER 图 | 实体、重要字段、键和关系基数     |
| 思维导图 | 中心主题、主要分支和下级内容     |
| 拓扑图  | 区域、网络、节点、连接和边界     |

## 组织提示词

有效的提示词通常包含：

1. 图表类型和用途
2. 组件或参与者
3. 执行顺序或相互关系
4. 重要分支、边界或异常情况
5. 必须显示的标签

```text theme={null}
为一个多租户 SaaS 应用创建架构图。
包含 Web 客户端、API 网关、身份认证服务、应用服务、
PostgreSQL 数据库、Redis 缓存、对象存储和后台任务进程。
展示公网和私有网络之间的信任边界，
并标记同步请求与异步任务。
```

<Tip>
  对同一个产品或领域对象使用一致的名称。明确的名称通常比“这个服务”或“那个数据库”更容易生成有用标签。
</Tip>

## 创建新图表

<Steps>
  <Step title="选择保存位置">打开准备保存图表的文件夹，也可以停留在工作空间根目录。</Step>
  <Step title="打开 AI 生成">选择 **AI 生成**，选择图表类型并输入提示词。</Step>

  <Step title="提交并检查">
    提交请求。DiagramAI 会验证生成的 draw\.io 文档，创建文件并打开编辑器。
  </Step>
</Steps>

## 修改当前图表

在编辑器中打开 AI 面板，结合现有图表描述需要的修改。

```text theme={null}
保留当前布局。在支付服务后增加重试队列，
将支付失败事件连接到队列，再连接回支付任务进程。
```

DiagramAI 会先读取当前图表，再应用修改。如果生成失败或返回的文档无效，当前画布不会被替换。

## Credits 用量

* DiagramAI 会在发送请求前估算余额是否足够。
* 成功请求按照实际 token 用量消耗 credits。
* 失败请求不消耗 credits。
* 个人工作空间使用个人余额。
* 团队工作空间使用组织共享余额。

请阅读[套餐、积分与账单](/zh/plans-and-credits)，了解套餐包含的余额和购买规则。

<Warning>
  AI 输出可能不完整或不准确。在将图表用于开发、运维、安全或其他重要决策前，请自行检查。
</Warning>