Συνδέσεις API

Οι συνδέσεις API είναι προσαρμοσμένες συναρτήσεις HTTP που μπορούν να καλούν οι πράκτορές σας κατά τη διάρκεια μιας συνομιλίας — για να αναζητούν μια παραγγελία, να δημιουργούν ένα αίτημα υποστήριξης ή να ανακτούν την κατάσταση λογαριασμού από το δικό σας backend. Ορίζετε το τελικό σημείο μία φορά στην ενότητα Συνδέσεις → API (/dashboard/api-connections)· οι πράκτορες που έχουν συνδεδεμένη τη σύνδεση μπορούν στη συνέχεια να την καλούν όποτε το απαιτεί η συνομιλία.

Υπάρχουν δύο τρόποι να δημιουργήσετε μία: επικολλήστε κάτι που μπορεί να αναλύσει ο οδηγός ή ρυθμίστε τη σύνδεση μη αυτόματα.

Η γρήγορη διαδρομή: επικόλληση και ανάλυση

1. Κάντε κλικ στην επιλογή Νέα σύνδεση API

   Ανοίγει το παράθυρο διαλόγου στον οδηγό. Επικολλήστε στο πλαίσιο ένα δείγμα εντολής cURL, προδιαγραφής OpenAPI/Swagger, εξαγωγής Postman, διεπαφής TypeScript ή σχήματος Zod.

2. Κάντε κλικ στην επιλογή Ανάλυση

   Το ThunderPhone συμπεραίνει ολόκληρη τη σύνδεση από όσα επικολλήσατε — URL, μέθοδο, κεφαλίδες και ένα σχήμα παραμέτρων που προκύπτει από τις παραμέτρους ερωτήματος και το σώμα αιτήματος που εντόπισε. Οι κεφαλίδες που επικολλήσατε (συμπεριλαμβανομένων των κεφαλίδων ελέγχου ταυτότητας) μεταφέρονται στη διαμόρφωση του τελικού σημείου.

3. Επιβεβαιώστε τα επισημασμένα πεδία

   Η συμπερασμένη διαμόρφωση ανοίγει με τα εκτιμώμενα πεδία επισημασμένα για έλεγχο. Προσαρμόστε ονόματα, περιγραφές και τύπους παραμέτρων, ώστε ο πράκτορας να κατανοεί πότε και πώς να καλεί τη συνάρτηση — η περιγραφή είναι αυτό που διαβάζει το μοντέλο.

4. Επικύρωση και αποθήκευση

   Η αποθήκευση εκτελεί πρώτα ένα ενεργό δοκιμαστικό αίτημα στο τελικό σας σημείο. Αν το αίτημα αποτύχει, η σύνδεση δεν αποθηκεύεται — διορθώστε το URL, τις κεφαλίδες ελέγχου ταυτότητας ή το σώμα και δοκιμάστε ξανά. Σε περίπτωση επιτυχίας, η σύνδεση αποθηκεύεται με σήμανση Επικυρώθηκε.

Αν ο οδηγός δεν μπορεί να εντοπίσει URL αιτήματος σε όσα επικολλήσατε, θα σας ενημερώσει — συμπεριλάβετε ένα πλήρες τελικό σημείο http(s) και δοκιμάστε ξανά.

Μη αυτόματη ρύθμιση

Κάντε κλικ στην επιλογή Μη αυτόματη ρύθμιση → στον οδηγό (ή στην επιλογή Θέλετε το AI να το συμπεράνει; Δοκιμάστε τον Οδηγό → για να επιστρέψετε). Το πρόγραμμα μη αυτόματης δημιουργίας διαθέτει δύο προγράμματα επεξεργασίας:

• Οπτικό — πεδία φόρμας για το εμφανιζόμενο όνομα, το όνομα συνάρτησης, το αίτημα URL, τη μέθοδο (POST, GET, PUT, PATCH, DELETE), προσαρμοσμένες κεφαλίδες και το σχήμα παραμέτρων (Προσθήκη ιδιότητας για κάθε όρισμα που μπορεί να παρέχει ο πράκτορας).
• JSON — ο ίδιος ορισμός ως ακατέργαστο JSON, για επικόλληση ή λεπτομερή προσαρμογή μιας προδιαγραφής εργαλείου απευθείας.

Ένας πίνακας Δοκιμαστικό αίτημα (προαιρετικός) σάς επιτρέπει να εκτελείτε το διαμορφωμένο αίτημα πριν από την αποθήκευση και εμφανίζει την κατάσταση, την καθυστέρηση και μια προεπισκόπηση απόκρισης. Η επιλογή Επικύρωση και αποθήκευση εκτελεί πάντα αυτή τη δοκιμή και αποθηκεύει μόνο σε περίπτωση επιτυχίας.

Διαχειριστείτε τις συνδέσεις σας

Κάθε γραμμή σύνδεσης εμφανίζει την κατάσταση επικύρωσής της — Επικυρώθηκε, Δεν δοκιμάστηκε ή Σφάλμα — το όνομα συνάρτησής της και τους πράκτορες που τη χρησιμοποιούν. Από το μενού ενεργειών της γραμμής μπορείτε να:

• Επεξεργαστείτε — να ανοίξετε ξανά τη διαμόρφωση.
• Κλωνοποιήσετε — να τη δημιουργήσετε ως αντίγραφο για αφετηρία (το αντίγραφο αρχικά δεν έχει δοκιμαστεί).
• Ιστορικό αναθεωρήσεων — να δείτε προηγούμενες εκδόσεις και να επαναφέρετε μία στο πρόγραμμα επεξεργασίας.
• Μεταφέρετε — να αντιγράψετε ή να μετακινήσετε τη σύνδεση σε άλλον οργανισμό στον οποίο ανήκετε. Η μετακίνηση την αφαιρεί από εδώ· οι πράκτορες που τη χρησιμοποιούσαν ενδέχεται να χρειάζονται επαναδιαμόρφωση.
• Διαγράψετε — οριστικά· οι πράκτορες που χρησιμοποιούν τη σύνδεση θα χρειαστούν επαναδιαμόρφωση.

Συνδέστε τη με έναν πράκτορα

Προσθέστε τη σύνδεση σε έναν πράκτορα στην ενότητα συνδέσεων API του προγράμματος δημιουργίας (Δημιουργία πράκτορα). Η λίστα εμφανίζει ποιοι πράκτορες χρησιμοποιούν κάθε σύνδεση, ώστε να μπορείτε να βλέπετε με μια ματιά τι επηρεάζει μια αλλαγή.

Επόμενα βήματα