Συνδέσεις API

Μετατρέψτε οποιοδήποτε HTTP API σε συνάρτηση που μπορεί να καλεί ο πράκτοράς σας κατά τη διάρκεια μιας συνομιλίας: επικολλήστε μια εντολή cURL και ο οδηγός δημιουργεί τον ορισμό του εργαλείου, τις παραμέτρους και τον έλεγχο ταυτότητας.

Οι συνδέσεις API είναι προσαρμοσμένες συναρτήσεις HTTP που μπορούν να καλέσουν οι πράκτορές σας κατά τη διάρκεια μιας συνομιλίας — να αναζητήσουν μια παραγγελία, να δημιουργήσουν ένα αίτημα υποστήριξης, να ανακτήσουν την κατάσταση λογαριασμού από το δικό σας σύστημα υποστήριξης. Ορίζετε το τελικό σημείο μία φορά στις Συνδέσεις → 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 του δημιουργού (Δημιουργία πράκτορα). Η λίστα εμφανίζει ποιοι πράκτορες χρησιμοποιούν κάθε σύνδεση, ώστε να βλέπετε με μια ματιά τι επηρεάζει μια αλλαγή.

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