Μετάβαση στο κύριο περιεχόμενο

Πράκτορες AI

Ένας πράκτορας AI είναι ένας βοηθός πολλών βημάτων. Διαβάζει τη συνομιλία, σχεδιάζει, καλεί εργαλεία (τα εργαλεία AI σας, εργαλεία MCP και μια αναζήτηση στη βάση γνώσεων), εξετάζει τα αποτελέσματα και καλεί ξανά το μοντέλο μέχρι να καταλήξει σε απάντηση. Ο κόμβος Δημιουργία ολοκλήρωσης συνομιλίας AI κάνει μία μόνο κλήση μοντέλου και απαντά· ο κόμβος Πράκτορας AI μπορεί να συνεχίσει να δουλεύει μέσα από πολλές κλήσεις μοντέλου και εργαλείων, εντός των ορίων που θα ορίσετε, πριν απαντήσει.

Χρησιμοποιήστε έναν πράκτορα όταν ένα αίτημα χρειάζεται πολλά βήματα, για παράδειγμα «βρες την παραγγελία του πελάτη, έλεγξε την κατάσταση παράδοσής της και πρότεινε νέα ημερομηνία». Για μια άμεση απάντηση από οδηγίες και μια βάση γνώσεων, ο κόμβος AI είναι απλούστερος και φθηνότερος.

Τα δομικά στοιχεία​

ΜέροςΤι είναιΠού το ορίζετε
Harness AIΗ μηχανή που εκτελεί τον βρόχο του πράκτορα: η δική του του MonoChat, ένα SDK πράκτορα ή μια φιλοξενούμενη υπηρεσία πρακτόρων.Ρυθμίσεις › Αυτοματοποίηση › Harnesses AI
ΜοντέλαΤα μοντέλα AI με τα οποία σκέφτεται ο πράκτορας: ένα κύριο μοντέλο, ένα προαιρετικό εφεδρικό μοντέλο και ένα προαιρετικό γρήγορο μοντέλο. Τα φιλοξενούμενα harnesses χρησιμοποιούν αντί γι' αυτά τα μοντέλα του δικού τους παρόχου.Ο κόμβος Πράκτορας AI
ΕργαλείαΠεδία εφαρμογής AI, συναρτήσεις AI Tool και εργαλεία MCP.Ο κόμβος Πράκτορας AI
Προϋπολογισμός εκτέλεσηςΌρια για κλήσεις μοντέλου, κλήσεις εργαλείων, tokens, διάρκεια και επαναλήψεις σε κάθε εκτέλεση.Ο κόμβος Πράκτορας AI
ΕκτέλεσηΜία εκτέλεση του πράκτορα. Κάθε εκτέλεση καταγράφεται στις Εκτελέσεις πρακτόρων AI.Δημιουργείται από τον κόμβο ή το API

Harnesses AI​

Το Ρυθμίσεις › Αυτοματοποίηση › Harnesses AI απαριθμεί τα harnesses στα οποία μπορούν να εκτελεστούν οι πράκτορές σας: αυτά που προσφέρει το MonoChat σε κάθε χώρο εργασίας και αυτά που προσθέτετε εσείς με τα δικά σας διαπιστευτήρια.

HarnessΠού εκτελείταιΜοντέλα που χρησιμοποιείΠοιος το προσθέτει
MonoChat NativeΜέσα στο MonoChatΤα μοντέλα AI σαςMonoChat
OpenAI Agents SDKΜέσα στο MonoChatΤα μοντέλα AI σαςMonoChat
Claude Agent SDKΣτον agent runner του MonoChatΤα μοντέλα AI σαςMonoChat
piΣτον agent runner του MonoChatΤα μοντέλα AI σαςMonoChat
OpenAI Agents APIΣτο cloud της OpenAIΤα επιτρεπόμενα μοντέλα του harnessΕσείς, με το κλειδί API της OpenAI (το MonoChat μπορεί να προσφέρει και αυτό ένα)
Claude Managed AgentsΣτο cloud της AnthropicΤα επιτρεπόμενα μοντέλα του harnessΕσείς, με το κλειδί API της Anthropic (το MonoChat μπορεί να προσφέρει και αυτό ένα)
Custom EndpointΣτον δικό σας διακομιστήΤα μοντέλα AI σας (προαιρετικά)Εσείς, με το endpoint και το μυστικό σας

Τα harnesses που εκτελούνται στο MonoChat προσφέρονται από το MonoChat· ο χώρος εργασίας σας μπορεί να προσθέσει μόνο harnesses που δέχονται τα δικά του διαπιστευτήρια. Τα Claude Agent SDK και pi χρειάζονται τον agent runner του MonoChat: όπου αυτός δεν έχει ρυθμιστεί, μια εκτέλεση σε αυτά αποτυγχάνει με το μήνυμα «Αυτό το harness δεν είναι διαθέσιμο σε αυτόν τον διακομιστή.»

Όποιο κι αν είναι το harness, το MonoChat διατηρεί τον έλεγχο: κάθε κλήση μοντέλου ενός harness που χρησιμοποιεί τα μοντέλα AI σας περνά μέσα από το MonoChat (έτσι εφαρμόζονται η χρέωση και ο προϋπολογισμός), κάθε κλήση εργαλείου εκτελεί τις συναρτήσεις, τα εργαλεία MCP και τα πεδία εφαρμογής AI του χώρου εργασίας σας, και ο προϋπολογισμός επιβάλλεται σε κάθε harness.

Προσθήκη harness​

  1. Μεταβείτε στο Ρυθμίσεις › Αυτοματοποίηση › Harnesses AI και κάντε κλικ στο + (Δημιουργία).
  2. Εισαγάγετε ένα Όνομα και, προαιρετικά, μια Περιγραφή.
  3. Επιλέξτε το Harness. Κάθε επιλογή δείχνει πού εκτελείται.
  4. Στα Διαπιστευτήρια, εισαγάγετε ό,τι χρειάζεται το harness:
    • OpenAI Agents API, Claude Managed Agents: Κλειδί API.
    • Custom Endpoint: Endpoint και Κλειδί API.
  5. Για ένα φιλοξενούμενο harness, συμπληρώστε τα Επιτρεπόμενα μοντέλα: εισαγάγετε τα ονόματα μοντέλων του παρόχου (για παράδειγμα το ID μοντέλου της OpenAI ή της Anthropic). Χρησιμοποιήστε το Προσθήκη μοντέλου για έως και 10 μοντέλα. Οι πράκτορες σε αυτό το harness μπορούν να επιλέξουν μόνο από αυτή τη λίστα.
  6. Κάντε κλικ στο Αποθήκευση.

Όταν επεξεργάζεστε ένα harness, ο τύπος Harness δεν μπορεί να αλλάξει και το πεδίο κλειδιού γράφει Κλειδί API (αφήστε κενό για να διατηρηθεί το αποθηκευμένο κλειδί).

Claude Managed Agents

Την πρώτη φορά που χρησιμοποιείται ένα harness αυτού του τύπου, το MonoChat δημιουργεί έναν πράκτορα και ένα περιβάλλον σε αυτόν τον λογαριασμό Anthropic και τα επαναχρησιμοποιεί στη συνέχεια.

Custom Endpoint​

Ένα harness Custom Endpoint στέλνει τις εκτελέσεις στη δική σας υπηρεσία, για παράδειγμα σε έναν πράκτορα που φιλοξενείτε μόνοι σας. Για κάθε εκτέλεση το MonoChat στέλνει ένα POST στο <Endpoint>/runs με Authorization: Bearer <API Key>. Το σώμα περιέχει το ID της εκτέλεσης, τις οδηγίες, την είσοδο, τα μηνύματα της συνομιλίας, τον προϋπολογισμό, τα ψευδώνυμα μοντέλων (agent-main, agent-fallback, agent-fast) και τρία URL με ένα token για αυτή την εκτέλεση:

  • μια πύλη μοντέλων (βασικά URL συμβατά με OpenAI …/v1 και με Anthropic) που καλεί τα μοντέλα AI του κόμβου και επιβάλλει τον προϋπολογισμό,
  • έναν διακομιστή MCP που εκθέτει τα εργαλεία της εκτέλεσης,
  • ένα URL συμβάντων όπου η υπηρεσία σας αναφέρει το αποτέλεσμα (completed με result ή failed με error).

Το token της εκτέλεσης παύει να λειτουργεί όταν τελειώσει η εκτέλεση.

Ο κόμβος Πράκτορας AI​

Προσθέστε έναν πράκτορα σε μια ροή με τον κόμβο Πράκτορας AI, κάτω από τους υβριδικούς κόμβους στον σχεδιαστή ροών. Δείτε τις Ροές για το πώς προστίθενται και συνδέονται οι κόμβοι.

Πεδία​

ΕνότηταΠεδίοΠεριγραφή
ΌνομαΤο όνομα του κόμβου που εμφανίζεται στον καμβά.
Harness AIΥποχρεωτικό. Το harness που εκτελεί τον πράκτορα.
ΟδηγίεςΟι οδηγίες συστήματος του πράκτορα: ο ρόλος, ο τόνος, οι κανόνες του και τι επιτρέπεται ή δεν επιτρέπεται να κάνει.
Εργασία (προστίθεται στις οδηγίες του πράκτορα· μπορούν να χρησιμοποιηθούν ετικέτες)Τι ζητά αυτός ο κόμβος από τον πράκτορα. Προστίθεται μετά τις οδηγίες και μπορεί να χρησιμοποιεί τις ίδιες ετικέτες με το prompt του κόμβου AI, για παράδειγμα για να περιλάβει δεδομένα πελάτη.
ΜοντέλαΚύριο μοντέλοΤο μοντέλο που χρησιμοποιεί ο πράκτορας. Υποχρεωτικό για κάθε harness εκτός από το Custom Endpoint.
Εφεδρικό μοντέλο (μετά το ήπιο όριο)Το μοντέλο στο οποίο περνά ο πράκτορας όταν φτάσει στο ήπιο όριο κλήσεων μοντέλου, συνήθως ένα φθηνότερο ή ταχύτερο μοντέλο.
Γρήγορο μοντέλο (ελαφριές εργασίες παρασκηνίου)Ένα μοντέλο που μπορεί να χρησιμοποιήσει ένα harness για τις ελαφριές κλήσεις παρασκηνίου του.
Μοντέλο (ένα από τα επιτρεπόμενα μοντέλα του harness)Εμφανίζεται αντί για τα τρία παραπάνω πεδία σε ένα φιλοξενούμενο harness.
Συνεδρία πράκτοραΣυνεδρίαΣυνέχιση της υπάρχουσας συνεδρίας πράκτορα (προεπιλογή) ή Έναρξη νέας συνεδρίας πράκτορα. Δείτε τις Συνεδρίες πράκτορα.
Κλειδί εργασίας (ξεχωριστές συνεδρίες πράκτορα ανά εργασία)Προαιρετικό. Διατηρεί ξεχωριστή συνεδρία πράκτορα για κάθε κλειδί στην ίδια συνομιλία, για παράδειγμα booking και support.
Όριο ιστορικού μηνυμάτωνΠόσα μηνύματα της συνομιλίας λαμβάνει ο πράκτορας.
Μοντέλα AI μετατροπής ομιλίας σε κείμενοΈνα μοντέλο με Μεταγραφή. Τα φωνητικά μηνύματα της συνομιλίας φτάνουν στον πράκτορα ως κείμενο.
Ρυθμίσεις εργαλείουΠεδία εφαρμογής AIΒάσεις γνώσεων στις οποίες μπορεί να κάνει αναζήτηση ο πράκτορας. Προσφέρονται στον πράκτορα ως εργαλείο αναζήτησης στη βάση γνώσεων.
Εργαλείο AIΣυναρτήσεις τύπου Εργαλείο AI που μπορεί να καλέσει ο πράκτορας.
Συνδεδεμένοι διακομιστές MCPΔιακομιστές MCP των οποίων τα εργαλεία μπορεί να καλέσει ο πράκτορας. Δείτε τους Συνδεδεμένους διακομιστές MCP.
Επιλογή εργαλείων διακομιστή MCPΑνοίγει τη λίστα με τα εργαλεία των επιλεγμένων διακομιστών, όπου μπορείτε να εξαιρέσετε ορισμένα από αυτόν τον κόμβο.
ΜηνύματαΠροώθηση ενδιάμεσων μηνυμάτων στον πελάτηΑπενεργοποιημένο από προεπιλογή. Όσα γράφει ο πράκτορας ενώ εργάζεται ακόμη (για παράδειγμα «Επιτρέψτε μου να ελέγξω την παραγγελία σας») αποστέλλονται στον πελάτη όταν η επιλογή είναι ενεργή· όταν είναι απενεργοποιημένη, προστίθενται στη συνεδρία ως μήνυμα whisper που βλέπει μόνο η ομάδα σας.
Αποστολή απάντησηςΕνεργοποιημένο από προεπιλογή. Στέλνει την τελική απάντηση του πράκτορα στον πελάτη. Απενεργοποιήστε το για να χρησιμοποιήσετε την απάντηση μόνο μέσα στη ροή.
Προϋπολογισμός εκτέλεσηςΜέγ. κλήσεις μοντέλουΠροεπιλογή 4.
Ήπιο όριο: κλήσεις μοντέλουΠροαιρετικό. Μετά από αυτό το πλήθος κλήσεων μοντέλου ο πράκτορας περνά στο εφεδρικό μοντέλο. Πρέπει να είναι μικρότερο από το Μέγ. κλήσεις μοντέλου και απαιτεί εφεδρικό μοντέλο.
Μέγ. κλήσεις εργαλείωνΠροεπιλογή 6. Με 0, η εκτέλεση τελειώνει ως Υπέρβαση προϋπολογισμού μόλις ο πράκτορας προσπαθήσει να καλέσει εργαλείο.
Μέγ. συνολικά tokensΠροεπιλογή 20000. Tokens εισόδου και εξόδου όλων των κλήσεων μοντέλου της εκτέλεσης.
Μέγ. διάρκεια (δευτερόλεπτα)Προεπιλογή 30.
Μέγ. επαναλήψειςΠροεπιλογή 2. Πόσες φορές επαναλαμβάνεται μια αποτυχημένη κλήση μοντέλου.
συμβουλή

Γράψτε τους σταθερούς κανόνες στις Οδηγίες και τη συγκεκριμένη δουλειά αυτού του βήματος στην Εργασία. Έτσι, πολλοί κόμβοι Πράκτορας AI σε μια ροή μπορούν να μοιράζονται τις ίδιες οδηγίες και να διαφέρουν μόνο στην εργασία τους.

προειδοποίηση

Τα φιλοξενούμενα harnesses δεν υποστηρίζουν ήπιο όριο, επειδή δεν μπορούν να περάσουν σε εφεδρικό μοντέλο. Αφήστε κενό το Ήπιο όριο: κλήσεις μοντέλου γι' αυτά.

Τι συμβαίνει όταν η ροή φτάσει στον κόμβο​

  1. Το MonoChat ελέγχει το υπόλοιπό σας και τις ρυθμίσεις του κόμβου, και ξεκινά μια εκτέλεση. Η εκτέλεση είναι Στην ουρά και έπειτα Σε εκτέλεση. Το στιγμιότυπο της ροής περιμένει στον κόμβο.
  2. Ο πράκτορας λαμβάνει τις οδηγίες και την εργασία και, όταν η ροή ανήκει σε συνομιλία, τα μηνύματα της συνομιλίας έως το Όριο ιστορικού μηνυμάτων, με τα φωνητικά μηνύματα μεταγεγραμμένα.
  3. Ο πράκτορας καλεί μοντέλα και εργαλεία μέχρι να καταλήξει σε απάντηση ή να φτάσει σε κάποιο όριο. Το κείμενο που γράφει ανάμεσα στις κλήσεις εργαλείων αντιμετωπίζεται ως ενδιάμεσο μήνυμα.
  4. Όταν τελειώσει η εκτέλεση:
    • αν Ολοκληρώθηκε και η επιλογή Αποστολή απάντησης είναι ενεργή, η απάντηση στέλνεται στον πελάτη. Οι μεγάλες απαντήσεις χωρίζονται σε περισσότερα μηνύματα όταν υπερβαίνουν το όριο του καναλιού (4096 χαρακτήρες στο WhatsApp)·
    • αν τελείωσε με άλλον τρόπο, στη συνεδρία προστίθεται για την ομάδα σας ένα μήνυμα whisper «Η εκτέλεση του πράκτορα AI τελείωσε: κατάσταση. σφάλμα».
  5. Η ροή συνεχίζεται στην έξοδο που αντιστοιχεί στον τρόπο που τελείωσε η εκτέλεση.

Οι εκτελέσεις της ίδιας συνεδρίας πράκτορα επεξεργάζονται μία τη φορά, με τη σειρά.

Έξοδοι​

ΈξοδοςΠότε
ΟλοκληρώθηκεΟ πράκτορας τελείωσε με μια απάντηση.
Υπέρβαση προϋπολογισμούΗ εκτέλεση εξάντλησε τα Μέγ. κλήσεις μοντέλου, Μέγ. κλήσεις εργαλείων ή Μέγ. συνολικά tokens.
Έληξε ο χρόνοςΗ εκτέλεση έφτασε στη Μέγ. διάρκεια (δευτερόλεπτα).
Μίσος, Jailbreak, Αυτοτραυματισμός, Σεξουαλικό περιεχόμενο, ΒίαΤο φίλτρο περιεχομένου του παρόχου του μοντέλου σταμάτησε την εκτέλεση για αυτή την κατηγορία. Είναι οι ίδιες έξοδοι που έχει ο κόμβος AI.
Σε αποτυχίαΗ εκτέλεση απέτυχε για οποιονδήποτε άλλο λόγο ή ακυρώθηκε. Μια διακοπή από φίλτρο περιεχομένου καταλήγει επίσης εδώ σε κόμβους που αποθηκεύτηκαν πριν υπάρξουν αυτές οι έξοδοι· ανοίξτε και αποθηκεύστε έναν τέτοιο κόμβο για να τις αποκτήσει.

Συνδέστε τουλάχιστον τις εξόδους Ολοκληρώθηκε και Σε αποτυχία. Ένα συνηθισμένο μοτίβο είναι να στέλνετε τις εξόδους Υπέρβαση προϋπολογισμού, Έληξε ο χρόνος και Σε αποτυχία σε έναν κόμβο Ανάθεση συνεδρίας, ώστε να αναλάβει ένας συνάδελφος.

Συνεδρίες πράκτορα​

Μια συνεδρία πράκτορα είναι η μνήμη του πράκτορα ανάμεσα στις εκτελέσεις. Το MonoChat διατηρεί μία ενεργή συνεδρία πράκτορα ανά συνομιλία, harness και κλειδί εργασίας.

  • Η Συνέχιση της υπάρχουσας συνεδρίας πράκτορα την επαναχρησιμοποιεί, ώστε ο πράκτορας να συνεχίζει από εκεί που σταμάτησε. Στα φιλοξενούμενα harnesses συνεχίζεται και η δική τους συνεδρία του παρόχου.
  • Η Έναρξη νέας συνεδρίας πράκτορα κλείνει την ενεργή και ξεκινά από την αρχή, για παράδειγμα στην αρχή ενός νέου θέματος.
  • Ένα Κλειδί εργασίας διατηρεί ανεξάρτητες συνεδρίες δίπλα-δίπλα στην ίδια συνομιλία.

Ο κόμβος Συνομιλία AI​

Ο κόμβος Συνομιλία AI κρατά μια συνομιλία σε εξέλιξη. Ο κόμβος Πράκτορας AI εκτελείται μία φορά και η ροή προχωρά· η Συνομιλία AI απαντά στο μήνυμα του πελάτη, περιμένει το επόμενο και απαντά ξανά, χωρίς επιπλέον κόμβους ή συνδέσεις προς τα πίσω. Έχει τα ίδια πεδία με τον κόμβο Πράκτορας AI εκτός από την Αποστολή απάντησης: η απάντησή του αποστέλλεται πάντα.

Τοποθετήστε τον μετά από ένα συμβάν έναρξης, όπως Δημιουργήθηκε νέα συνεδρία ή Η συνεδρία άνοιξε ξανά.

  1. Όταν η ροή φτάσει στον κόμβο, ξεκινά μια εκτέλεση για το μήνυμα του πελάτη, όπως κάνει ο κόμβος Πράκτορας AI.
  2. Όταν η εκτέλεση ολοκληρωθεί, η απάντηση αποστέλλεται και ο κόμβος περιμένει το επόμενο μήνυμα του πελάτη στην ίδια συνεδρία. Κάθε μήνυμα ξεκινά νέα εκτέλεση· κάθε εκτέλεση εμφανίζεται στις Εκτελέσεις πρακτόρων AI και χρεώνεται όπως κάθε άλλη.
  3. Τα μηνύματα που φτάνουν ενώ μια εκτέλεση βρίσκεται σε εξέλιξη δεν χάνονται: όταν η εκτέλεση τελειώσει, μια νέα εκτέλεση απαντά στο πιο πρόσφατο, με τα προηγούμενα στο ιστορικό μηνυμάτων της.
  4. Μια εκτέλεση που δεν ολοκληρώνεται βγαίνει από τον βρόχο από τη δική της έξοδο.
  5. Ο βρόχος σταματά όταν η συνομιλία τελειώσει:
    • σε μια ροή bot, όταν η συνεδρία κλείσει, ανατεθεί σε μέλος της ομάδας ή αφαιρεθεί η ανάθεσή της από το bot. Η ροή τελειώνει εκεί, όπως κάθε ροή bot όταν χάνει τη συνεδρία της·
    • σε μια ροή που δεν είναι bot, όταν ένα μέλος της ομάδας έχει τη συνεδρία ή στο επόμενο μήνυμα του πελάτη αφού η συνεδρία έκλεισε. Η ροή συνεχίζει από την έξοδο Η συνομιλία τελείωσε.

Σε μια ροή που δεν είναι bot, μια συνεδρία έχει έναν βρόχο κάθε φορά: αν το συμβάν έναρξης ενεργοποιηθεί ξανά ενώ ο κόμβος ήδη απαντά σε αυτή τη συνεδρία (για παράδειγμα το Ελήφθη νέο μήνυμα στο επόμενο μήνυμα), αυτή η δεύτερη εκτέλεση της ροής σταματά στον κόμβο.

ΈξοδοςΠότε
Η συνομιλία τελείωσεΣε μια ροή που δεν είναι bot: η συνεδρία έκλεισε ή την ανέλαβε ένα μέλος της ομάδας.
Υπέρβαση προϋπολογισμούΜια εκτέλεση εξάντλησε τις Μέγ. κλήσεις μοντέλου, τις Μέγ. κλήσεις εργαλείων ή τα Μέγ. συνολικά tokens.
Έληξε ο χρόνοςΜια εκτέλεση έφτασε τη Μέγ. διάρκεια (δευτερόλεπτα).
Μίσος, Jailbreak, Αυτοτραυματισμός, Σεξουαλικό περιεχόμενο, ΒίαΤο φίλτρο περιεχομένου του παρόχου του μοντέλου σταμάτησε μια εκτέλεση για αυτή την κατηγορία.
Σε αποτυχίαΜια εκτέλεση απέτυχε για οποιονδήποτε άλλο λόγο ή ακυρώθηκε.
συμβουλή

Συνδέστε τις εξόδους Υπέρβαση προϋπολογισμού, Έληξε ο χρόνος και Σε αποτυχία σε έναν κόμβο Ανάθεση συνεδρίας, ώστε να αναλαμβάνει ένα μέλος της ομάδας όταν ο πράκτορας δεν μπορεί να απαντήσει.

Χρέωση​

  • Οι κλήσεις μοντέλου σε μοντέλα AI που παρέχονται από το MonoChat χρεώνονται από το υπόλοιπό σας όπως συνήθως. Οι κλήσεις στα δικά σας μοντέλα χρεώνονται από τον πάροχό σας.
  • Ένα harness που παρέχεται από το MonoChat μπορεί να προσθέσει δικές του χρεώσεις ανά εκτέλεση, ανά λεπτό και ανά κλήση εργαλείου και, για ένα φιλοξενούμενο harness, τα tokens που αναφέρει ο πάροχός του. Εμφανίζονται στις Συναλλαγές ως Εκτέλεση πράκτορα AI, Διάρκεια πράκτορα AI, Κλήση εργαλείου πράκτορα AI και κατηγορίες tokens AI.
  • Ένα harness που προσθέτετε με τα δικά σας διαπιστευτήρια δεν έχει χρέωση MonoChat· σας χρεώνει ο πάροχός του.
  • Μια εκτέλεση δεν ξεκινά όταν το υπόλοιπό σας δεν επαρκεί.

Συμβάν Η εκτέλεση του πράκτορα AI ολοκληρώθηκε​

Το Η εκτέλεση του πράκτορα AI ολοκληρώθηκε είναι ένας κόμβος συμβάντος. Ενεργοποιείται όταν τελειώνει μια εκτέλεση που συνδέεται με πελάτη, είτε ξεκίνησε από ροή είτε μέσω του API με συνεδρία. Όπως και οι άλλοι κόμβοι συμβάντων, έχει προαιρετικές ρυθμίσεις Συνθήκη και Λήξη χρόνου. Χρησιμοποιήστε τον για να ξεκινήσετε μια ξεχωριστή ροή μετά τις εκτελέσεις πρακτόρων, για παράδειγμα για να καταγράψετε αποτελέσματα ή να ειδοποιήσετε μια ομάδα.

Εκκίνηση πράκτορα από κώδικα​

Οι προσαρμοσμένες συναρτήσεις και οι πελάτες API μπορούν να εκτελούν πράκτορες με αυτές τις μεθόδους (δικαίωμα Έναρξη / Ανάγνωση / Ακύρωση εκτελέσεων πρακτόρων AI στην αυτοματοποίηση):

ΜέθοδοςΤι κάνει
business.tenants.automation.ai.aiAgentRuns.createΞεκινά μια εκτέλεση. Επιστρέφει aiAgentRunId και aiAgentSessionId.
business.tenants.automation.ai.aiAgentRuns.showΕπιστρέφει μια εκτέλεση (_id) με την κατάσταση, τη χρήση, τα βήματα και το αποτέλεσμά της.
business.tenants.automation.ai.aiAgentRuns.cancelΑκυρώνει μια εκτέλεση που βρίσκεται στην ουρά ή εκτελείται (_id).

Η create δέχεται aiHarnessClientId, input (η εργασία), προαιρετικά sessionId (για εργασία μέσα σε συνομιλία), aiAgentSessionId, taskKey και isNewSession, και options με τις ίδιες ρυθμίσεις με τον κόμβο: instructions, aiModelClientId, fallbackAiModelClientId, fastAiModelClientId, harnessModel, toolCustomFunctionIds, aiScopeIds, aiMcpClientDatas, messageHistoryLimit, speechToTextAiModelClientId, forwardIntermediateMessages, willSendAnswer και ένα υποχρεωτικό budget. Μέσω του API, τα forwardIntermediateMessages και willSendAnswer έχουν προεπιλογή false.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
payload: {
aiHarnessClientId: 'HARNESS_ID',
input: 'Summarise the open orders of this customer.',
sessionId: 'SESSION_ID',
options: {
instructions: 'You are the order assistant of our store.',
aiModelClientId: 'MODEL_ID',
toolCustomFunctionIds: ['FUNCTION_ID'],
budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
},
},
})

Η εκτέλεση είναι ασύγχρονη: διαβάστε την αργότερα με το show ή αντιδράστε σε αυτήν με το συμβάν Η εκτέλεση του πράκτορα AI ολοκληρώθηκε. Χωρίς sessionId, κάθε κλήση ξεκινά νέα συνεδρία πράκτορα, εκτός αν περάσετε το aiAgentSessionId που επέστρεψε μια προηγούμενη κλήση· τότε ο πράκτορας βλέπει ως ιστορικό του τις προηγούμενες ολοκληρωμένες εκτελέσεις αυτής της συνεδρίας πράκτορα. Δείτε το Method για την κλήση μεθόδων από μια συνάρτηση.

Δικαιώματα​

ΔικαίωμαΕπιτρέπει
Ανάγνωση / Δημιουργία / Ενημέρωση / Διαγραφή harnesses AI στην αυτοματοποίησηΔιαχείριση των Harnesses AI
Ανάγνωση εκτελέσεων πρακτόρων AI στην αυτοματοποίησηΠροβολή των Εκτελέσεων πρακτόρων AI
Έναρξη εκτελέσεων πρακτόρων AI στην αυτοματοποίησηΚλήση του aiAgentRuns.create
Ακύρωση εκτελέσεων πρακτόρων AI στην αυτοματοποίησηΚλήση του aiAgentRuns.cancel

Δείτε τους Ρόλους.