šŸš€ Enhance Your ARIS Models with AI: New Custom Script Using OpenRouter & Claude (PoC for Testing)

This is an experimental Proof of Concept (PoC). It's designed to explore the potential of integrating AI with ARIS for naming and documentation support. Feel free to test it out and share your experience—just keep in mind it’s not production-ready (yet)!

Hello ARIS Community,

I'm excited to introduce a custom ARIS script I’ve developed to enhance process modeling by leveraging AI—specifically through OpenRouter's API. While this proof of concept (PoC) uses the Claude AI model, it’s also compatible with other LLMs like ChatGPT.

The goal? To automatically refine activity names and generate professional process descriptions at the model level using BPMN best practices. Below, I’ll share the purpose, functionality, and key features of the script. I’d love to hear your feedback, ideas, or questions!

šŸ” Script Overview

  • Name: Improve objects and process description names using OpenRouter Claude
  • Execution Context: Model-level
  • Purpose: Automatically enhance activity, rule, and event names and generate a concise, professional process description.

✨ What the Script Does

This script integrates with OpenRouter’s Claude AI model to:

  • Standardize and optimize names of process elements (activities, rules, and events) using BPMN naming conventions.
  • Auto-generate a clear, polished process description based on the process name and updated element names.

šŸ”§ Key Features

šŸ·ļø Activity Name Refinement

  • Retrieves names of functions (activities), rules, and events from the selected model.
  • Sends them to Claude with a prompt tailored to BPMN standards (e.g., verb-object structure, active voice, concise format).
  • Updates names directly in the model.

šŸ“„ Process Description Generation

  • Uses the improved names and process title to prompt Claude to generate a professional, succinct process description.
  • Saves the result to the model’s description attribute.

🌐 Language Support

  • Adapts to the language selected in ARIS, ensuring names and descriptions match user preferences.

šŸ› ļø Error Handling & Debugging

  • Built-in error handling with optional debug logging to assist with troubleshooting.

šŸ”Œ API Integration

  • Connects to OpenRouter’s API (tested with Claude-3-Haiku) using configurable headers and authentication.

āš™ļø How It Works

  1. Collect Input: Gathers the names of functions, rules, and events from the selected model.
  2. Send to AI: Passes them to Claude for enhancement based on BPMN standards.
  3. Update Model: Applies the improved names to the corresponding objects.
  4. Generate Description: Prompts Claude to create a process description using the refined elements.
  5. Log Output: Captures error logs and optional debug info for transparency.

šŸ“˜ How to Use It

  1. Setup: Import the script into your ARIS environment as a report.
  2. Configure: Insert a valid OpenRouter API token (replace the placeholder if necessary).
  3. Run: Execute the script on your selected model—names and descriptions will be updated automatically.
  4. Review: Check the updated elements and description in your model. View logs and debug info via context properties (if enabled).

Looking forward to your thoughts! Whether you have improvement ideas, questions about customization, or want to try it yourself—drop a comment below!

 or register to reply.

Notify Moderator