39  Οδηγός διαχειριστή Automations

39.1 Επισκόπηση

Αυτός ο οδηγός εξηγεί πώς να ενεργοποιήσετε και να διαμορφώσετε τα Sophea Automations για τον χώρο εργασίας σας, συμπεριλαμβανομένων της ρύθμισης στο Portal, της διαμόρφωσης email και της δρομολόγησης μοντέλων.

39.2 Ενεργοποίηση των Automations στο Portal

39.2.1 Προαπαιτούμενα

  • Η πλατφόρμα Sophea έχει αναπτυχθεί και λειτουργεί (Nous, Portal, υπηρεσία RAG)
  • Πρόσβαση διαχειριστή στο Portal
  • Τουλάχιστον ένας χώρος εργασίας έχει δημιουργηθεί

39.2.2 Βήματα

  1. Συνδεθείτε στην κονσόλα διαχείρισης του Portal
  2. Μεταβείτε στις ρυθμίσεις του χώρου εργασίας
  3. Ενεργοποιήστε τον διακόπτη δυνατότητας Automations, ο οποίος ενεργοποιεί τους αυτοματισμούς για τον χώρο εργασίας
  4. Το περιβάλλον δημιουργίας Automations θα είναι διαθέσιμο στη διεύθυνση /automations στο web UI του Nous

39.2.3 Λειτουργία shell

Η λειτουργία shell περιορίζει τα διαθέσιμα pieces σε μια ελεγμένη λίστα επιτρεπόμενων στοιχείων. Συνιστάται για περιβάλλοντα παραγωγής. Για να ενεργοποιήσετε τη λειτουργία shell:

  1. Ορίστε NOUS_AUTOMATIONS_SHELL=true στο περιβάλλον του Automations API server
  2. Προσθέστε το NOUS_AUTOMATIONS_SHELL στο AP_SANDBOX_PROPAGATED_ENV_VARS, ώστε τα pieces να μπορούν να το διαβάσουν μέσα στο sandbox
  3. Βεβαιωθείτε ότι στο περιβάλλον δημιουργίας εμφανίζονται μόνο τα pieces της λίστας επιτρεπόμενων στοιχείων

Η λίστα επιτρεπόμενων στοιχείων της λειτουργίας shell περιλαμβάνει 18 ελεγμένα pieces: - @activepieces/piece-sophea (όλες οι ενέργειες και τα triggers της Sophea) - @activepieces/piece-manual-trigger (χειροκίνητο trigger) - @activepieces/piece-schedule (triggers βάσει χρόνου) - @activepieces/piece-webhook (webhook trigger υπογεγραμμένο με HMAC) - @activepieces/piece-tables (πίνακες δεδομένων) - @activepieces/piece-forms (φόρμες και ανθρώπινη εισαγωγή) - @activepieces/piece-file-helper (λειτουργίες αρχείων) - @activepieces/piece-csv (λειτουργίες CSV) - @activepieces/piece-data-mapper (μετασχηματισμός δεδομένων) - @activepieces/piece-data-summarizer (σύνοψη δεδομένων) - @activepieces/piece-date-helper (βοηθητικές λειτουργίες ημερομηνίας) - @activepieces/piece-delay (βήμα καθυστέρησης) - @activepieces/piece-math-helper (μαθηματικές λειτουργίες) - @activepieces/piece-pdf (λειτουργίες PDF) - @activepieces/piece-qrcode (δημιουργία κωδικών QR) - @activepieces/piece-store (αποθήκευση ζευγών κλειδιού-τιμής) - @activepieces/piece-text-helper (βοηθητικές λειτουργίες κειμένου) - @activepieces/piece-xml (λειτουργίες XML)

39.3 Διαμόρφωση email χώρου εργασίας

Τα Sophea Automations μπορούν να στέλνουν email εκ μέρους των μελών του χώρου εργασίας. Η ενέργεια send_workspace_email χρησιμοποιεί τον πάροχο email της πλατφόρμας.

39.3.1 Προαπαιτούμενα

  • Διακομιστής SMTP διαμορφωμένος στο backend του Nous
  • Ρυθμίσεις email χώρου εργασίας ενεργοποιημένες στο Portal

39.3.2 Διαμόρφωση

  1. Διαμορφώστε τον διακομιστή SMTP στην ανάπτυξη του backend του Nous
  2. Ορίστε τις ακόλουθες μεταβλητές περιβάλλοντος στο backend του Nous:
    • SMTP_HOST: όνομα κεντρικού υπολογιστή του διακομιστή SMTP
    • SMTP_PORT: θύρα του διακομιστή SMTP (συνήθως 587 για TLS)
    • SMTP_USER: όνομα χρήστη SMTP
    • SMTP_PASSWORD: κωδικός πρόσβασης SMTP
    • SMTP_FROM_EMAIL: διεύθυνση email αποστολέα
    • SMTP_FROM_NAME: εμφανιζόμενο όνομα αποστολέα
  3. Επαληθεύστε την παράδοση email εκτελώντας μια ροή με την ενέργεια send_workspace_email

39.3.3 Συμπεριφορά email

  • Τα email αποστέλλονται από τον χώρο εργασίας και όχι από μεμονωμένους χρήστες
  • Το recipientMode μπορεί να είναι RUN_USER (αποστολή στο άτομο που εκτέλεσε τη ροή) ή WORKSPACE_MEMBERS (αποστολή σε επιλεγμένα μέλη του χώρου εργασίας)
  • Το σώμα του email μπορεί να είναι απλό κείμενο ή markdown, το οποίο μετατρέπεται σε HTML

39.4 Ρύθμιση δρομολόγησης μοντέλων

Τα Sophea Automations χρησιμοποιούν το ίδιο ορατό μοντέλο CHAT και την ίδια προεπιλογή χώρου εργασίας που έχουν ρυθμιστεί για το Nous. Οι ενέργειες κατά την εκτέλεση καλούν απευθείας το broker του Nous. Οι λειτουργίες Generate και Refine χρησιμοποιούν τον proxy μοντέλων του Portal, αλλά όλες οι επιφάνειες εφαρμόζουν την ίδια αρχή του χώρου εργασίας.

39.4.1 Αρχή μοντέλου χώρου εργασίας

  1. Ένας διαχειριστής πλατφόρμας διαθέτει τα W2, W3 και W4 στον χώρο εργασίας.
  2. Ένας διαχειριστής χώρου εργασίας επιλέγει ένα ορατό μοντέλο CHAT ως προεπιλογή για τον συγκεκριμένο υπάρχοντα χώρο.
  3. Οι προεπιλογές επιπέδου λογαριασμού ισχύουν μόνο για τη δημιουργία μελλοντικών χώρων εργασίας, εκτός αν ο διαχειριστής εφαρμόσει ρητά μια αλλαγή στους υπάρχοντες.
  4. Η απόκρυψη ενός μοντέλου το αφαιρεί από τους επιλογείς συνομιλίας, ενεργειών, Generate και Refine χωρίς να διαγράφει την εγγραφή του καταλόγου.

39.4.2 Διαθέσιμα μοντέλα

Ο επιλογέας μοντέλου εμφανίζει το Workspace default μαζί με τα ορατά ρητά μοντέλα που είναι διαθέσιμα στον χώρο εργασίας. Η τιμή workspace_default παραμένει αποθηκευμένη στη ροή και επιλύεται στην τρέχουσα προεπιλογή σε κάθε εκτέλεση. Επομένως, η αλλαγή από W3 σε W4 ενημερώνει τις αμετάβλητες ροές χωρίς επανεκκίνηση.

Ρυθμίσεις της ενέργειας Generate with Nous model με επιλεγμένο το Workspace default ως sophea-w4

Οι ρυθμίσεις ενέργειας του Automations με το τρέχον προεπιλεγμένο μοντέλο χώρου εργασίας

Ένα αποθηκευμένο ρητό μοντέλο που αργότερα αποκρύπτεται εκτελείται με την τρέχουσα προεπιλογή και καταγράφει στο ιστορικό εκτέλεσης το ζητούμενο μοντέλο, το μοντέλο που εκτελέστηκε και τον λόγο εναλλακτικής επιλογής. Αναγνωριστικό μοντέλου που λείπει, έχει διαγραφεί, είναι κακοσχηματισμένο, δεν είναι CHAT ή ανήκει σε άλλο χώρο εργασίας αποτυγχάνει πριν από οποιαδήποτε κλήση παρόχου.

Οι λειτουργίες Generate και Refine ανανεώνουν τον κατάλογο όταν ανοίγουν και ξανά πριν από την υποβολή. Αν μια ρητή επιλογή εξαφανιστεί πριν ολοκληρωθεί το κλικ, η λειτουργία σταματά, ανανεώνει τον επιλογέα και περιμένει από τον χρήστη να επιλέξει ή να δοκιμάσει ξανά.

39.4.3 Παράμετροι μοντέλου

Η ενέργεια ask_workspace_model δέχεται: - prompt: το prompt κειμένου (υποχρεωτικό) - systemPrompt: οδηγίες συστήματος (προαιρετικό) - modelId: alias μοντέλου (προεπιλογή: workspace_default) - temperature: θερμοκρασία δειγματοληψίας (0-1, η προεπιλογή διαφέρει ανά μοντέλο)

39.5 Διαμόρφωση webhooks

39.5.1 Webhooks υπογεγραμμένα με HMAC

Το webhook trigger (@activepieces/piece-webhook) υποστηρίζει επαλήθευση υπογραφής HMAC. Στη λειτουργία shell επιτρέπονται μόνο οι τύποι ελέγχου ταυτότητας HEADER και HMAC.

39.5.2 Ρύθμιση

  1. Προσθέστε ένα webhook trigger σε μια ροή
  2. Ορίστε τον τύπο ελέγχου ταυτότητας σε HMAC
  3. Διαμορφώστε το μυστικό HMAC στις ρυθμίσεις του webhook piece
  4. Το URL του webhook θα είναι διαθέσιμο στη διαδρομή /automations/webhooks/{flow-id}
  5. Τα εξωτερικά συστήματα πρέπει να στέλνουν την κεφαλίδα X-Sophea-Signature με την υπογραφή HMAC-SHA256

39.5.3 Επαλήθευση

Το webhook piece επαληθεύει ότι: - Η κεφαλίδα X-Sophea-Signature συμφωνεί με το HMAC-SHA256 του σώματος του αιτήματος - Η κεφαλίδα X-Sophea-Timestamp βρίσκεται εντός του αποδεκτού χρονικού παραθύρου - Στη λειτουργία shell, τα AuthType.NONE και AuthType.BASIC απορρίπτονται

39.6 Διαχείριση προτύπων

39.6.1 Ενσωματωμένα πρότυπα

Η Sophea παρέχει 43 πρότυπα τομέων σε 9 κατηγορίες και 8 αρχικά πρότυπα: - Knowledge (11) - Reports (11) - Research (10) - Review (8) - Approvals (5) - Email (4) - Data (3) - Legal (1) - HR (1)

Ορισμένα πρότυπα εμφανίζονται σε περισσότερες από μία κατηγορίες, επομένως το άθροισμα των καταμετρήσεων ανά κατηγορία υπερβαίνει τα 43.

Τα 8 αρχικά πρότυπα καλύπτουν συνηθισμένα σημεία εκκίνησης: υποβολή ερώτησης σε μοντέλο του χώρου εργασίας, καθημερινό email έρευνας στο διαδίκτυο, απάντηση από ευρετηριασμένη γνώση, καθημερινό email σύνοψης γνώσης, δομημένη εξαγωγή, έγκριση ελέγχου περιεχομένου, αναφορά CSV έτοιμη για Excel και αναφορά έρευνας στο διαδίκτυο από agent.

39.6.2 Προσαρμοσμένα πρότυπα χώρου εργασίας

Οι διαχειριστές χώρου εργασίας μπορούν να δημιουργούν προσαρμοσμένα πρότυπα: 1. Δημιουργήστε μια ροή στο περιβάλλον δημιουργίας 2. Αποθηκεύστε την ως πρότυπο από τις ρυθμίσεις της ροής 3. Το πρότυπο θα είναι διαθέσιμο στη συλλογή προτύπων για όλα τα μέλη του χώρου εργασίας

39.6.3 Κατηγορίες προτύπων

Τα πρότυπα οργανώνονται ανά κατηγορία. Το καρουζέλ κατηγοριών στη συλλογή προτύπων εμφανίζει όλες τις διαθέσιμες κατηγορίες. Τα προσαρμοσμένα πρότυπα εμφανίζονται στην ενότητα My Templates, δηλαδή στα πρότυπα του χρήστη.

39.7 Παρακολούθηση και εντοπισμός σφαλμάτων

39.7.1 Ιστορικό εκτελέσεων

Η πλαϊνή λίστα εκτελέσεων εμφανίζει όλες τις εκτελέσεις ροών με: - Κατάσταση (σε εκτέλεση, επιτυχής, αποτυχημένη, σε παύση) - Διάρκεια - Ώρα έναρξης - Μήνυμα σφάλματος (σε περίπτωση αποτυχίας)

39.7.2 Επιθεώρηση βημάτων

Κάντε κλικ σε οποιαδήποτε εκτέλεση για να επιθεωρήσετε τις εισόδους, τις εξόδους και τα σφάλματα των βημάτων: - Καρτέλα Input: εμφανίζει τα δεδομένα εισόδου κάθε βήματος - Καρτέλα Output: εμφανίζει τα δεδομένα εξόδου και τυχόν μηνύματα σφάλματος - Καρτέλα Timeline: εμφανίζει το χρονοδιάγραμμα εκτέλεσης για τα βήματα agent

39.7.3 Φόρτωση δεδομένων εκτέλεσης σε δοκιμές

Μπορείτε να φορτώσετε δεδομένα εκτέλεσης στον πίνακα δοκιμών: 1. Ανοίξτε μια εκτέλεση από τη λίστα εκτελέσεων 2. Επιλέξτε το βήμα στο οποίο θέλετε να εντοπίσετε σφάλματα 3. Κάντε κλικ στο Load into test, δηλαδή φόρτωση στη δοκιμή, για να συμπληρώσετε τον πίνακα δοκιμών με τα δεδομένα του βήματος από την εκτέλεση 4. Τροποποιήστε την είσοδο και δοκιμάστε ξανά το βήμα