Using the AI Co-pilot

In addition to monitoring simulations through the Live Telemetry Sidebar and Canvas Charts, R-THYM provides an intelligent AI Co-pilot directly within the web interface. The Co-pilot acts as an on-demand hydraulic and electrical systems assistant, helping you analyze simulation results, troubleshoot network warnings, and optimize component configurations.

Accessing the Co-pilot

The AI Co-pilot is located in the sidebar panel. You can toggle the chat interface by clicking the AI Co-pilot icon on the main workspace control panel.

The Co-pilot is fully context-aware. During your conversation, it automatically inspects: - The current layout and parameters of all nodes and links on your canvas. - Real-time simulation metrics, warning logs, and cavitation triggers. - Environmental settings (latitude, longitude, solar radiation, and wind profiles).

Contextual Simulation Diagnostics

When running steady-state, EPS, or transient MOC simulations, the Co-pilot is particularly useful for diagnosing issues:

• Troubleshooting Cavitation and Surge: If a simulation run triggers a cavitation warning or pressure spike, click the Co-pilot and ask, "Why is my system cavitating?" or "How can I reduce the surge pressure?" The Co-pilot will analyze the transient results and present tailored engineering strategies.
• Interpreting Warnings: You can request a summary of active warning logs using the query "Explain my simulation warnings." The Co-pilot will translate raw solver logs into clear, actionable advice.
• Environmental Optimization: Ask the Co-pilot to evaluate renewable energy efficiency, such as how cloud cover is impacting solar generation or how wind speed changes affect battery charging dynamics.

Active Property Configuration

The AI Co-pilot can assist you in configuring your network components directly from the chat:

• Direct Property Updates: You can request changes to existing components verbally (e.g., "Increase the diameter of Pipe_A to 12 inches" or "Change the pump curve efficiency to 85%"). The Co-pilot will generate an adjustment card in the chat. Click Apply on the card to instantly write the properties to the canvas component.
• Step-by-Step Guidance: For complex design challenges (like configuring a PID control loop or sizing a hydropneumatic tank), the Co-pilot will walk you through the configuration options step-by-step.

[!NOTE] In Version 1.0, the AI Co-pilot cannot modify the network topology directly. It cannot add new components or delete existing elements on the canvas. To add components recommended by the Co-pilot (like surge standpipes or air valves), manually place them using the canvas toolbar, and then ask the Co-pilot to help configure their properties.

Best Practices for Queries

To get the most out of the AI Co-pilot during simulation and analysis:

1. Be Specific with Component Names: Use the exact component ID (e.g., Pump_1, Valve_B) when requesting property adjustments.
2. Review Options First: For open-ended engineering questions, the Co-pilot is designed to explain multiple options and ask for your preference. Engage in the step-by-step dialog to tailor the proposed solutions to your specific constraints.
3. Verify Proposals: The Co-pilot is an assistant tool. Always verify its proposed parameter changes by running follow-up simulations and checking results in the Telemetry Sidebar.