Visual Paradigm AI 聊天機器人可讓您根據應用程式、其使用者及其互動的外部系統的純文字描述，建立 C4 系統情境圖。然而，AI 生成的圖表在生成後仍能保持可編輯與可維護時，才最具實用價值。

本指南展示了一個使用 C4-PlantUML 建立外送平台情境圖的完整工作流程。您將學習如何將 AI 生成的圖表轉換為可編輯的 PlantUML 程式碼，在 VPasCode 中精進模型，並在 Visual Paradigm Online 中繼續進行視覺化編輯。此方法結合了 AI 輔助建模的速度、圖表即程式碼的彈性，以及圖形化圖表編輯器的便利性。

Visual Paradigm 提供了一套實作流程，可將自然語言的架構描述轉換為可編輯的 C4 情境圖：

1. 在 Visual Paradigm AI 聊天機器人中描述該系統。

   

2. 建立並檢視 C4 系統情境圖。

3. 在 VPasCode 中以 C4-PlantUML 格式開啟結果。

   

4. 透過編輯 PlantUML 程式碼來修改圖表。

   

5. 可選：將結果傳送至 Visual Paradigm Online。

   

6. 使用拖放式圖表編輯器以視覺化方式修改圖表。

這為您提供了兩種編輯路徑：

• 基於程式碼的編輯：VPasCode 與 C4-PlantUML

• 基於圖形使用者介面（GUI）的編輯：Visual Paradigm Online 圖表編輯器

Visual Paradigm 的 AI 聊天機器人支援 C4 系統情境圖、容器圖、元件圖與部署圖。它也能透過自然語言指令（例如新增、移除、重新命名或重新連接元素）來精進已生成的圖表。

1. 了解 C4 情境圖

C4 情境圖是軟體系統的最高層級視圖。它顯示：

• 「感興趣的系統」

• 人類使用者與組織參與者

• 外部軟體系統

• 這些元素之間的重要關係

• 每項關係運作方式的簡短說明

它通常不會顯示內部服務、資料庫、類別、API 或基礎設施細節；這些內容應屬於較低層級的 C4 圖表。

例如，線上外送平台的情境圖可能包含：

• 顧客

• 餐廳經理

• 外送司機

• 支付服務提供者

• 地圖與地理定位服務

• 通知服務

• 外送平台

中央系統應保持為視覺焦點，外部人員與系統應置於其周圍。

2. 準備良好的 AI 提示

所生成圖表之品質高度依賴於提供給聊天機器人之架構描述。

有用的提示應指定：「

• 系統名稱

• 系統目的

• 使用系統之人員

• 與其溝通之外部系統

• 彼此之間的關係

• 所需的 C4 圖表層級

• 所需的輸出格式

• 不應包含的內容

範例提示

為線上外送平台建立 C4 系統情境圖。

感興趣之系統：
外送平台 — 允許顧客瀏覽餐廳、下單、付款及追蹤外送。

人員：
1. 顧客 — 瀏覽餐廳、下單、付款及追蹤外送。
2. 餐廳經理 — 管理菜單、接受訂單及更新訂單狀態。
3. 外送司機 — 接受外送任務及更新外送進度。
4. 營運管理員 — 監控平台活動並處理支援問題。

外部系統：
1. 付款提供者 — 授權並扣款顧客付款。
2. 地圖與地理定位服務 — 提供地址、路線及外送地點。
3. 通知服務 — 發送電子郵件、簡訊及推播通知。

關係：
- 顧客使用外送平台瀏覽餐廳、下單、付款及追蹤外送。
- 餐廳經理使用外送平台管理菜單並處理訂單。
- 外送司機使用外送平台接收外送任務及更新外送狀態。
- 營運管理員使用外送平台監控營運並解決問題。
- 外送平台使用付款提供者進行授權與扣款。
- 外送平台使用地圖與地理定位服務計算路線及追蹤位置。
- 外送平台使用通知服務發送通知。

請生成清晰的 C4 系統情境圖。請勿顯示內部容器、元件、資料庫、類別或部署基礎設施。使用簡潔的關係標籤。

明確指示排除內部細節至關重要。若缺少此指示，AI 生成器可能會產生混合情境層級與容器層級資訊的圖表。

3. 在 Visual Paradigm AI 聊天機器人中生成圖表

開啟 Visual Paradigm AI 聊天機器人，並開始新的對話或圖表生成工作階段。

視介面與訂閱版本而定，聊天機器人可能會提供圖表類型選擇器。請選擇：「

• C4 模型

• 系統情境圖

接著輸入提示。

Visual Paradigm 的一般聊天機器人工作流程如下：「

1. 描述圖表。

2. 讓 AI 生成初始模型。

3. 檢視結果。

4. 使用自然語言指令進行精修。

5. 匯出或在其他 Visual Paradigm 工具中繼續編輯。

檢視第一個結果

檢查圖表是否包含：

• 恰有一個核心系統

• 所有必要的人員

• 所有相關的外部系統

• 正確的關聯方向

• 簡潔的關聯描述

• 無不必要的內部服務或資料庫

• 命名一致

• 佈局清晰可讀

生成的圖表僅為起點，不能取代架構審查。

4. 透過對話精進圖表

聊天機器人可使用一般語言修改圖表。

新增元素

新增一位客戶支援專員，該專員使用外送平台調查客戶問題並處理退款。

新增外部系統

新增一個外部詐欺偵測服務，外送平台將使用該服務評估可疑付款。

重新命名元素

將「通知服務」重新命名為「訊息與通知服務」。

變更關聯

將外送員與外送平台之間的關聯變更如下：
「接收外送指派並提交外送狀態更新。」

移除元素

從圖表中移除營運管理員。

改善佈局

重新排列圖表，使人員位於上方、外部系統位於下方，且外送平台保持居中。

簡化圖表

將此簡化為嚴格的 C4 系統情境圖。移除實作細節、資料庫、API、微服務與內部元件。

請求一致性審查

檢視圖表是否存在遺漏的關聯、模糊的標籤、重複的系統，以及不屬於 C4 情境圖的元素。

AI 聊天機器人文件描述了此迭代方法，包含新增支付閘道、重新命名元素、變更關聯以及重構圖表的指令。

第一部分：在 VPasCode 中開啟圖表以進行程式碼編輯

5. 使用「在 VPasCode 中開啟」或「在 VPasCode 中編輯」

生成並精修圖表後，請使用標示類似以下的操作：

• 在 VPasCode 中開啟

• 在 VPasCode 中編輯

• 開啟程式碼

• 產生程式碼以供編輯

按鈕的確切標籤可能因當前介面而有所不同。

此操作將圖表的程式碼轉移到 VPasCode，您可以在其中以文字形式編輯圖表，同時檢視即時渲染的預覽。Visual Paradigm 將 VPasCode 描述為支援 PlantUML、C4 模型、Mermaid、Graphviz 及其他語法格式的瀏覽器型圖表即程式碼編輯器。

產生的程式碼應使用 C4-PlantUML，通常包含：

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
...
@enduml

產生的腳本可能使用不同的包含網址或內部支援的函式庫版本。除非您有特定理由需要變更，否則請保留 VPasCode 所產生的包含指令。

6. 理解 C4-PlantUML 的結構

典型的 C4-PlantUML 情境圖包含以下部分：

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

LAYOUT_LEFT_RIGHT()

Person(customer, "Customer", "Places food orders and tracks deliveries.")
System(platform, "Food Delivery Platform", "Allows customers to order food and track delivery.")
System_Ext(payment, "Payment Provider", "Authorizes and captures payments.")

Rel(customer, platform, "Places orders and tracks deliveries")
Rel(platform, payment, "Authorizes and captures payments")

@enduml

主要元素類型

第一個參數是內部識別碼。第二個是顯示名稱。第三個是描述。

7. 在 VPasCode 中編輯圖表

VPasCode 通常顯示：

• 編輯器窗格中的原始碼

• 預覽窗格中渲染的圖表

• 用於匯出、分享、複製或在另一個 Visual Paradigm 產品中開啟結果的操作

VPasCode 提供即時渲染並支援直接程式碼編輯。當程式碼貼上編輯器時，它也能偵測支援的圖表格式。

範例：改進後的 C4-PlantUML 程式碼

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

title 外送平台 — 系統情境

LAYOUT_LEFT_RIGHT()
SHOW_LEGEND()

Person(customer, "客戶",
  "瀏覽餐廳、下單、付款並追蹤外送進度。")

Person(restaurantManager, "餐廳經理",
  "管理菜單、接受訂單並更新訂單狀態。")

Person(deliveryDriver, "外送司機",
  "接收外送指派並更新外送進度。")

Person(operationsAdmin, "營運管理員",
  "監控平台營運並處理支援問題。")

System(platform, "外送平台",
  "支援餐點訂購、付款、餐廳管理與外送追蹤。")

System_Ext(paymentProvider, "付款服務商",
  "授權並扣款客戶付款。")

System_Ext(mapService, "地圖與地理定位服務",
  "提供地址、路線與位置資料。")

System_Ext(notificationService, "通知服務",
  "發送電子郵件、簡訊與推播通知。")

Rel(customer, platform,
  "瀏覽餐廳、下單、付款並追蹤外送")

Rel(restaurantManager, platform,
  "管理菜單並處理餐廳訂單")

Rel(deliveryDriver, platform,
  "接收外送工作並提交外送狀態")

Rel(operationsAdmin, platform,
  "監控營運並處理支援問題")

Rel(platform, paymentProvider,
  "授權並扣款")

Rel(platform, mapService,
  "計算路線並追蹤外送位置")

Rel(platform, notificationService,
  "發送訂單、付款與外送通知")

@enduml

8. 進行常見的程式碼層級變更

變更系統名稱

System(platform, "餐點外送平台",
  "協調餐點訂購與外送。")

新增一個人員

Person(customerSupport, "客戶支援專員",
  "調查客戶問題並處理退費。")

Rel(customerSupport, platform,
  "調查問題並處理退費")

新增一個外部系統

System_Ext(fraudService, "詐欺偵測服務",
  "評估可疑的付款活動。")

Rel(platform, fraudService,
  "檢查付款交易以評估詐欺風險")

變更關聯方向

Rel(paymentProvider, platform,
  "傳回付款授權與結算結果")

使用關聯方向來表示主要依賴或互動。若方向在架構上並不重要，請選擇一致的慣例並應用於整個圖形。

變更佈局

C4-PlantUML 支援佈局提示，例如：

LAYOUT_LEFT_RIGHT()

或：

LAYOUT_TOP_DOWN()

您也可以使用方向提示來影響置放位置：

Lay_R(客戶，平台)
Lay_D(平台，付款提供者)

謹慎使用佈局提示。過多手動約束會使圖表更難維護。

9. 使用 VPasCode AI 輔助功能

部分 VPasCode 版本提供 AI 輔助的圖表修改與程式碼錯誤修復功能。該工具可接受以下類型的指令：

在平台與付款提供者之間新增外部詐欺偵測服務。

或：

修正 PlantUML 語法錯誤，並保留目前的圖表結構。

VPasCode 亦被文檔記載支援 AI 驅動的圖表修改、錯誤診斷與翻譯功能，但可用性可能取決於版本或訂閱方案。

10. 驗證 PlantUML 圖表

在將圖表傳送給 Visual Paradigm Online 之前，請驗證其語法與架構。

語法檢查清單

• 腳本以以下內容開頭：@startuml.

• 腳本以以下內容結尾：@enduml.

• 已包含 C4-PlantUML 函式庫。

• 每個關聯皆引用現有的識別符。

• 識別符不包含可能破壞語法的空白或標點符號。

• 引號已正確配對。

• 描述未過於冗長。

• 預覽可正常顯示且無錯誤。

C4 建模檢查清單

• 存在一個明確識別的目標系統。

• 使用者以「人員」建模，而非以「軟體系統」建模。

• 外部應用程式以「外部系統」建模。

• 內部容器不納入情境圖中。

• 關係描述有意義的互動。

• 此圖表無需閱讀原始程式碼即可理解。

• 術語與專案的架構文件相符。

不適當的系統情境圖元素範例

Container(api, "訂單 API", "Java", "處理訂單")
ContainerDb(database, "訂單資料庫", "PostgreSQL", "儲存訂單")

這些是容器層級的元素。它們應屬於 C4 容器圖，通常不屬於系統情境圖。

第二部分：將圖表傳送至 Visual Paradigm Online

11. 使用「在 VP Online 中編輯」或「在 VP Online 圖表中編輯」

確認程式碼版本正確後，選擇標記類似以下的動作：

• 在 VP Online 中編輯

• 在 VP Online 圖表中編輯

• 在線上開啟

• 匯出至 VP Online

確切標籤可能因介面版本而有所不同。

Visual Paradigm 的生態系統旨在將 AI 聊天機器人產生的圖表移至 VPasCode 進行程式碼層級的細化，再移至 Visual Paradigm Online 進行傳統圖表編輯。

當您需要以下功能時，線上圖表編輯器非常實用：

• 手動移動形狀

• 調整元素大小

• 調整連接線

• 變更顏色與字型

• 新增註記或註解

• 新增標題或圖例

• 套用簡報格式

• 精確對齊圖表元素

• 準備圖表以進行分享或匯出

12. 使用 Visual Paradigm Online 圖形使用者介面修改圖表

當圖表在 Visual Paradigm Online 中開啟後：

移動元素

將人員與外部系統拖曳至中央系統周圍，形成清晰的佈局。

常見的佈局如下：

• 人員位於左側或上方

• 主要系統位於中央

• 外部系統位於右側或下方

編輯文字

雙擊元素或選取其規格面板以修改：

• 名稱

• 說明

• 類型

• 關聯標籤

請保持名稱簡短，說明內容詳盡。

編輯關聯

選取連接器以：

• 變更其方向

• 編輯關聯標籤

• 將其重新連接至另一個元素

• 調整其路由

• 變更線條樣式或外觀

新增元素

使用圖表工具列以新增：

• 人員

• 外部人員

• 系統

• 外部系統

• 關聯

• 註解

• 邊界

僅添加屬於情境層級的要素。

套用格式

您可以透過調整以下項目來提升可讀性：

• 字體大小

• 填充顏色

• 邊框顏色

• 線條粗細

• 形狀大小

• 對齊方式

• 間距

• 連接線佈線

避免僅以顏色作為傳達意義的唯一方式，同時應使用清晰的標籤。

13. 建議的展示佈局

一個清晰的上下文圖表可能採用此佈局：

對於較大的圖表：

• 將主要系統置於中心位置。

• 將人員群組置於一側。

• 將外部軟體系統群組置於另一側。

• 避免關係線交叉。

• 在可能的情况下，保持關係標籤為水平方向。

• 使用簡短標籤，而非段落。

• 在中央系統周圍保留足夠的空白空間。

第三部分：在程式碼編輯與圖形介面編輯之間選擇

VPasCode 透過 PlantUML 支援 C4 模型並提供即時預覽，而 Visual Paradigm Online 則提供傳統的視覺圖形編輯工作流程。

第四部分：建議的端到端工作流程

快速工作流程

1. 開啟 Visual Paradigm AI 聊天機器人。

2. 選擇 C4 系統情境圖。

3. 描述系統、使用者與外部系統。

4. 產生圖形。

5. 請聊天機器人移除內部實作細節。

6. 檢視名稱、關聯性與範圍。

7. 選擇 在 VPasCode 中開啟.

8. 編輯 C4-PlantUML 原始碼。

9. 渲染並驗證結果。

10. 選擇 在 VP Online 中編輯.

11. 使用圖形使用者介面 (GUI) 精細調整佈局與外觀。

12. 匯出或分享最終圖表。

建議的職責分工

使用「AI 聊天機器人」：「

• 建立初稿

• 探索架構替代方案

• 新增或移除參與者

• 重述關係描述

• 檢視圖表以確認遺漏項目

使用「VPasCode」：「

• 重新命名多個元素

• 重複使用圖表程式碼

• 套用一致的語法

• 在版本控制中管理程式碼

• 執行可重複的結構變更

• 修正佈局指示

• 產生基於文字的真實來源

使用「Visual Paradigm Online」：「

• 最終視覺定位

• 簡報格式設定

• 手動調整連接器

• 新增註解與註記

• 為利害關係人準備圖表

第 5 部分：範例精煉對話

初始請求

為外送平台建立 C4 系統情境圖。

精煉 1

將顧客、餐廳經理、外送司機與營運管理員新增為人物角色。

精煉 2

將付款服務提供者、地圖與地理定位服務、以及通知服務新增為外部系統。

精煉 3

移除所有資料庫、API、微服務、容器與實作細節。此圖必須維持為 C4 系統情境圖第 1 層級。

精煉 4

將所有關聯標籤改寫為簡潔的動詞片語，並在可能的情況下保持字數在 10 字以內。

精煉 5

檢視圖表是否有遺漏的關聯與不一致的術語。請將「外送平台」保留為唯一的關注系統。

精煉 6

將圖表產出為 C4-PlantUML 格式，並在 VPasCode 中提供編輯功能。

第 6 部分：除錯

圖表包含過多細節

詢問：

將此簡化為嚴格的 C4 系統情境圖。移除容器、元件、資料庫、API 與技術名稱。

圖表有太多交叉線

在 VPasCode 中：

• 嘗試LAYOUT_LEFT_RIGHT()或LAYOUT_TOP_DOWN().

• 新增有限的Lay_指示指令。

• 縮短關聯標籤。

• 減少顯示的關聯數量。

• 將最終版本移至 VP Online 以進行手動定位。

PlantUML 預覽顯示錯誤

檢查：

• C4 函式庫包含

• 缺少逗號

• 未閉合的括號

• 識別字拼寫錯誤

• 關聯指向未定義的元素

• 引號未平衡

• 元素名稱不正確

關聯必須指向已宣告的識別字，例如：

Person(customer, "Customer", "Places orders")
System(platform, "Food Delivery Platform", "Processes orders")

Rel(customer, platform, "Places orders")

GUI 版本與程式碼版本不同

轉換後將這兩個版本視為獨立的編輯表示形式。請明確決定哪一個是真實來源：

• 使用 VPasCode 作為真實來源，如果圖表將以程式碼形式維護。

• 使用 Visual Paradigm Online 作為真實來源，如果利害關係人將經常以視覺方式調整它。

避免在未同步的情況下在兩個位置進行無關的變更。

產生的圖表使用了錯誤的 C4 層級

詢問聊天機器人：

僅重新生成為 C4 系統情境圖。顯示人員、感興趣的系統以及外部軟體系統。請勿顯示容器或元件。

最終品質檢查清單

在發布圖表前，請確認以下事項：

• 圖表具有清晰的標題。

• 感興趣的系統一目了然。

• 人員與外部系統的分類正確無誤。

• 關係具有有意義的標籤。

• 無內部實作細節洩漏至情境視圖中。

• 名稱使用一致的術語。

• 圖表在正常縮放比例下可清晰閱讀。

• 關係線不會遮蓋形狀或標籤。

• PlantUML 原始碼能成功渲染。

• VP Online 版本與已核准的架構相符。

• 最終圖表已由熟悉該系統的人士進行審查。

最高效的工作流程是：使用 AI 聊天機器人進行快速建模，使用 VPasCode 進行精確且可重複的 C4-PlantUML 編輯，並使用 Visual Paradigm Online 進行最終視覺優化。此流程將對話式生成、圖表即程式碼的可維護性以及基於圖形介面的呈現編輯整合於單一流程中。