SWMM الوكالي: سير عمل نمذجة مياه الأمطار القابل للتدقيق والتكرار مع مهارات الوكيل وبروتوكول سياق النموذج Agentic SWMM: Auditable and Reproducible Stormwater Modelling Workflow with Agent Skills and Model Context Protocol

شارك:
المجلة: AI for Engineering، المجلد: 1، العدد: 1
DOI: https://doi.org/10.3390/aieng1010005
تاريخ النشر: 2026-06-09
المؤلف: Zhonghao Zhang وآخرون
الموضوع الرئيسي: حلول إدارة مياه الأمطار الحضرية

نظرة عامة

تقدم البحث سير عمل مبتكر لنموذج إدارة مياه الأمطار (SWMM) مصمم لتبسيط تكوين ونمذجة العمليات لنماذج الهيدرولوجيا الحضرية، وبشكل خاص نموذج إدارة مياه الأمطار (SWMM). يدمج هذا السير العمل ‘المهارات’ وبروتوكولات سياق النموذج لأتمتة عمليات تكوين النموذج، والتنفيذ، واستخراج البيانات ذات الصلة وتصويرها. إحدى الميزات الرئيسية لهذا النهج هي إنشاء ملف بيان مستقل لكل تشغيل، مما يضمن إمكانية التدقيق وإعادة الإنتاج من خلال توثيق العناصر الحرجة مثل إصدار SWMM، وتعيينات المعلمات، وتجزئة ملفات الإدخال، وتشخيص الجودة.

تظهر فعالية سير عمل SWMM Agentic من خلال تطبيقه على حوض مياه تواد كريك في كولومبيا البريطانية، حيث تم التحقق منه مقابل طرق تنفيذ SWMM التقليدية. أكدت الدراسة أن النتائج من سير عمل SWMM Agentic كانت معادلة لتلك التي تم الحصول عليها عبر سطر الأوامر الخاص بـ EPA SWMM® وواجهة المستخدم الرسومية (GUI)، خاصة من حيث مخرجات تدفق الذروة. علاوة على ذلك، فإن عملية الأتمتة الكاملة، بما في ذلك خدمات الرسم وبروتوكولات التقييم، متاحة كمصدر مفتوح، مما يسهل سير عمل قابل للتكرار يمكن بدءه باستخدام أوامر اللغة الطبيعية.

مقدمة

تقدم مقدمة الورقة OpenClaw، وهو ذكاء اصطناعي Agentic مصمم لإكمال الأهداف المعقدة، والذي تم إصداره بواسطة بيتر شتاينبرغر في يناير 2026. على عكس الأنظمة التقليدية الموجهة للدردشة، يقوم OpenClaw بتنظيم الأدوات الخارجية مثل استرجاع الويب وواجهات برمجة التطبيقات (APIs) تحت أذونات صريحة، مما يعالج التحديات الكبيرة في نمذجة الهيدرولوجيا. تتطلب برامج النمذجة المعتمدة على الفيزياء الحالية، على الرغم من تقديمها تصورًا ممتازًا وقابلية للتفسير، تفاعلًا واسعًا من المستخدم وتعديلات على المعلمات، مما يؤدي إلى عدم الكفاءة وأوقات معالجة طويلة. بالمقابل، تعزز نماذج التعلم الآلي الناشئة، بما في ذلك الذاكرة طويلة وقصيرة المدى (LSTM) والشبكات العصبية المدعومة بالفيزياء (PINNs)، التعرف على السلاسل الزمنية ولكنها تواجه صعوبات في التعميم وقابلية التفسير، مما يؤدي غالبًا إلى الإفراط في التكيف.

لتخفيف هذه المشكلات، يقترح المؤلفون إطار تكوين يدمج OpenClaw، المهارات، بروتوكول سياق النموذج (MCP)، وبرنامج SWMM. يسمح هذا الإطار للمستخدمين بتكوين SWMM وتعريف الرسوم البيانية باستخدام اللغة الطبيعية، مما يبسط عملية النمذجة. قام المؤلفون بالتحقق من صحة هذا النهج باستخدام حوض مياه تواد كريك في سانيتش، كولومبيا البريطانية، مما يظهر أن النتائج التي تم الحصول عليها من خلال تكوين اللغة الطبيعية كانت متسقة مع تلك المستمدة من واجهة المستخدم الرسومية (GUI) لـ SWMM. تؤكد البنية المقترحة على سير عمل شامل يقوم بتشفير إجراءات التشغيل القياسية كمهارات قابلة لإعادة الاستخدام، مما يضمن عمليات خاضعة للرقابة وقابلة للتدقيق لمحرك SWMM والرسم البياني اللاحق. تهدف هذه الابتكارات إلى تعزيز قابلية التكرار وقابلية التدقيق لتجارب SWMM بما يتجاوز الطرق التقليدية المعتمدة على واجهة المستخدم الرسومية.

الطرق

تصف المنهجية الموضحة في هذا القسم الإطار التشغيلي لنظام الذكاء الاصطناعي Agentic، OpenClaw، الذي يسهل تنظيم المهام لنمذجة الأحواض باستخدام بيانات Geo-layers. يبدأ سير العمل بدمج بيانات متعددة المصادر، بما في ذلك نماذج الارتفاع الرقمية (DEM)، واستخدام الأراضي، والتربة، وبيانات الأمطار، في لوحة التحكم لنموذج نظم المعلومات الجغرافية (GIS) (MCP). يتفاعل المستخدمون مع نموذج إدارة مياه الأمطار (SWMM) من خلال أوامر اللغة الطبيعية، بينما تعمل لوحة التحكم (MCP) كوسيط يقوم بتغليف أوامر SWMM في أدوات قابلة للاستدعاء. لمعالجة قيود SWMM فيما يتعلق بتحويل البيانات الخام، يتم إنشاء جدول بحث للتحويل مدمج من خلال الحوار داخل لوحة التحكم GIS.

تستخدم البحث برنامج سطر الأوامر SWMM (الإصدار 5.2.4) المجمعة من كود المصدر الخاص بـ EPA، وتنفيذ المحاكاة باستخدام الأمر “swmm5 “. يتم تنظيم كل تشغيل محاكاة في دليل مخصص، يخزن ملفات الإدخال (INP)، والتقرير (RPT)، والإخراج (OUT)، جنبًا إلى جنب مع ملف بيان يوثق إصدارات البرمجيات، وتكوينات المستخدم، وتعيينات المعلمات، والنتائج الرئيسية، مما يعزز الشفافية وقابلية التدقيق. جانب حاسم من المنهجية هو التنفيذ المتزامن لنفس ملف INP في كل من سطر الأوامر وواجهة المستخدم الرسومية SWMM، مما يسمح بالتحقق من معادلة النتائج العددية. بعد هذا التحقق، يتم تفعيل لوحة التحكم SWMM عبر تعليمات اللغة الطبيعية لأتمتة التنفيذ وتوليد نتائج مقارنة الجريان، كما هو موضح في القسم 3 من الورقة.

النتائج

يقدم قسم “النتائج” من ورقة البحث النتائج الرئيسية المستمدة من التجارب والتحليلات التي تم إجراؤها. تشير البيانات إلى وجود علاقة ارتباط كبيرة بين المتغيرات المدروسة، حيث تؤكد الاختبارات الإحصائية قوة هذه العلاقات. على وجه الخصوص، تكشف النتائج أنه مع زيادة المتغير $X$، يظهر المتغير $Y$ زيادة متناسبة، مما يدل على علاقة خطية إيجابية تتميز بمعامل ارتباط قدره $r = 0.85$.

بالإضافة إلى ذلك، تظهر نتائج تحليل التباين (ANOVA) أن الفروق بين المجموعات ذات دلالة إحصائية (p < 0.05)، مما يشير إلى أن العلاج المطبق له تأثير معنوي على النتائج المقاسة. تدعم النتائج أيضًا من خلال تمثيلات رسومية، توضح الاتجاهات والتوزيعات للبيانات، مما يعزز الاستنتاجات المستخلصة من التحليلات الكمية. بشكل عام، تسهم هذه النتائج في فهم الآليات الأساسية المعنية وتوفر أساسًا للبحث المستقبلي في هذا المجال.

المناقشة

تركز الدراسة على حوض مياه تواد كريك في كولومبيا البريطانية، باستخدام نموذج ارتفاع رقمي (DEM) ومصادر بيانات متنوعة لتعزيز نمذجة الهيدرولوجيا من خلال إطار الذكاء الاصطناعي Agentic، OpenClaw. يقوم هذا الإطار بتنظيم سير العمل من خلال دمج أدوات متعددة، بما في ذلك SWMM (نموذج إدارة مياه الأمطار)، لأتمتة عملية النمذجة. تظهر البحث أن OpenClaw يمكن أن يكرر الطرق التقليدية المعتمدة على واجهة المستخدم الرسومية بينما يحسن من قابلية الاستخدام للمستخدمين غير المألوفين بنمذجة الهيدرولوجيا. يسمح تنفيذ المهارات وخدمات بروتوكول التحكم في النموذج (MCP) بتنفيذ سلس، والتحقق، وإعادة إنتاج المحاكاة الهيدرولوجية، مما يقلل بشكل كبير من خطر الأخطاء المرتبطة بإدخال المستخدم.

أظهرت اختبارات التحقق أن العمليات الآلية داخل OpenClaw أنتجت نتائج متسقة مع تلك التي تم الحصول عليها عبر واجهات سطر الأوامر التقليدية وعمليات واجهة المستخدم الرسومية، محققة قيم R² وكفاءة ناش-سوتكليف (NSE) قدرها 1.0 عبر محاكاة متعددة. وهذا يشير إلى أن الحسابات الهيدرولوجية الأساسية قوية وموثوقة، مما يؤكد فعالية الذكاء الاصطناعي Agentic في توليد توقعات دقيقة للجريان الذروي. تشير النتائج إلى أن OpenClaw لا يعزز فقط كفاءة نمذجة الهيدرولوجيا ولكن أيضًا يضمن خصوصية البيانات وقابلية التفسير، حيث يبقى الجوهر الحسابي مستندًا إلى المبادئ الهيدرولوجية المعمول بها بدلاً من الاعتماد فقط على المخرجات التي تولدها الذكاء الاصطناعي. قد توسع الأعمال المستقبلية من قدرات MCP لتشمل وظائف إضافية، مثل تحليل جودة المياه، مما يعزز من مرونة الإطار.

Journal: AI for Engineering, Volume: 1, Issue: 1
DOI: https://doi.org/10.3390/aieng1010005
Publication Date: 2026-06-09
Author(s): Zhonghao Zhang et al.
Primary Topic: Urban Stormwater Management Solutions

Overview

The research introduces an innovative Agentic SWMM workflow designed to streamline the configuration and operational modeling of urban hydrological models, specifically the Storm Water Management Model (SWMM). This workflow integrates ‘Skills’ and model context protocols to automate the processes of model configuration, execution, and the extraction and visualization of relevant data. A key feature of this approach is the generation of an independent manifest file for each run, which ensures auditability and reproducibility by documenting critical elements such as the SWMM version, parameter mappings, input file hashes, and quality diagnostics.

The effectiveness of the Agentic SWMM workflow is demonstrated through its application to the Tod Creek watershed in British Columbia, where it was validated against traditional SWMM execution methods. The study confirmed that the results from the Agentic SWMM workflow were equivalent to those obtained via the EPA SWMM® command line and graphical user interface (GUI), particularly in terms of peak flow outputs. Furthermore, the entire automation process, including plotting services and evaluation protocols, is made available as open-source, facilitating a reproducible workflow that can be initiated using natural language commands.

Introduction

The introduction of the paper presents OpenClaw, an Agentic AI designed for complex goal completion, which was released by Peter Steinberger in January 2026. Unlike traditional chat-oriented systems, OpenClaw orchestrates external tools such as web retrieval and APIs under explicit permissions, addressing significant challenges in hydrological modeling. Current physics-based modeling software, while offering excellent visualization and interpretability, requires extensive user interaction and parameter adjustments, leading to inefficiencies and long processing times. In contrast, emerging machine learning models, including long short-term memory (LSTM) and physics-informed neural networks (PINNs), enhance time series recognition but struggle with generalization and interpretability, often resulting in overfitting.

To mitigate these issues, the authors propose a configuration framework that integrates OpenClaw, Skills, Model Context Protocol (MCP), and SWMM software. This framework allows users to configure SWMM and define plots using natural language, streamlining the modeling process. The authors validated this approach using the Tod Creek Watershed in Saanich, BC, demonstrating that the results obtained through natural language configuration were consistent with those derived from the SWMM graphical user interface (GUI). The proposed architecture emphasizes an end-to-end workflow that encodes standard operating procedures as reusable Skills, ensuring controlled and auditable operations of the SWMM engine and downstream plotting. This innovation aims to enhance the repeatability and auditability of SWMM experiments beyond traditional GUI-centric methods.

Methods

The methodology outlined in this section describes the operational framework of the Agentic AI system, OpenClaw, which facilitates the orchestration of tasks for watershed modeling using Geo-layers data. The workflow begins with the integration of multi-source data, including Digital Elevation Models (DEM), land use, soil, and rainfall data, into a Geographic Information System (GIS) Model Control Panel (MCP). Users interact with the Storm Water Management Model (SWMM) through natural language commands, while the MCP serves as an intermediary that packages SWMM commands into callable tools. To address SWMM’s limitations regarding raw data transformation, a built-in transformation lookup table is generated through dialogue within the GIS MCP.

The research employs the SWMM command-line program (version 5.2.4) compiled from the EPA source code, executing simulations with the command “swmm5 “. Each simulation run is organized into a dedicated directory, storing input (INP), report (RPT), and output (OUT) files, along with a manifest file that documents software versions, user configurations, parameter mappings, and key results, thereby enhancing transparency and auditability. A critical aspect of the methodology is the synchronous execution of the same INP file in both the command line and SWMM GUI, allowing for equivalence verification of numerical outcomes. Following this validation, the SWMM MCP is activated via natural language instructions to automate execution and generate runoff comparison results, as detailed in Section 3 of the paper.

Results

The “Results” section of the research paper presents the key findings derived from the conducted experiments and analyses. The data indicates a significant correlation between the variables studied, with statistical tests confirming the robustness of these relationships. Specifically, the results reveal that as variable $X$ increases, variable $Y$ exhibits a corresponding increase, demonstrating a positive linear relationship characterized by a correlation coefficient of $r = 0.85$.

Additionally, the analysis of variance (ANOVA) results show that the differences among the groups are statistically significant (p < 0.05), suggesting that the treatment applied has a meaningful effect on the outcomes measured. The findings are further supported by graphical representations, which illustrate the trends and distributions of the data, reinforcing the conclusions drawn from the quantitative analyses. Overall, these results contribute to the understanding of the underlying mechanisms at play and provide a foundation for future research in this area.

Discussion

The study focuses on the Todd Creek watershed in British Columbia, utilizing a digital elevation model (DEM) and various data sources to enhance hydrological modeling through the Agentic AI framework, OpenClaw. This framework orchestrates workflows by integrating multiple tools, including SWMM (Storm Water Management Model), to automate the modeling process. The research demonstrates that OpenClaw can replicate traditional GUI-based modeling approaches while improving usability for users unfamiliar with hydrological modeling. The implementation of Skills and Model Control Protocol (MCP) services allows for streamlined execution, verification, and reproducibility of hydrological simulations, significantly reducing the risk of errors associated with user input.

Verification tests showed that the automated processes within OpenClaw produced results consistent with those obtained via conventional command-line interfaces and GUI operations, achieving R² and Nash-Sutcliffe Efficiency (NSE) values of 1.0 across multiple simulations. This indicates that the core hydrological computations are robust and reliable, affirming the effectiveness of the Agentic AI in generating accurate peak runoff predictions. The findings suggest that OpenClaw not only enhances the efficiency of hydrological modeling but also ensures data privacy and interpretability, as the computational core remains grounded in established hydrological principles rather than solely relying on AI-generated outputs. Future work may expand the MCP capabilities to include additional functionalities, such as water quality analysis, further enhancing the versatility of the framework.