Skip to content

Commit 68894a0

Browse files
committed
Adds README
1 parent 1c46671 commit 68894a0

File tree

1 file changed

+90
-12
lines changed

1 file changed

+90
-12
lines changed

README.md

Lines changed: 90 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,98 @@
1-
# Site Status Checker Agent
1+
# Site Status Checker Agent 🕵️‍♂️
22

3-
## Overview
3+
[![PHP](https://img.shields.io/packagist/php-v/llm-agents-php/agent-site-status-checker.svg?style=flat-square)](https://packagist.org/packages/llm-agents-php/agent-site-status-checker)
4+
[![Latest Version on Packagist](https://img.shields.io/packagist/v/llm-agents-php/agent-site-status-checker.svg?style=flat-square)](https://packagist.org/packages/llm-agents-php/agent-site-status-checker)
5+
[![Total Downloads](https://img.shields.io/packagist/dt/llm-agents-php/agent-site-status-checker.svg?style=flat-square)](https://packagist.org/packages/llm-agents-php/agent-site-status-checker)
46

5-
The Site Status Checker Agent is a powerful and flexible tool designed to monitor and report on the status of websites.
7+
Hey there! 👋 This package gives you a cool Site Status Checker Agent for your LLM Agents project.
68

7-
## Features
9+
![site-status-checker](https://github.com/user-attachments/assets/e363dd44-7dff-413e-a5cd-c2eebcf62b7e)
810

9-
- **Website Availability Check**: Quickly determine if a given URL is accessible.
10-
- **DNS Information Retrieval**: Fetch and analyze DNS records for specified domains.
11-
- **Ping Tests**: Perform network ping tests to assess connectivity and response times.
12-
- **Troubleshooting Assistance**: Offer potential reasons and troubleshooting steps for offline websites.
11+
## What's this all about? 🤔
1312

14-
## License
13+
- Check if a site is up and running 🏃‍♂️
14+
- Dig up DNS info 🔍
15+
- Run ping tests 🏓
16+
- Give you the lowdown on why a site might be offline 😴
1517

16-
The Site Status Checker Agent is open-source software licensed under the MIT license.
18+
## Class Diagram 📊
1719

18-
## Support
20+
Here's a quick look at how everything fits together:
1921

20-
If you encounter any issues or have questions, please file an issue on the GitHub repository issue tracker.
22+
```mermaid
23+
classDiagram
24+
class SiteStatusCheckerAgent {
25+
+create() : self
26+
}
27+
class AgentAggregate {
28+
<<interface>>
29+
}
30+
class CheckSiteAvailabilityTool {
31+
+execute(object) : string
32+
}
33+
class GetDNSInfoTool {
34+
+execute(object) : string
35+
}
36+
class PerformPingTestTool {
37+
+execute(object) : string
38+
}
39+
class Tool {
40+
<<abstract>>
41+
}
42+
SiteStatusCheckerAgent --|> AgentAggregate
43+
CheckSiteAvailabilityTool --|> Tool
44+
GetDNSInfoTool --|> Tool
45+
PerformPingTestTool --|> Tool
46+
SiteStatusCheckerAgent ..> CheckSiteAvailabilityTool
47+
SiteStatusCheckerAgent ..> GetDNSInfoTool
48+
SiteStatusCheckerAgent ..> PerformPingTestTool
49+
```
50+
51+
## Let's get started! 🚀
52+
53+
### Installation
54+
55+
First things first, let's get this package installed:
56+
57+
```bash
58+
composer require llm-agents/agent-site-status-checker
59+
```
60+
61+
### Setup in Spiral Framework
62+
63+
To get the Site Status Checker Agent up and running in your Spiral Framework project, you need to register its
64+
bootloader.
65+
66+
**Here's how:**
67+
68+
1. Open up your `app/src/Application/Kernel.php` file.
69+
2. In the `defineBootloaders()` method, add the bootloader like this:
70+
```php
71+
public function defineBootloaders(): array
72+
{
73+
return [
74+
// ... other bootloaders ...
75+
\LLM\Agents\Agent\SiteStatusChecker\Bootloader\SiteStatusCheckerBootloader::class,
76+
];
77+
}
78+
```
79+
80+
And that's it! Your Spiral app is now ready to use the Site Status Checker Agent.
81+
82+
## Want to help out? 🤝
83+
84+
We love contributions! If you've got ideas to make this agent even cooler, here's how you can chip in:
85+
86+
1. Fork the repo
87+
2. Make your changes
88+
3. Create a new Pull Request
89+
90+
Just make sure your code is clean, well-commented, and follows PSR-12 coding standards.
91+
92+
## License 📄
93+
94+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
95+
96+
---
97+
98+
That's all, folks! If you've got any questions or run into any trouble, don't hesitate to open an issue.

0 commit comments

Comments
 (0)