Visual Paradigm はそのAI ダイアグラム作成チャットボットに、2 つの追加の C4 モデルダイアグラムタイプをサポートする機能を追加しました：C4 システムランドスケープダイアグラムおよびC4 ダイナミックダイアグラム.
今回のアップデートにより、アーキテクト、開発者、ビジネスアナリスト、プロジェクトチーム、技術文書作成者は、自然言語のプロンプトを使用して、より幅広いソフトウェアアーキテクチャダイアグラムを生成できるようになりました。AI C4 ダイアグラムツールは、組織のシステムの高レベルな視点から、特定のワークフローにおけるそれらのシステムの相互作用の詳細な視点へとユーザーを移行するのを支援できるようになりました。
新しい機能は、チャットボットの既存の C4 システムコンテキスト、C4 コンテナ、C4 コンポーネント、および C4 デプロイメントダイアグラムへのサポートを拡張します。これらのダイアグラムタイプを組み合わせることで、周囲の技術エコシステムからシステムの内部コンポーネントおよびランタイム相互作用に至るまで、異なる抽象化レベルでソフトウェアアーキテクチャを探求するための実用的な方法が提供されます。
今すぐ AI C4 ダイアグラム生成ツールを試すそして、可視化したいアーキテクチャを記述してください。
続行する前に、本発表の核心となる概念を示す以下のインフォグラフィックをご覧ください。
AI C4 ダイアグラムツールで何が新しくなったのでしょうか？
Visual Paradigm の AI ダイアグラム作成チャットボットは、今後は以下を生成できるようになりました：
- C4 システムランドスケープダイアグラムこれは、企業またはソフトウェアシステムを取り巻くシステム、人々、組織、および外部サービスを示すものです。
- C4 ダイナミックダイアグラムこれは、コンテナやその他のアーキテクチャ要素が、特定のユースケースやビジネスシナリオを完了するためにどのように相互作用するかを示すものです。
これらの追加は重要です。なぜなら、アーキテクチャの理解には、システム境界の静的な視点だけでなく、システムが動作するより広範なランドスケープと、ビジネスプロセスを機能させる相互作用の順序を理解する必要があるからです。
C4 システムランドスケープダイアグラムは、主な質問が以下のときに役立ちます：この環境に関与しているシステムと外部アクターは何ですか？
C4 ダイナミックダイアグラムは、主な質問が以下のときに役立ちます：これらのシステムまたはコンテナは、特定のシナリオを完了するためにどのように協力しますか？
両方のビューをサポートすることで、AI C4 ダイアグラム生成ツールは、チームが戦略的なアーキテクチャに関する議論と、実装レベルのワークフローを結びつけるのを支援します。
C4 システムランドスケープおよびダイナミックダイアグラムが重要な理由
C4 モデルは、一連の補完的なダイアグラムを通じてソフトウェアアーキテクチャを伝達するために広く使用されています。各ダイアグラムは異なる質問に答え、異なる詳細レベルを対象としています。
コンテキストダイアグラムは、システム、そのユーザー、および外部システムとの関係を説明します。コンテナダイアグラムは、システム内の主要なアプリケーション、サービス、データベース、およびメッセージキューを示します。コンポーネントダイアグラムは、コンテナの内部構造を説明します。デプロイメントダイアグラムは、ソフトウェアが技術環境内でどこで実行されるかを示します。
新たにサポートされたダイアグラムは、非常に有用な 2 つの視点を追加します：
- このシステムランドスケープ図 1 つのソフトウェアシステムを超えて視野を広げ、ステークホルダーが完全な技術環境を理解するのを支援します。
- 「ダイナミック図」は、振る舞いとシーケンスを追加し、選択されたシナリオにおいてアーキテクチャ要素がどのように連携するかを示します。
これにより、AI C4 ダイアグラムツールは、アーキテクチャの発見、システム計画、統合分析、オンボーディング、技術レビュー、近代化イニシアチブ、およびドキュメント作成においてより有用になります。
単一のシステムを超えたアーキテクチャを理解する
多くのエンタープライズシステムは孤立して動作しません。e コマースプラットフォームは、決済ゲートウェイ、倉庫システム、物流プロバイダー、税務当局、会計サービス、顧客関係管理プラットフォーム、およびレガシーエンタープライズリソースプランニングシステムに依存する可能性があります。
システムランドスケープ図は、これらの関係を1つの視覚的ビューにまとめます。これにより、チームは以下を特定できます。
- 企業が所有および運用しているシステムはどれか
- アーキテクチャと相互作用するアクターは誰か
- 重要なビジネス機能を支援するサードパーティサービスはどれか
- レガシーシステムが運用ランドスケープの一部として残っている場所
- データとビジネスプロセスがシステム間でどのように移動するか
- どの統合がAPI、メッセージング、バッチ処理、ファイル転送、またはその他の技術を使用しているか
これは、エンタープライズアーキテクチャ計画、プラットフォーム近代化、合併・買収分析、統合計画、およびシステム依存関係レビューにおいて特に価値があります。
ビジネスシナリオが実際にどのように機能するかを説明する
ランドスケープ図は「何があるか」を示します。ダイナミック図は「何が起こるか」を示します。
例えば、注文配置ワークフローは、顧客がAPIゲートウェイを通じてチェックアウトリクエストを送信することで開始される可能性があります。その後、リクエストは注文サービスにルーティングされ、注文データベースに保存され、支払いサービスに送信され、サードパーティの決済ゲートウェイによって承認され、在庫サービスに対して照会されます。支払いと在庫が確認されると、注文は確認済みとしてマークされ、イベントバスに公開されて、下流の履行、通知、および分析プロセスに渡されます。
C4 ダイナミック図は、相互作用を順序立てたシナリオ中心のビューで提示するため、このワークフローを議論しやすくします。アーキテクトは、これを使用して依存関係、同期呼び出し、非同期イベント、潜在的な障害ポイント、および補償フローを特定できます。
例：AIを使用してC4システムランドスケープ図を生成する
新機能を実演するために、AIダイアグラムチャットボットを使用して、グローバルe コマース企業のランドスケープ図を生成しました。
プロンプトは次の通りでした。
顧客の相互作用、サードパーティの決済ゲートウェイ、倉庫履行システム、およびレガシーERP統合を示すグローバルe コマース企業向けのC4システムランドスケープ図を生成してください。
AI C4 ダイアグラム生成器は、外部参加者、企業範囲、主要システムなどを含むランドスケープを生成しました。
生成された関係には、REST、HTTPS、非同期メッセージング、バッチ処理、SFTP、EDI、SOAP、および変更データキャプチャなどの意味のある相互作用の説明と技術もラベル付けされていました。
これにより、生成された図は単なるボックスと矢印の集まりを超えたものになります。これは、システムの所有権、統合スタイル、運用依存関係、および近代化の優先順位について議論するための出発点となります。
共有された例の会話を見るAI C4 ダイアグラムツールがC4システムランドスケープ図をどのように生成したかを確認するために。
例：AIを使用してC4ダイナミック図を生成する
ランドスケープ図を生成した後、AI C4 ダイアグラム生成ツールに、eコマースプラットフォーム内の特定のワークフローを説明するよう依頼しました。
プロンプトは以下の通りです：
API ゲートウェイを介して顧客が注文を行う手順を段階的に示す、E-Commerce Platform 内の C4 ダイナミック図を生成してください。
生成されたダイナミック図は、顧客、プラットフォーム、および外部システム間の相互作用を示しました。
この例は、C4 ダイナミック図が C4 システムランドスケープ図をどのように補完できるかを示しています。ランドスケープ図は完全なエコシステムを説明する一方、ダイナミック図はそのエコシステム内の重要なユースケースの 1 つに焦点を当てます。
自然言語のプロンプトからアーキテクチャ図へ
アーキテクチャ図を手動で作成するのは時間がかかることが多く、特に初期要件がまだ不完全であったり、非公式なビジネス言語で表現されていたりする場合です。チームは自分が何を説明したいかを理解していても、まだ明確な視覚的構造を思い描けていないことがあります。
AI ダイアグラムチャットボットは対話型のアプローチを提供します。ユーザーはシステム、シナリオ、利害関係者、技術、または統合要件を平易な言葉で記述できます。その後、AI は図を生成し、追加の指示を通じてレビューおよび改良を行うことができます。
例えば、C4 ダイナミック図を生成した後、ユーザーは AI に以下を依頼できます：
- 不正検出サービスを追加する
- 支払い拒否の経路を表示する
- 在庫不足のシナリオを含める
- 注文イベントバスを非同期統合として表現する
- リトライおよびタイムアウトの動作を追加する
- 倉庫履行コンシューマーを表示する
- サービスの名称を変更するか、その責任を変更する
- 選択した要素の目的を説明する
- 図のドキュメントを生成する
- コンテナを掘り下げて、より詳細な図を作成する
この対話型ワークフローは、チームがアーキテクチャを反復的に探索するのを支援します。一度のセッションで完璧な図を作成しようと試みるのではなく、ユーザーは高レベルの説明から始め、理解が深まるにつれてモデルを段階的に改善できます。
AI に図を説明するよう依頼する
図の生成は体験の一部に過ぎません。ユーザーは AI ダイアグラムチャットボットに、生成された図を説明するよう依頼することもできます。
これは、図を異なる技術知識レベルを持つ人々がレビューする必要がある場合に役立ちます。アーキテクトは統合パターンやシステム境界を検討したいと思うかもしれません。プロジェクトマネージャーはビジネスフローの簡潔な概要を必要とするかもしれません。開発者はサービスの責任とデータの流れを理解したいと思うかもしれません。新しいチームメンバーは、アーキテクチャのガイド付き説明を必要とするかもしれません。
ユーザーは以下のような質問をすることができます：
- このシステムランドスケープの目的は何ですか？
- どのシステムが企業境界の外にありますか？
- 主要な注文処理フローは何ですか？
- どの統合が同期処理ですか？
- 非同期処理はどこで始まりますか？
- 支払い承認に失敗した場合、どうなりますか？
- 在庫予約に関与するコンポーネントはどれですか？
- この図に示されている主なアーキテクチャ上のリスクは何ですか？
- このアーキテクチャの技術的概要を生成してください。
- この図を非技術的な利害関係者に説明してください。
その結果、アーキテクチャ図を扱う方法がよりインタラクティブになります。図はプレゼンテーションのためだけに作成された静的な画像ではなく、分析、議論、ドキュメント作成、意思決定の起点となります。
図を PNG、SVG、またはコピーした画像としてエクスポートする
図が生成されると、ユーザーはチャットボットインターフェース内で直接それを表示できます。図ビューアは結果の視覚的表現を提供し、一方、コードビューアはユーザーに基盤となるコードとしての図へのアクセスを提供します。
コードビューアはマルチタブインターフェースを使用しており、ユーザーは生成された成果物の間で切り替えて、図の背後にあるコードを検査できます。これは、AI 生成ビジュアルの利便性と、テキストベースの図作成ワークフローの制御の両方を求めるユーザーにとって有用です。
以下が図ビューです：
以下は、C4 図を PlantUML コードで示すコードビューです：
ユーザーは生成された図を以下としてエクスポートできます：
- プレゼンテーション、レポート、メール、一般的な共有用の PNG
- スケーラブルで高品質なドキュメント作成および出版用の SVG
- 他のアプリケーションに素早く貼り付けるためのコピーした画像
視覚的な出力と編集可能な図コードの両方があることで、探索から実用的な利用への移行が容易になります。チームは AI で最初のドラフトを生成し、視覚的な結果を確認し、さらに編集するためにコードをコピーするか、完成した図をプロジェクト資料で使用するためにエクスポートできます。
Visual Paradigm VPasCode で図の改良を続ける
AI 生成図は最初のドラフトを加速するための優れた方法ですが、アーキテクチャ作業にはしばしば精密な調整が必要です。ユーザーはコードとしての図の出力を「Visual Paradigm VPasCode」に送信し、コード中心のワークフローを使用して図を微調整して改良できます。
VPasCode は、ユーザーが以下を行いたい場合に特に有用です：
- 図の構文に精密な変更を加える
- ラベル、関係、レイアウト、およびスタイルを調整する
- 図をテキストベースの成果物として維持する
- ソースコードとレンダリングされた図を一緒に確認する
- PlantUML または他のサポートされているコードとしての図フォーマットで作業を続ける
- 図の変更を再現しやすく、維持しやすくする
これは、AI 支援によるアーキテクチャ発見と手動によるコードとしての図の改良の間に自然なワークフローを作成します：アーキテクチャを記述し、最初のバージョンを生成し、視覚的な結果を検査し、その後、ソースをより精密に編集します。
図を OpenDocs に送信して、生きたドキュメントを作成する
アーキテクチャ図は、それらを説明するドキュメントと接続されたままの場合に最も価値があります。ユーザーは生成された図を Visual Paradigm パイプラインに送信し、「Visual Paradigm OpenDocs.
これにより、以下を組み合わせたドキュメントの作成が容易になります：
- アーキテクチャ図
- システムおよびサービスの説明
- ビジネスプロセスの説明
- 統合の詳細
- アーキテクチャの決定事項
- 運用ノート
- 技術手順
- プロジェクトおよび納品情報
例えば、チームは電子商取引プラットフォーム用のC4システムランドスケープ図を生成し、OpenDocsに送信してアーキテクチャ概要ページに配置できます。その後、C4ダイナミック図を注文処理ページに挿入し、支払い承認、在庫予約、イベント公開、および納品引き継ぎの説明を追加できます。
これにより、図の作成とその意味の伝達との間のギャップを縮めることができます。図をチャットセッションのままにしておくか、孤立した画像としてエクスポートするのではなく、チームはそれをより広範なドキュメント構造に組み込むことができます。
アーキテクチャに関する会話をVisual Paradigm NotesKeepに保存する
アーキテクチャに関する議論には、貴重な決定事項、説明、仮定、およびフォローアップのアイデアが含まれることがよくあります。AI図描チャットボットを使用すると、ユーザーは図、完全な返信、または選択したフレーズや段落を「Visual Paradigm NotesKeep」に送信できます。.
これは以下の内容を保存するのに役立ちます：
- アーキテクチャの根拠
- 設計上の仮定
- 統合に関する決定事項
- レビュー中に提起された質問
- 複雑な図の説明
- 潜在的な障害および補償フロー
- 将来の改善と近代化の機会
- AI生成の技術議論からの重要な抜粋
例えば、電子商取引アーキテクチャの例を生成した後、チームはレガシーERP統合の説明をノートとして保存したり、提案された支払い障害パスを保存したり、納品引き継ぎに非同期イベントを使用するという決定を記録したりできます。
AI生成の図をノートやドキュメントと接続することで、このワークフローは視覚的な作成だけでなく、知識の収集と長期的なコラボレーションもサポートします。
AI C4図生成器の有用なシナリオ
新しいC4図の機能は、幅広いアーキテクチャおよびエンジニアリング活動をサポートできます。
エンタープライズアーキテクチャの発見
C4 システムランドスケープ図を使用して、ビジネスシステム、外部サービス、ユーザー、部門、および統合依存関係をマッピングします。これにより、アーキテクチャワークショップやシステムインベントリレビューのための共通の起点が提供されます。
アプリケーションの近代化
モダンなサービス、レガシープラットフォーム、データベース、バッチジョブ、およびサードパーティシステム間の関係を可視化します。生成された図は、チームが移行の境界、統合リスク、および段階的な近代化の機会を特定するのに役立ちます。
API および統合計画
C4 ダイナミック図を使用して、ビジネス取引に関与する API 呼び出し、イベント、データベース更新、および外部サービスインタラクションのシーケンスを説明します。
技術オンボーディング
新しいチームメンバーに、組織のシステムのランドスケープビューを提供し、重要なワークフローがどのように機能するかをシナリオベースで説明します。
アーキテクチャレビュー
レビュー会議の前に初期図を生成し、その後フォローアッププロンプトを使用して、欠落している依存関係を追加し、境界を明確にし、障害パスを探ります。
要件分析
非公式な要件を、プロダクトオーナー、アナリスト、アーキテクト、および開発チームがレビューできる視覚的なアーキテクチャモデルに変換します。
ドキュメンテーションと知識共有
図と説明を一緒に生成し、その結果を OpenDocs または NotesKeep に送信して、プロジェクトライフサイクル全体で継続的に使用できるようにします。
C4 図のための効果的なプロンプトの書き方
AI C4 図ツールは自然言語の説明から動作できますが、スコープ、アクター、システム、関係、および希望する詳細レベルを特定すると、プロンプトはより有用になります。
強力なプロンプトには以下が含まれる場合があります：
- 図の種類（例：C4 システムランドスケープまたは C4 ダイナミック）
- モデル化されているビジネスドメインまたはシステム
- 関与する人々、役割、または外部アクター
- 含めるべき内部システム、コンテナ、またはサービス
- サードパーティシステムおよびレガシープラットフォーム
- 主要な関係およびデータフロー
- 示すシナリオまたはワークフロー
- 関連する技術または通信プロトコル
- 図の視聴者
システムランドスケープ図の場合は、以下のようなプロンプトを試してください：
医療機関向けの C4 システムランドスケープ図を生成してください。患者、臨床医、管理者、患者ポータル、電子医療記録、ラボシステム、薬局システム、保険提供者、ID サービス、および外部報告当局を含めてください。主要なインタラクションを示し、組織が運営するシステムと外部システムを区別してください。
ダイナミック図の場合は、以下のようなプロンプトを試してください：
フードデリバリープラットフォーム向けの C4 ダイナミック図を生成し、顧客が注文を出す方法を示してください。モバイルアプリ、API ゲートウェイ、注文サービス、レストランサービス、支払いサービス、配送配車サービス、データベース、およびイベントバスを含めてください。注文の送信から支払い承認、レストランの受諾、配送員の割り当て、顧客の確認までのシーケンスを示してください。
その後、ユーザーは追加の指示で結果を洗練させることができます。例えば、AI にエラーハンドリングを追加させる、非同期イベントを表示させる、レガシー統合を含める、または選択されたサービスの責任を説明させるなどです。
アーキテクチャのアイデアから再利用可能なプロジェクト成果物へ
この機能強化の主な利点は、AI がさらに 2 つの図タイプを描画できるようになることだけではありません。より大きな利点は、ユーザーが Visual Paradigm エコシステム内でより完全なアーキテクチャワークフローを追跡できることです。
- アーキテクチャまたはビジネスシナリオを自然言語で記述します。
- C4 システムランドスケープ図または C4 ダイナミック図を生成します。
- AI に図の説明、改良、または拡張を依頼します。
- 視覚的な出力を確認し、背後にある図コードを検証します。
- 図を PNG または SVG としてエクスポートするか、画像としてコピーします。
- VPasCode でコードとしての図を微調整します。
- 図を OpenDocs に送信して構造化されたドキュメントを作成します。
- 会話、図、または選択した説明を NotesKeep に保存します。
このワークフローはコンテキストスイッチングを減らし、チームが要件、図、説明、ソースコード、ドキュメント間のつながりを維持するのを支援します。
強化された AI C4 図生成器を試す
C4 システムランドスケープ図および C4 ダイナミック図のサポートが追加されたことで、ユーザーは AI を活用してソフトウェアアーキテクチャを探求し、コミュニケーションを取るためのより多くの手段を得ます。
企業またはプラットフォームを取り巻く完全な環境を理解する必要がある場合はシステムランドスケープ図を使用します。特定のユースケースに関わる相互作用を説明する必要がある場合はダイナミック図を使用します。これらを C4 コンテキスト図、コンテナ図、コンポーネント図、デプロイメント図と組み合わせることで、アーキテクチャのより完全で多層的なビューを作成できます。
新しいプラットフォームの計画、レガシー統合の分析、API のドキュメント作成、ビジネスワークフローのレビュー、開発チームのオンボーディングのいずれであっても、AI C4 図ツールは、アイデアから意味のある視覚モデルへより迅速に移行するのを支援できます。
新機能の実践を見るには、次のものを探索してください共有された C4 E コマースアーキテクチャの会話.