Skip to content

EricLott/WorkstationInsights

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WorkstationInsights

A Semantic Kernel plugin to diagnose and monitor system health on a Windows machine. This plugin exposes various system-level diagnostics as functions, allowing LLM agents to query the state of the machine using natural language.


🔧 Features

  • OS and system info
  • CPU, memory, and disk usage
  • Running processes and services
  • Event logs and uptime
  • Network and ping tests
  • Environment variables

💡 Use Cases

🧠 Natural Language Troubleshooting

"Why is my computer lagging?"

  • Calls GetCpuUsage, GetMemoryUsagePercent, ListTopCpuProcesses, etc.
  • LLM provides a diagnosis like: "Your CPU usage is at 85%, and Chrome is using the most resources."

🔄 Automated Health Check

Daily or hourly health scans

  • Calls uptime, updates, disk info, and running services
  • Summarized into a status report by the LLM

📡 Network Diagnostics

"Is the internet down?"

  • Calls PingTest("8.8.8.8"), GetActiveNetworkInterfaces
  • LLM summarizes connection status and suggestions

🔍 Debugging App or Service Problems

"Why won’t SQL Server start?"

  • Calls CheckServiceStatus, GetEventLogs("Application")
  • LLM diagnoses from service state and logs

🧰 System Inventory Bot

"How much RAM and CPU does this machine have?"

  • Calls GetTotalPhysicalMemory, GetLogicalProcessorCount
  • LLM replies with a concise system spec

🛑 Auto-Shutdown or Alert Triggers

Alert when RAM > 90%

  • Kernel auto-checks memory and CPU
  • Triggers alert or flow when thresholds are exceeded

🧼 User-Friendly System Clean-up Suggestions

"How can I free up space?"

  • Uses GetDriveInfo, ListTopMemoryProcesses
  • GPT suggests uninstalling or clearing large files

🔗 Getting Started

  1. Add this plugin class to your Semantic Kernel project.
  2. Register with the Kernel:
builder.Plugins.AddFromType<WorkstationInsights>();
  1. Now your LLM can invoke diagnostics like:

"Show the top memory-using processes"


📁 Structure

This plugin uses:

  • System.Diagnostics
  • System.Management
  • System.IO
  • System.ServiceProcess
  • System.Net.NetworkInformation

No external dependencies are required.


📜 License

MIT — use freely in personal or commercial Semantic Kernel applications.

About

Semantic Kernel plugin for real-time Windows diagnostics using natural language. Includes CPU, memory, disk, network, services, and event log insights. Perfect for LLM-powered support agents or health checks.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages