142 lines
5.3 KiB
Markdown
142 lines
5.3 KiB
Markdown
# Εγχειρίδιο Διαχείρισης Proxy (Proxy Agent Playbook)
|
||
|
||
Αυτό το εγχειρίδιο περιέχει έτοιμες κλήσεις εργαλείων για τη διαμόρφωση της συμπεριφοράς διαμεσολάβησης (proxy) μέσω της ρύθμισης `proxy_config`.
|
||
|
||
## 0. Περίληψη
|
||
|
||
- **Σκοπός**: Παροχή προτύπων για τη διαχείριση της εμβέλειας του proxy και τη διασφάλιση της δυνατότητας επαναφοράς (rollback).
|
||
- **Κοινό**: Διαχειριστές συστημάτων και συντηρητές που λειτουργούν το ZeroClaw σε εταιρικά ή περιορισμένα δίκτυα.
|
||
- **Πεδίο Εφαρμογής**: Ενέργειες `proxy_config`, επιλογή λειτουργίας, επαλήθευση και επίλυση προβλημάτων.
|
||
|
||
---
|
||
|
||
## 1. Ταχείες Ενέργειες ανά Περίπτωση
|
||
|
||
### 1.1 Proxy μόνο για το ZeroClaw (Internal Traffic)
|
||
|
||
- **Περιγραφή**: Διαμεσολάβηση μόνο για την εσωτερική κίνηση του δαίμονα.
|
||
- **Εμβέλεια (Scope)**: `zeroclaw`.
|
||
- **Επαλήθευση**: Χρήση της ενέργειας `{"action":"get"}`.
|
||
|
||
### 1.2 Proxy για επιλεγμένες υπηρεσίες
|
||
|
||
- **Περιγραφή**: Διαμεσολάβηση μόνο για συγκεκριμένους παρόχους ή εργαλεία.
|
||
- **Εμβέλεια**: `services`.
|
||
- **Επαλήθευση**: Χρήση της ενέργειας `{"action":"list_services"}`.
|
||
|
||
### 1.3 Καθολική διαμεσολάβηση (Environment-wide)
|
||
|
||
- **Περιγραφή**: Εξαγωγή μεταβλητών περιβάλλοντος για όλη τη διεργασία.
|
||
- **Εμβέλεια**: `environment`.
|
||
- **Επαλήθευση**: Χρήση της ενέργειας `{"action":"apply_env"}`.
|
||
|
||
### 1.4 Άμεση Απενεργοποίηση (Emergency Rollback)
|
||
|
||
1. Απενεργοποιήστε τη διαμεσολάβηση.
|
||
2. Εκκαθαρίστε τις μεταβλητές περιβάλλοντος (εάν έχουν εξαχθεί).
|
||
3. Επαληθεύστε την κατάσταση του runtime.
|
||
|
||
---
|
||
|
||
## 2. Μήτρα Επιλογής Εμβέλειας (Scope)
|
||
|
||
| Εμβέλεια | Επηρεάζει | Περιβάλλον (Env) | Χρήση |
|
||
|:---|:---|:---:|:---|
|
||
| `zeroclaw` | Εσωτερικοί HTTP clients | Όχι | Αποφυγή παρενεργειών στο σύστημα. |
|
||
| `services` | Επιλεγμένα κλειδιά/selectors | Όχι | Δρομολόγηση για συγκεκριμένους παρόχους/εργαλεία. |
|
||
| `environment` | Full Process Runtime | Ναι | Ενσωματώσεις που απαιτούν `HTTP_PROXY`. |
|
||
|
||
---
|
||
|
||
## 3. Ροή Εργασίας Ασφαλούς Αλλαγής
|
||
|
||
1. **Επιθεώρηση**: Έλεγχος τρέχουσας κατάστασης.
|
||
2. **Ανακάλυψη**: Εύρεση έγκυρων κλειδιών υπηρεσιών.
|
||
3. **Εφαρμογή**: Ρύθμιση της επιθυμητής εμβέλειας.
|
||
4. **Επαλήθευση**: Έλεγχος στιγμιότυπων runtime και environment.
|
||
|
||
**Εντολές Ελέγχου**:
|
||
```json
|
||
{"action":"get"}
|
||
{"action":"list_services"}
|
||
```
|
||
|
||
---
|
||
|
||
## 4. Παραδείγματα Διαμόρφωσης
|
||
|
||
### Λειτουργία Α: Εσωτερική Διαμεσολάβηση (ZeroClaw only)
|
||
|
||
```json
|
||
{
|
||
"action": "set",
|
||
"enabled": true,
|
||
"scope": "zeroclaw",
|
||
"http_proxy": "http://127.0.0.1:7890",
|
||
"https_proxy": "http://127.0.0.1:7890",
|
||
"no_proxy": ["localhost", "127.0.0.1"]
|
||
}
|
||
```
|
||
|
||
### Λειτουργία Β: Στοχευμένη Διαμεσολάβηση (Services)
|
||
|
||
Χρήση συγκεκριμένων κλειδιών:
|
||
```json
|
||
{
|
||
"action": "set",
|
||
"enabled": true,
|
||
"scope": "services",
|
||
"services": ["provider.openai", "tool.http_request"],
|
||
"all_proxy": "socks5h://127.0.0.1:1080"
|
||
}
|
||
```
|
||
Χρήση μπαλαντέρ (Wildcards):
|
||
```json
|
||
{
|
||
"action": "set",
|
||
"enabled": true,
|
||
"scope": "services",
|
||
"services": ["provider.*"]
|
||
}
|
||
```
|
||
|
||
### Λειτουργία Γ: Καθολική Διαμεσολάβηση (Process Environment)
|
||
|
||
```json
|
||
{
|
||
"action": "set",
|
||
"enabled": true,
|
||
"scope": "environment",
|
||
"http_proxy": "http://127.0.0.1:7890"
|
||
}
|
||
{"action":"apply_env"}
|
||
```
|
||
|
||
---
|
||
|
||
## 5. Απενεργοποίηση και Επαναφορά
|
||
|
||
### Απενεργοποίηση (Safe)
|
||
|
||
```json
|
||
{"action":"disable"}
|
||
```
|
||
|
||
### Πλήρης Εκκαθαρισμός Περιβάλλοντος
|
||
|
||
```json
|
||
{"action":"disable", "clear_env": true}
|
||
```
|
||
|
||
---
|
||
|
||
## 6. Αντιμετώπιση Προβλημάτων
|
||
|
||
- **Σφάλμα**: `proxy.scope='services' requires a non-empty proxy.services list`
|
||
- *Λύση*: Προσθέστε τουλάχιστον ένα έγκυρο κλειδί ή selector.
|
||
- **Σφάλμα**: `Invalid proxy URL scheme`
|
||
- *Λύση*: Χρησιμοποιήστε `http`, `https`, `socks5` ή `socks5h`.
|
||
- **Η διαμεσολάβηση δεν εφαρμόζεται**:
|
||
- Εκτελέστε `list_services` για να επαληθεύσετε τα ονόματα των υπηρεσιών.
|
||
- Ελέγξτε την έξοδο της `get` για τις τιμές `runtime_proxy` και `environment`.
|