Το API του Ultineo Reasoning
Εκτελέστε τις εφαρμογές του καταλόγου από το δικό σας λογισμικό. Το API χρησιμοποιεί JSON μέσω HTTPS, αυθεντικοποιεί κάθε κλήση με ένα κλειδί έργου και απαντά σε κάθε κλήση με την ίδια μορφή.
Δομημένο γύρω από εφαρμογές, εκτελέσεις και κλειδιά
- Εφαρμογές
Δημιουργήστε μια εφαρμογή από ένα μοντέλο, τα πεδία εισόδου και τις οδηγίες της και, στη συνέχεια, προβάλετε, διαβάστε και επεξεργαστείτε τις εφαρμογές σας.
- Εκτελέσεις και όριο χρήσης
Μία κλήση εκκινεί μια εφαρμογή με τα δεδομένα εισόδου της· μια άλλη διαβάζει την εκτέλεση μαζί με την απάντηση. Μια σύνοψη δείχνει τα tokens που απομένουν στον κύκλο χρέωσής σας.
- Κλειδιά
Κλειδιά έργου με δικαιώματα, προαιρετική λήξη και κατάσταση που μπορείτε να απενεργοποιήσετε.
Integrate it anywhere
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- In your automations
A script or an automation tool launches a run at each event: a form received, a file dropped.
- From one answer to the next
The answer of one run can become a field of the next: your code chains the steps as it sees fit.
The same run, through the API
Your software sends the application’s identifier and its fields, then reads the run back until it is finished.
What you send
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
}What you read back
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
}Αυθεντικοποίηση και δικαιώματα
- Κλειδί τύπου bearer
Στέλνετε το κλειδί του έργου σας στην κεφαλίδα Authorization κάθε κλήσης, μόνο μέσω HTTPS.
- Περιορισμένο σε ένα έργο
Ένα κλειδί συνδέεται με ένα έργο και δεν μπορεί ποτέ να διαβάσει ή να γράψει δεδομένα άλλου έργου, όποιο κι αν είναι το αίτημα.
- Αποθηκεύεται ως hash
Διατηρείται μόνο ένα hash του κλειδιού, επομένως το κλειδί εμφανίζεται ολόκληρο μία φορά. Ένα χαμένο κλειδί αντικαθίσταται, δεν ανακτάται ποτέ.
Ξεκινήστε μια εκτέλεση και διαβάστε την απάντησή της
- Δημιουργία
Ορίστε την εφαρμογή και δώστε μία τιμή για κάθε πεδίο εισόδου, με κλειδί το όνομα του πεδίου που επιστρέφει η εφαρμογή.
- Παρακολούθηση
Οι εκτελέσεις είναι ασύγχρονες: διαβάζετε ξανά την εκτέλεση μέχρι η κατάστασή της να γίνει ολοκληρώθηκε ή απέτυχε. Και οι δύο είναι τελικές.
- Ανάγνωση
Μια ολοκληρωμένη εκτέλεση περιέχει την απάντησή της, τη διάρκεια και τον αριθμό tokens εισόδου και εξόδου.
Ενιαία μορφή για κάθε απάντηση
- Τα ίδια τρία κλειδιά
Κάθε απάντηση περιέχει τον κωδικό κατάστασης, έναν σύντομο τίτλο και το περιεχόμενο της απάντησης, τόσο σε επιτυχία όσο και σε αποτυχία.
- Σταθερά μηνύματα
Τα μηνύματα σφάλματος είναι σταθερές συμβολοσειρές στα αγγλικά που κατονομάζουν το δικαίωμα που λείπει ή την τιμή που απορρίφθηκε.
- Τα όρια του προγράμματος είναι σαφή
Μια κλήση που δεν καλύπτει το πρόγραμμα ή που θα υπερέβαινε το όριο χρήσης του απορρίπτεται με δικό της κωδικό κατάστασης.
Απόκτηση κλειδιού
Η πρόσβαση στο API περιλαμβάνεται στα επί πληρωμή προγράμματα του Ultineo Reasoning. Δεν υπάρχει ακόμη αυτόνομη εγγραφή: η ομάδα μας ανοίγει το έργο σας και σας παραδίδει το πρώτο του κλειδί.
Συνδέστε το λογισμικό σας με το Ultineo Reasoning
Πείτε μας τι θέλετε να αυτοματοποιήσετε και θα ανοίξουμε το έργο σας και το κλειδί API του.
Ερωτήσεις για το API
Τα επί πληρωμή προγράμματα. Το δωρεάν πρόγραμμα δίνει πρόσβαση στις εφαρμογές χωρίς το API.
Όχι. Οι οδηγίες ανήκουν στον κάτοχο της εφαρμογής. Το API επιστρέφει τα πεδία εισόδου, γιατί αυτά συμπληρώνει όποιος κάνει την κλήση.
Η δημιουργία μιας εκτέλεσης επιστρέφει αμέσως με την κατάσταση νέα. Διαβάζετε ξανά την εκτέλεση μέχρι να ολοκληρωθεί, για να λάβετε την απάντηση.
Ναι. Κάθε κλειδί έχει δικαιώματα και προαιρετική λήξη, και ένα κλειδί δεν μπορεί ποτέ να δημιουργήσει άλλο κλειδί με ευρύτερα δικαιώματα από τα δικά του.