40  Οδηγός χρήστη Automations

40.1 Επισκόπηση

Αυτός ο οδηγός εξηγεί πώς να δημιουργείτε, να δοκιμάζετε και να δημοσιεύετε αυτοματοποιημένες ροές εργασίας με τα Sophea Automations.

40.2 Έναρξη

40.2.1 Άνοιγμα του περιβάλλοντος δημιουργίας

  1. Συνδεθείτε στο web UI του Sophea Nous
  2. Κάντε κλικ στο Automations στην πλαϊνή γραμμή, δηλαδή στην ενότητα αυτοματισμών
  3. Κάντε κλικ στο Create Flow, δηλαδή δημιουργία ροής, για να ανοίξετε το περιβάλλον δημιουργίας

40.2.2 Το περιβάλλον δημιουργίας

Το περιβάλλον δημιουργίας έχει τέσσερις κύριες περιοχές:

  1. Canvas: το διάγραμμα ροής που εμφανίζει triggers και ενέργειες
  2. Αριστερή πλαϊνή γραμμή: ιστορικό εκτελέσεων, ρυθμίσεις ροής και λίστα ροών
  3. Δεξιός πίνακας: διαμόρφωση βήματος, η οποία εμφανίζεται όταν επιλέγεται ένα βήμα
  4. Πίνακας δοκιμών: δοκιμή βημάτων και δείγματα δεδομένων, κάτω δεξιά

40.3 Δημιουργία της πρώτης σας ροής

40.3.1 Βήμα 1: Επιλέξτε trigger

Κάθε ροή ξεκινά με ένα trigger. Διαθέσιμα triggers:

  • Manual Trigger: ξεκινά τη ροή χειροκίνητα με κλικ στο Run
  • Schedule: εκτελεί τη ροή με επαναλαμβανόμενο χρονοδιάγραμμα, καθημερινά, εβδομαδιαία ή μηνιαία
  • Webhook: ξεκινά τη ροή όταν ένα εξωτερικό σύστημα στέλνει ένα αίτημα HTTP
  • Agent Run Completed: ξεκινά τη ροή όταν ολοκληρωθεί ένας Nous agent
  • Document Indexed: ξεκινά τη ροή όταν ολοκληρωθεί η ευρετηρίαση ενός εγγράφου στη βάση γνώσης
  • Connector Sync Completed: ξεκινά τη ροή όταν ολοκληρωθεί επιτυχώς ένας κύκλος συγχρονισμού connector
  • Connector Sync Failed: ξεκινά τη ροή όταν αποτύχει ένας κύκλος συγχρονισμού connector

Για να προσθέσετε ένα trigger: 1. Κάντε κλικ στον κόμβο trigger στον καμβά 2. Επιλέξτε τον τύπο trigger από το αναπτυσσόμενο μενού 3. Διαμορφώστε τις ρυθμίσεις του trigger στον δεξιό πίνακα

40.3.2 Βήμα 2: Προσθέστε ενέργειες

Οι ενέργειες είναι τα βήματα που εκτελούνται μετά το trigger. Για να προσθέσετε μια ενέργεια:

  1. Κάντε κλικ στο κουμπί + κάτω από το trigger ή οποιαδήποτε ενέργεια
  2. Περιηγηθείτε στον επιλογέα pieces ή αναζητήστε μια συγκεκριμένη ενέργεια
  3. Επιλέξτε την ενέργεια που θέλετε να προσθέσετε
  4. Διαμορφώστε τις εισόδους της ενέργειας στον δεξιό πίνακα

40.3.3 Προεπιλογές CSV και ημερομηνίας

Δύο συνηθισμένες ενέργειες δεδομένων ξεκινούν με υποστηριζόμενες προεπιλογές, τις οποίες μπορείτε να αλλάξετε όταν τα δεδομένα εισόδου απαιτούν διαφορετική μορφή:

  • Η ενέργεια Convert CSV to JSON ορίζει το Delimiter Type, δηλαδή τον τύπο διαχωριστικού, σε Comma, δηλαδή κόμμα.

Ρυθμίσεις Convert CSV to JSON με το Delimiter Type ορισμένο σε Comma

Η ενέργεια Convert CSV to JSON με επιλεγμένο το κόμμα ως διαχωριστικό
  • Η ενέργεια Add/Subtract Time ορίζει τόσο το From Time Format, δηλαδή τη μορφή χρόνου εισόδου, όσο και το To Time Format, δηλαδή τη μορφή χρόνου εξόδου, σε DDD MMM DD YYYY HH:mm:ss (Sun Sep 17 2023 11:23:58).

Ρυθμίσεις Add/Subtract Time με επιλεγμένες τις προεπιλογές From Time Format και To Time Format

Η ενέργεια Add/Subtract Time με τις υποστηριζόμενες προεπιλογές μορφής εισόδου και εξόδου

40.3.4 Διαθέσιμες ενέργειες Sophea

Κατηγορία Ενέργειες
Γνώση ask_nous_knowledge, search_knowledge, batch_search_knowledge, fetch_chunks
AI ask_workspace_model, run_nous_agent
Κύκλος ζωής agent start_agent_run, get_agent_run_status, cancel_agent_run, get_agent_run_artifacts
Εγκρίσεις request_human_approval, create_approval_task, llm_approval
Χώρος εργασίας list_connectors, list_workspace_users, list_workspace_teams, fetch_saved_searches, notify_workspace, send_workspace_email
Έγγραφα upload_document, get_document_status

40.3.5 Βήμα 3: Αναφερθείτε σε προηγούμενα βήματα

Μπορείτε να αναφερθείτε στην έξοδο προηγούμενων βημάτων με τη σύνταξη {stepName.output}. Για παράδειγμα: - {trigger.output.body.email} για αναφορά στο email από ένα webhook trigger - {step_1.output.answer} για αναφορά στην απάντηση από μια αναζήτηση γνώσης - {step_1.output.chunks[0].content} για αναφορά στο πρώτο τμήμα μιας αναζήτησης

40.3.6 Βήμα 4: Δοκιμάστε τη ροή

Πριν από τη δημοσίευση, δοκιμάστε κάθε βήμα:

  1. Επιλέξτε το βήμα που θέλετε να δοκιμάσετε
  2. Κάντε κλικ στο Test Step, δηλαδή δοκιμή βήματος, στον πίνακα δοκιμών
  3. Το βήμα εκτελείται και εμφανίζει την έξοδο
  4. Χρησιμοποιήστε την έξοδο για να διαμορφώσετε τα επόμενα βήματα

40.3.7 Βήμα 5: Δημοσιεύστε τη ροή

  1. Κάντε κλικ στο Publish, δηλαδή δημοσίευση, επάνω δεξιά
  2. Η ροή είναι πλέον ενεργή και θα εκτελεστεί όταν ενεργοποιηθεί το trigger
  3. Μπορείτε να δείτε τις δημοσιευμένες ροές στην καρτέλα Runs, δηλαδή εκτελέσεις

40.4 Χρήση προτύπων

40.4.1 Περιήγηση στα πρότυπα

  1. Κάντε κλικ στο Templates, δηλαδή πρότυπα, στην πλαϊνή γραμμή
  2. Περιηγηθείτε ανά κατηγορία με το καρουζέλ κατηγοριών
  3. Κάντε κλικ σε οποιοδήποτε πρότυπο για να δείτε μια προεπισκόπηση

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

Κατηγορία Πλήθος Παραδείγματα
Knowledge 11 Απάντηση FAQ, ανάλυση κενών, ερωτήσεις και απαντήσεις πολιτικής
Reports 11 Σύνοψη για στελέχη, ανασκόπηση συμβάντος, σημειώσεις έκδοσης
Research 10 Ανάλυση ανταγωνιστών, πληροφορίες αγοράς, παρακολούθηση κανονισμών
Review 8 Έλεγχος περιεχομένου, έλεγχος κώδικα, αξιολόγηση προμηθευτή
Approvals 5 Έλεγχος αιτήματος αλλαγής, πύλη ελέγχου ασφαλείας
Email 4 Ειδοποίηση συναγερμού, εβδομαδιαία σύνοψη γνώσης
Data 3 Εμπλουτισμός δεδομένων, σύνοψη εγγραφών, κατάργηση διπλοτύπων
Legal 1 Σύνοψη νομικών ρητρών
HR 1 Δημιουργία περιγραφής θέσης εργασίας

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

40.4.3 Δημιουργία ροής από πρότυπο

  1. Περιηγηθείτε στη συλλογή προτύπων
  2. Κάντε κλικ σε ένα πρότυπο που ταιριάζει στην περίπτωση χρήσης σας
  3. Ελέγξτε την περιγραφή του προτύπου και τις απαιτήσεις ρύθμισης
  4. Κάντε κλικ στο Use Template, δηλαδή χρήση προτύπου, για να δημιουργήσετε μια νέα ροή
  5. Διαμορφώστε τις υποχρεωτικές εισόδους, όπως κλειδιά API και παραλήπτες email
  6. Δοκιμάστε και δημοσιεύστε τη ροή

40.4.4 Αποθήκευση προσαρμοσμένων προτύπων

  1. Δημιουργήστε μια ροή στο περιβάλλον δημιουργίας
  2. Κάντε κλικ στο Save as Template, δηλαδή αποθήκευση ως πρότυπο, στις ρυθμίσεις της ροής
  3. Δώστε στο πρότυπο όνομα και περιγραφή
  4. Το πρότυπο θα είναι διαθέσιμο στο My Templates, δηλαδή στα πρότυπα του χρήστη, για τον χώρο εργασίας σας

40.5 Δοκιμές και εντοπισμός σφαλμάτων

40.5.1 Δοκιμή μεμονωμένων βημάτων

  1. Επιλέξτε ένα βήμα στον καμβά
  2. Κάντε κλικ στο Test Step στον πίνακα δοκιμών
  3. Το βήμα εκτελείται και εμφανίζει την έξοδο
  4. Χρησιμοποιήστε την έξοδο για να διαμορφώσετε το επόμενο βήμα

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

Εάν ένα βήμα απέτυχε σε προηγούμενη εκτέλεση, μπορείτε να φορτώσετε τα δεδομένα της εκτέλεσης στον πίνακα δοκιμών:

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

40.5.3 Προβολή ιστορικού εκτελέσεων

  1. Κάντε κλικ στο εικονίδιο Runs στην αριστερή πλαϊνή γραμμή
  2. Φιλτράρετε κατά κατάσταση (όλες, σε εκτέλεση, επιτυχείς, αποτυχημένες, σε παύση)
  3. Κάντε κλικ σε οποιαδήποτε εκτέλεση για να επιθεωρήσετε τις εισόδους και τις εξόδους των βημάτων
  4. Χρησιμοποιήστε την αναζήτηση σφαλμάτων για να βρείτε εκτελέσεις με συγκεκριμένα μηνύματα σφάλματος

40.5.4 Ακύρωση εκτελέσεων

  • Οι εκτελέσεις που βρίσκονται σε εξέλιξη δεν μπορούν να ακυρωθούν, πρέπει να ολοκληρωθούν ή να λήξουν
  • Οι εκτελέσεις σε ουρά μπορούν να ακυρωθούν από τη λίστα εκτελέσεων
  • Οι εκτελέσεις σε παύση, οι οποίες περιμένουν έγκριση, μπορούν να ακυρωθούν

40.6 Χρήση AI για τη δημιουργία ροών

40.6.1 Δημιουργία ροής με AI

Αντί να δημιουργήσετε μια ροή χειροκίνητα, μπορείτε να περιγράψετε σε φυσική γλώσσα τι θέλετε:

  1. Κάντε κλικ στο Generate with AI, δηλαδή δημιουργία με AI, στο περιβάλλον δημιουργίας.
  2. Επιλέξτε Workspace default ή ένα ορατό ρητό μοντέλο.
  3. Περιγράψτε τη ροή εργασίας που θέλετε να δημιουργήσετε.
  4. Το AI δημιουργεί μια ροή με κατάλληλα triggers και ενέργειες.
  5. Ελέγξτε τη ροή, δοκιμάστε την και δημοσιεύστε την.

Παράθυρο Create with AI με επιλεγμένο το Sophea W4 και ένδειξη ότι είναι το προεπιλεγμένο μοντέλο

Το παράθυρο Create with AI χρησιμοποιεί το Sophea W4 ως προεπιλογή του χώρου εργασίας

40.6.2 Συμβουλές για τη δημιουργία ροής με AI

  • Να είστε συγκεκριμένοι ως προς το trigger, για παράδειγμα «Εκτέλεση καθημερινά στις 9 π.μ.» ή «Όταν λαμβάνεται ένα webhook»
  • Αναφέρετε ποιες ενέργειες Sophea θέλετε, για παράδειγμα «Αναζήτησε στη βάση γνώσης και στείλε ένα email»
  • Συμπεριλάβετε την αναμενόμενη μορφή εισόδου και εξόδου
  • Το AI χρησιμοποιεί τις ενέργειες του Sophea piece, επομένως περιγράψτε τη ροή εργασίας με όρους όπως αναζήτηση γνώσης, μοντέλο AI και email

40.6.3 Βελτίωση μιας ροής που δημιουργήθηκε

Αφού το AI δημιουργήσει μια ροή, μπορείτε να την επεξεργαστείτε με επόμενες οδηγίες αντί να ξεκινήσετε από την αρχή:

  1. Κάντε κλικ στο Refine with AI, δηλαδή βελτίωση με AI, στην κεφαλίδα του περιβάλλοντος δημιουργίας ροών.
  2. Περιγράψτε την αλλαγή που θέλετε, για παράδειγμα Πρόσθεσε ένα βήμα email μετά την αναζήτηση γνώσης ή Άλλαξε το πρόγραμμα σε εβδομαδιαίο.
  3. Επιβεβαιώστε το Workspace default ή επιλέξτε ένα ορατό ρητό μοντέλο και, στη συνέχεια, κάντε κλικ στο Refine. Το AI ενημερώνει τη ροή και διατηρεί ανέπαφη την υπόλοιπη.
  4. Ελέγξτε την ενημερωμένη ροή και συνεχίστε τη βελτίωση ή δημοσιεύστε την.

Μπορείτε να επαναλάβετε τη βελτίωση πολλές φορές. Κάθε βελτίωση βασίζεται στην τρέχουσα κατάσταση της ροής, επομένως δεν χρειάζεται να ξεκινήσετε ξανά όταν θέλετε να κάνετε προσαρμογές.

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

40.7 Επιλογή μοντέλων στα βήματα ροής

Οι ενέργειες Nous που χρησιμοποιούν μοντέλο προσφέρουν το Workspace default και τα ορατά ρητά μοντέλα που είναι διαθέσιμα στον χώρο εργασίας.

  • Το Workspace default συνιστάται για τις περισσότερες ροές. Η αποθηκευμένη ροή ακολουθεί την τρέχουσα προεπιλογή του χώρου εργασίας σε κάθε εκτέλεση.
  • Ένα ρητό μοντέλο παραμένει σταθερό όσο είναι ορατό. Αν ένας διαχειριστής το αποκρύψει αργότερα, η αποθηκευμένη ροή χρησιμοποιεί την τρέχουσα προεπιλογή και καταγράφει στις λεπτομέρειες εκτέλεσης το ζητούμενο μοντέλο, το μοντέλο που εκτελέστηκε και τον λόγο εναλλακτικής επιλογής.
  • Αναγνωριστικό μοντέλου που έχει διαγραφεί, είναι κακοσχηματισμένο ή ανήκει σε άλλο χώρο εργασίας σταματά με ασφάλεια το βήμα. Ανοίξτε το βήμα, ανανεώστε τη λίστα μοντέλων και επιλέξτε ρητά πριν από νέα προσπάθεια.

40.8 Εγκρίσεις

40.8.1 Εγκρίσεις με ανθρώπινη παρέμβαση

Η ενέργεια request_human_approval θέτει τη ροή σε παύση και περιμένει από έναν άνθρωπο να εγκρίνει ή να απορρίψει:

  1. Προσθέστε την ενέργεια request_human_approval μετά από ένα βήμα AI
  2. Διαμορφώστε το μήνυμα έγκρισης και τον υπεύθυνο
  3. Η ροή τίθεται σε παύση όταν φτάσει σε αυτό το βήμα
  4. Ο χρήστης που έχει οριστεί λαμβάνει ένα email με σύνδεσμο για έγκριση ή απόρριψη
  5. Εάν εγκριθεί, η ροή συνεχίζεται. Εάν απορριφθεί, η ροή σταματά.

40.8.2 Πύλες έγκρισης LLM

Η ενέργεια llm_approval χρησιμοποιεί ένα μοντέλο AI για έγκριση ή απόρριψη βάσει κριτηρίων:

  1. Προσθέστε την ενέργεια llm_approval
  2. Ορίστε το criteria, για παράδειγμα «Έγκριση εάν το περιεχόμενο είναι επαγγελματικό και ακριβές»
  3. Ορίστε το subject, δηλαδή το περιεχόμενο προς αξιολόγηση
  4. Ορίστε το confidenceThreshold (0-1, προεπιλογή 0,8)
  5. Το AI αξιολογεί το αντικείμενο βάσει των κριτηρίων και επιστρέφει έγκριση ή απόρριψη

40.8.3 Πίνακας εργασίας εγκρίσεων

Ο πίνακας εργασίας εγκρίσεων εμφανίζει όλες τις εκκρεμείς εργασίες έγκρισης: 1. Κάντε κλικ στο Approvals, δηλαδή εγκρίσεις, στην πλαϊνή γραμμή 2. Δείτε τις εκκρεμείς, εγκεκριμένες και απορριφθείσες εργασίες 3. Κάντε κλικ σε οποιαδήποτε εργασία για να την εγκρίνετε ή να την απορρίψετε

40.9 Email

40.9.1 Αποστολή email χώρου εργασίας

Η ενέργεια send_workspace_email στέλνει ένα email σε μέλη του χώρου εργασίας:

  1. Προσθέστε την ενέργεια send_workspace_email
  2. Ορίστε το recipientMode σε RUN_USER (αποστολή στο άτομο που εκτελεί τη ροή) ή WORKSPACE_MEMBERS (επιλεγμένα μέλη του χώρου εργασίας)
  3. Εάν επιλέξετε WORKSPACE_MEMBERS, επιλέξτε τους παραλήπτες από τη λίστα μελών του χώρου εργασίας
  4. Ορίστε το θέμα και το σώμα
  5. Ορίστε το bodyFormat σε markdown ή plain_text

40.9.2 Συνήθη μοτίβα email

  • Καθημερινή ενημέρωση: Schedule trigger + ask_workspace_model + send_workspace_email
  • Ειδοποίηση συναγερμού: Webhook trigger + ask_workspace_model + send_workspace_email
  • Εβδομαδιαία σύνοψη: Schedule trigger + ask_nous_knowledge + send_workspace_email