如何为智能生成的图表编写更好的查询
随着大型语言模型和人工智能工具的日益普及,查询编写(也称为提示工程)正成为一项重要的技能。编写一个好的查询来确保任何类型的内容生成器都能产生理想的结果并非易事。以下是如何充分利用draw.io 的 图表生成功能。

工作原理
在模板管理器中输入文本查询,draw.io 会将其提交给一个大型语言模型工具——draw.io 会自动选择最适合您指定图表类型的工具。该 AI 工具会处理您的查询,并以Mermaid 语法或 draw.io XML 格式返回图表。如果图表是使用 draw.io 内置形状(而非 Mermaid)生成的,您可以轻松地设置图表样式和更新图表。
生成的图表对于流程图、序列图、概念图和树状图等较简单的图表类型,或者用于头脑风暴,可能是一个不错的起点。Mermaid 不支持使用更复杂符号(例如AWS、Azure、BPMN等)的技术图表。但是,您可以轻松地从 draw.io 的形状库中拖放这些形状,以替换生成的图表中使用的通用形状。
重要提示:与所有人工智能或智能内容生成工具一样,您不应包含任何敏感信息——请勿在您编写的任何查询中包含任何私人、个人和机密商业信息。
如果您使用的是 Confluence 或 Jira Cloud 版 draw.io 应用,则默认情况下图表生成功能处于禁用状态。请联系您的管理员,在其实例设置中的 draw.io 应用配置中启用此选项。
生成智能模板图
打开模板库:单击“排列”>“插入”>“模板”,或创建一个新图表以打开模板库对话框。如果您使用“简易模式”或“草图”编辑器主题,请单击+工具栏中的“模板”图标并选择它。
从文本生成图表:点击模板库首页的“生成”按钮,即可显示一个文本框,您可以在其中输入文本查询。点击“确定”
Enter按钮提交至生成器。
打开“生成”对话框:单击闪光工具或从菜单中 选择“排列”>“插入”>“生成” ,然后在“生成”对话框中输入您的提示。

从搜索字段生成图表:直接在搜索字段中输入查询,然后选择“生成”。

使用相同的描述生成另一个版本
每次使用相同的查询生成或重新生成图表时,生成的图表都会有所不同。
编辑您的查询:点击右上角的铅笔图标,然后重新提交以生成不同版本的图表。点击右上角的放大镜图标或将鼠标悬停在图表上,即可查看图表的放大预览。

如果您在“生成”对话框中,请单击查询下方的编辑铅笔图标,将其粘贴到查询字段中,然后再次提交查询,以生成图表的另一个版本。

请继续阅读,了解如何编写更好的查询语句和生成更好的图表。
首先写出图表类型。
这将指示生成器将图表类型限制为您想要的类型。例如,序列图。
sequence diagram - a customer purchases a product from an online store

提示:添加vertical或horizontal可以告诉生成器朝该方向绘制图形。
保持语言简洁一致
语言要简洁明了,使用标点符号并尽量使用多句。确保在图表中始终使用相同的术语来指代每个参与者或系统。
以下示例比上面序列图的提示越来越复杂。
flowchart - A customer signs up for a 14-day trial software license. After 10 days, a sales engineer contacts the customer to learn their requirements, then writes the customer a quote. If the customer does not accept the quote, their software license is invalidated on day 15. If the customer accepts the quote, they can continue to use the software.

添加细节以提高准确性
如果您想要生成详细且合适的图表,并且不想进行太多编辑就能得到最终图表,那么您需要包含所有重要的细节。
以上述例子为例,选择不接受报价的客户不应被允许开始另一个免费试用期。
vertical flowchart - A customer signs up for a 14-day trial software license. Has the customer already had a trial license? Yes - the customer must contact a sales engineer. No - Customer can use the software for 14 days.After 10 days, a sales engineer contacts the customer to learn the customer's requirements and writes the customer a quote.

如您所见,生成的图表——实际上所有类型的生成内容——几乎都需要编辑。客户应该收到的是报价,而不是量身定制的解决方案。
将其拆分成多个简短的查询
由于生成器只接受短查询,并忽略超过一定长度的任何内容,因此您需要将描述分成几个部分,并将多个生成的图表添加到绘图画布中。
例如,让我们从前面的示例中删除定制解决方案步骤,并为流程中的剩余步骤插入第二个生成的图表。
vertical flowchart - The sales engineer writes a quote to the customer.If the customer does not accept the quote, their software license is invalidated on day 15 and their email address is added to a block list. If the customer accepts the quote, and payment is processed successfully, they can continue to use the software.
使用美人鱼语法中的术语
由于生成器使用 Mermaid 语法输出图表,因此使用Mermaid 语法文档中的术语来描述图表可以获得更好的结果。例如,用户旅程被分解为sections包含tasks具有幸福感的阶段value。
journey diagram - title Work day - two sectionsProductive section has - task brainstorming value 5, task meeting value 2, task pair programming value 3. Leisure section has - task lunch value 5, task yoga value 5.

相比之下,使用高、中、低而不是数值来描述评分系统则更为自然。
journey - Show how I break my work day into two. When I'm productive, I rate brainstorming high, meeting low and pair programming average, and in my leisure time, I have lunch and do yoga, and rate both highly

