62 lines
4.3 KiB
Markdown
62 lines
4.3 KiB
Markdown
# Οδηγός Ενσωμάτωσης Mattermost
|
||
|
||
Το ZeroClaw παρέχει εγγενή υποστήριξη για το Mattermost μέσω του REST API v4. Η ενσωμάτωση αυτή είναι ιδανική για περιβάλλοντα αυτοφιλοξενούμενα (self-hosted), ιδιωτικά ή απομονωμένα (air-gapped), όπου η προστασία των δεδομένων επικοινωνίας είναι πρωταρχικής σημασίας.
|
||
|
||
## Προαπαιτούμενα
|
||
|
||
1. **Διακομιστής Mattermost**: Μια ενεργή εγκατάσταση (self-hosted ή Cloud).
|
||
2. **Λογαριασμός Bot**:
|
||
- Μεταβείτε στο **Main Menu > Integrations > Bot Accounts**.
|
||
- Επιλέξτε **Add Bot Account**.
|
||
- Ορίστε ένα όνομα χρήστη (π.χ. `zeroclaw-bot`).
|
||
- Εκχωρήστε τα δικαιώματα `post:all` και `channel:read`.
|
||
- Αποθηκεύστε το **Access Token**.
|
||
3. **ID Καναλιού (Channel ID)**:
|
||
- Ανοίξτε το κανάλι που θα παρακολουθεί το bot.
|
||
- Επιλέξτε την κεφαλίδα του καναλιού και πατήστε **View Info**.
|
||
- Αντιγράψτε το **ID** (π.χ. `7j8k9l...`).
|
||
|
||
## Ρύθμιση
|
||
|
||
Προσθέστε τα παρακάτω στο αρχείο `config.toml`, στην ενότητα `[channels_config.mattermost]`:
|
||
|
||
```toml
|
||
[channels_config.mattermost]
|
||
url = "https://mm.your-domain.com"
|
||
bot_token = "το-access-token-του-bot-σας"
|
||
channel_id = "το-id-καναλιού-σας"
|
||
allowed_users = ["user-id-1", "user-id-2"]
|
||
thread_replies = true
|
||
mention_only = true
|
||
```
|
||
|
||
### Παράμετροι Ρύθμισης
|
||
|
||
| Παράμετρος | Περιγραφή |
|
||
|:---|:---|
|
||
| `url` | Το βασικό URL του διακομιστή Mattermost. |
|
||
| `bot_token` | Το Προσωπικό Διακριτικό Πρόσβασης (PAT) του λογαριασμού bot. |
|
||
| `channel_id` | Το ID του καναλιού προς παρακολούθηση (απαιτείται για τη λειτουργία `listen`). |
|
||
| `allowed_users` | Λίστα με ID χρηστών που επιτρέπεται να αλληλεπιδρούν με το bot. Χρησιμοποιήστε `["*"]` για καθολική πρόσβαση. |
|
||
| `thread_replies` | Εάν οι απαντήσεις θα δημιουργούν νήμα (thread). Προεπιλογή: `true`. |
|
||
| `mention_only` | Εάν το bot θα επεξεργάζεται μόνο μηνύματα που το αναφέρουν ρητά (π.χ. `@zeroclaw-bot`). Προεπιλογή: `false`. |
|
||
|
||
## Διαχείριση Νημάτων (Threaded Conversations)
|
||
|
||
Το ZeroClaw διαχειρίζεται αυτόματα τα νήματα στο Mattermost:
|
||
- Εάν ένας χρήστης απαντήσει σε υπάρχον νήμα, το ZeroClaw θα απαντήσει εντός του ίδιου νήματος.
|
||
- Εάν `thread_replies = true`, κάθε νέα απάντηση του bot σε μήνυμα κορυφαίου επιπέδου θα δημιουργεί ένα νέο νήμα.
|
||
- Εάν `thread_replies = false`, οι απαντήσεις θα δημοσιεύονται απευθείας στο κανάλι.
|
||
|
||
## Λειτουργία Μόνο με Αναφορά (Mention-Only)
|
||
|
||
Όταν η επιλογή `mention_only` είναι ενεργή, το ZeroClaw:
|
||
- Αγνοεί μηνύματα που δεν περιλαμβάνουν ρητή αναφορά στο όνομα χρήστη του bot.
|
||
- Αφαιρεί το διακριτικό `@bot_username` πριν από την επεξεργασία του μηνύματος από το μοντέλο AI.
|
||
|
||
Αυτή η λειτουργία συνιστάται για πολυσύχναστα κανάλια, προκειμένου να αποφεύγεται η άσκοπη χρήση πόρων.
|
||
|
||
## Ασφάλεια και Ιδιωτικότητα
|
||
|
||
Η ενσωμάτωση έχει σχεδιαστεί για **ελεγχόμενη επικοινωνία**. Με τη χρήση ενός self-hosted διακομιστή Mattermost, το ιστορικό των συνομιλιών παραμένει αποκλειστικά στην υποδομή σας, διασφαλίζοντας την ιδιωτικότητα του πράκτορα AI.
|