Inception: Mercury Decide
Το Mercury Decide αξιολογεί κοινά στοιχεία κειμένου ή JSON ως προς ερωτήματα με ονόματα και επιστρέφει επιλογές συγκεκριμένου τύπου, πιθανότητες ναι/όχι ή κλασματικές βαθμολογίες ρουμπρίκας. Η Inception τεκμηριώνει ειδική ροή αποφάσεων με έως 255 επιλογές Choice και δέκα επίπεδα Score.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Mercury Decide είναι το μοντέλο της Inception για δομημένες αποφάσεις πάνω σε παρεχόμενα στοιχεία. Συνδυάζει μια κοινή κατάσταση με ερωτήματα που έχουν ονόματα και επιστρέφει απαντήσεις συγκεκριμένου τύπου με πιθανότητες. Το αποτέλεσμα μπορεί να είναι μια επιλεγμένη κατηγορία, μια εκτιμώμενη πιθανότητα ναι/όχι ή μια θέση σε καθορισμένη κλίμακα. Αυτό το προφίλ εξυπηρετεί μια απόφαση εντός καθορισμένων ορίων που μπορεί να ερμηνεύσει το λογισμικό· η τεκμηριωμένη διεπαφή του δεν παράγει απάντηση συνομιλίας ελεύθερης μορφής.
Κοινή κατάσταση και ουσιαστικά ονόματα ερωτημάτων
Το αίτημα του παραγωγού περιέχει ένα μοντέλο, μια κατάσταση και μια μη κενή αντιστοίχιση ερωτημάτων. Τα ονόματα των ερωτημάτων διατηρούνται στην αντιστοίχιση απαντήσεων. Δώστε την πληροφορία που χρειάζεται για να κριθεί κάθε ερώτημα και ονομάστε τα ερωτήματα βάσει των αποτελεσμάτων που χρησιμοποιεί η ροή εργασίας, όπως category, priority ή needs_follow_up. Πολλά ερωτήματα αξιολογούν ανεξάρτητα τα ίδια στοιχεία. Η τοποθέτησή τους σε ένα αίτημα δεν κάνει ένα μεταγενέστερο ερώτημα να εξαρτάται από προηγούμενη απάντηση.
Το παράδειγμα της Inception χρησιμοποιεί ένα αντικείμενο JSON για την κατάσταση. Ο οδηγός επιτρέπει επίσης συμβολοσειρές, αντικείμενα ή πίνακες στην κατάσταση, στις οδηγίες και στις περιγραφές κριτηρίων, με τις οδηγίες προαιρετικές ή null. Διατηρήστε χρήσιμη δομή όταν τα στοιχεία αποτελούνται ήδη από πεδία και κρατήστε αναγνωρίσιμο ένα έγγραφο ή μήνυμα όταν δίνετε κείμενο. Για μια περίπτωση υποστήριξης, συμπεριλάβετε το πραγματικό αίτημα και τα σχετικά γεγονότα αντί για αίτημα συναγωγής πλαισίου που λείπει.
Noul: μια εκτιμώμενη θετική απάντηση
Ένα ερώτημα noul αναπαριστά μια συνθήκη ναι/όχι. Η έξοδός του είναι πιθανότητα από 0 έως 1 ότι ισχύει η θετική απάντηση. Προαιρετικές περιγραφές true και false μπορούν να προσδιορίζουν τι μετρά σε κάθε πλευρά του ερωτήματος. Για παράδειγμα, ρωτήστε αν ένα μήνυμα ζητά ρητά αντικατάσταση και διακρίνετέ το από ένα γενικό παράπονο για το αντικείμενο. Η πιθανότητα παρέχει αριθμητική κρίση· η εφαρμογή επιλέγει το κατώφλι και την ενέργεια της ροής εργασίας που προκύπτει.
Κρατήστε τη συνθήκη αρκετά συγκεκριμένη ώστε τα στοιχεία να μπορούν να την επιλύσουν. Αν ένα ερώτημα αναμειγνύει το αν ο χρήστης θέλει βοήθεια, το αν ένα αντικείμενο είναι ελαττωματικό και το αν η περίπτωση είναι επείγουσα, διαχωρίστε αυτές τις συνθήκες. Διατηρήστε την επιστρεφόμενη πιθανότητα μαζί με τον ορισμό ερωτήματος, ώστε ένας μεταγενέστερος ελεγκτής να μπορεί να καταλάβει τι μετρά πραγματικά ο αριθμός.
Choice: επιλογή μίας επιλογής με όνομα
Ένα ερώτημα Choice χρησιμοποιεί μια αντιστοίχιση από ένα έως 255 ονόματα επιλογών και περιγραφές· οι περιγραφές μπορούν να είναι null. Η επιστρεφόμενη επιλογή είναι η παρεχόμενη επιλογή με την υψηλότερη πιθανότητα. Το αποτέλεσμα περιέχει επίσης πιθανότητα για κάθε επιλογή και βεβαιότητα. Ορίστε διακριτά νοήματα για τις κατηγορίες και συμπεριλάβετε εφεδρική κατηγορία όταν κάποιες είσοδοι θα βρίσκονται εκτός των συγκεκριμένων επιλογών. Σύντομα κλειδιά εξόδου μπορούν να προσδιορίζουν κατηγορίες, ενώ πληρέστερες περιγραφές ορίζουν τα μεταξύ τους όρια.
Μια περιγραφή δρομολόγησης μπορεί να διακρίνει ζήτημα πρόσβασης, ερώτηση προϊόντος και αναφερόμενο ελάττωμα. Δηλώστε το νόημα κάθε επιλογής και δώστε το μήνυμα που χρειάζεται δρομολόγηση. Η έξοδος είναι επιλεγμένη κατηγορία με κατανομή, όχι οδηγία που έχει ήδη αλλάξει μια ουρά ή επικοινωνήσει με άλλο σύστημα. Εξετάστε τις ανταγωνιστικές πιθανότητες όταν μια περίπτωση είναι αμφίσημη αντί να ερμηνεύετε τη νικήτρια ετικέτα ως απόδειξη βεβαιότητας.
Score: μια αναμενόμενη θέση σε ρουμπρίκα
Ένα ερώτημα Score χρησιμοποιεί διατεταγμένο πίνακα από μία έως δέκα περιγραφές επιπέδων, ξεκινώντας από το επίπεδο 0. Η βαθμολογία του είναι ο μέσος όρος των δεικτών επιπέδων σταθμισμένος βάσει πιθανοτήτων και μπορεί να βρίσκεται μεταξύ επιπέδων. Η απάντηση περιέχει το υπόμνημα, πιθανότητες ανά επίπεδο και βεβαιότητα. Ορίστε τη σειρά και τα κριτήρια κάθε επιπέδου, όπως κανένας άμεσος αντίκτυπος, πρόβλημα με λειτουργική εναλλακτική λύση και εργασία που έχει μπλοκαριστεί πλήρως.
Μια κλασματική αναμενόμενη βαθμολογία είναι χρήσιμη για προτεραιοποίηση ή συγκέντρωση. Διαφέρει από την επιλογή του μοναδικού πιθανότερου επιπέδου. Κρατήστε το υπόμνημα μαζί με τον αριθμό, ώστε μια βαθμολογία να μην ερμηνεύεται σε άσχετη κλίμακα. Η βεβαιότητα για Choice και Score αναφέρεται χωριστά μεταξύ 0 και 1· ο σχετικός οδηγός δεν την ορίζει ως ταυτόσημη με τη μεγαλύτερη πιθανότητα επιλογής ούτε παρέχει καθολικό τύπο για την ανακατασκευή της.
Προετοιμασία χρήσιμου αποτελέσματος απόφασης
Ένα σύνολο στοιχείων μπορεί να υποστηρίζει ανεξάρτητα ερωτήματα κατηγορίας, επείγοντος και συνθήκης. Μια εργασία ελέγχου εγγράφου μπορεί να ρωτά αν υπάρχει απαιτούμενο θέμα, να επιλέγει την κατηγορία του και να βαθμολογεί τη συνάφειά του σε περιγραφόμενα επίπεδα. Χρησιμοποιήστε μόνο υλικό προέλευσης διαθέσιμο στην κατάσταση, με κριτήρια συνδεδεμένα με την απόφαση που χρειάζεται στη συνέχεια η ροή εργασίας. Αν μια ενέργεια απαιτεί προηγούμενο αποτέλεσμα, κάντε αυτό το αποτέλεσμα ρητό στα στοιχεία για το επόμενο βήμα αντί να υποθέτετε ότι τα ερωτήματα σχηματίζουν κρυφή ακολουθία.
Η απόκριση επιστρέφει το όνομα του μοντέλου και μια αντιστοίχιση answers με κλειδιά τα παρεχόμενα ονόματα ερωτημάτων. Οι πιθανότητες Choice χρησιμοποιούν τα ονόματα επιλογών· οι πιθανότητες Score χρησιμοποιούν δείκτες σε μορφή συμβολοσειράς, με το υπόμνημα να εξηγεί αυτούς τους δείκτες. Κρατήστε συνδεδεμένα το αναγνωριστικό κατάστασης, τους ορισμούς ερωτημάτων και τις απαντήσεις συγκεκριμένου τύπου. Αυτό παράγει ένα ερμηνεύσιμο παραδοτέο ταξινόμησης ή αξιολόγησης αντί για έναν αριθμό αποκομμένο από τα γεγονότα που τον παρήγαγαν.
Εύρος διεπαφής και όρια
Η Inception τεκμηριώνει το Mercury Decide μέσω της ειδικής διεπαφής αποφάσεών του. Δεν υποστηρίζει τις διεπαφές chat-completion, streaming ή κλήσεων εργαλείων του κατασκευαστή, επομένως δυνατότητες από τα προφίλ συλλογισμού, φωνής και παραγωγής κώδικα του Mercury δεν πρέπει να μεταφέρονται σε αυτό το μοντέλο. Ο οδηγός αποφάσεων προσδιορίζει το πλήθος επιλογών και επιπέδων αλλά δεν δίνει αριθμητικό όριο tokens κατάστασης ή ανώτατο πλήθος ερωτημάτων· κρατήστε τα κοινά στοιχεία εστιασμένα στα ερωτήματα που αξιολογούνται.
Αξιολογήστε τις πιθανότητες και τα όρια κατηγοριών σε αντιπροσωπευτικό υλικό με ετικέτες από την προβλεπόμενη εργασία. Ελέγξτε οριακές απαντήσεις ως προς την κατάσταση και διατηρήστε την πληροφορία που λείπει ως ελλείπουσα αντί να την αντικαθιστάτε με επινοημένα γεγονότα. Ένα χρήσιμο αποτέλεσμα Mercury Decide δίνει μια κλειστή απόφαση, τις πιθανότητές της και τους ορισμούς που χρειάζονται για την κατανόησή της· η εφαρμογή που το περιβάλλει καθορίζει πώς αυτό το αποτέλεσμα γίνεται δρομολόγηση, προτεραιοποίηση ή αποτέλεσμα ελέγχου.
Ailoot Ultra · System One POST /v1/systemone inception/mercury-decide
inception/mercury-decideΕισαγωγή
Το Mercury Decide αξιολογεί κοινά στοιχεία κειμένου ή JSON ως προς ερωτήματα με ονόματα και επιστρέφει επιλογές συγκεκριμένου τύπου, πιθανότητες ναι/όχι ή κλασματικές βαθμολογίες ρουμπρίκας. Η Inception τεκμηριώνει ειδική ροή αποφάσεων με έως 255 επιλογές Choice και δέκα επίπεδα Score.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- decisions
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · System One POST /v1/systemone
- Είσοδος
text- Έξοδος
decisions- Μορφή εξόδου
- json
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια inception/mercury-decide | Προεπιλογή— |
Πεδίοprovider | Τύποςschema | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοquestions | Τύποςobject | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοsession_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοstate | Τύποςschema | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtrace | Τύποςschema | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοuser | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοquestions.<id>.type | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια noul, choice, score | Προεπιλογή— |
Πεδίοquestions.<id>.instructions | Τύποςstring|object|array | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοquestions.<id>.criteria | Τύποςobject|array | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: choice/score: απαιτείται· noul: προαιρετικό. Τα κριτήρια choice είναι αντικείμενο· το score είναι πίνακας με minItems1. | Προεπιλογή— |
Πεδίοquestions.<id>.criteria.true | Τύποςstring|object|array | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Εφαρμόζεται όταν: Παρέχεται αντικείμενο κριτηρίων noul | Προεπιλογή— |
Πεδίοquestions.<id>.criteria.false | Τύποςstring|object|array | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Εφαρμόζεται όταν: Παρέχεται αντικείμενο κριτηρίων noul | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
noul · Υποχρεωτικό: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Υποχρεωτικό: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Υποχρεωτικό: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, state, questions |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςoptional_controls | Σύμβασηprovider, session_id, trace, user |
Παράμετροςmultimodal_input_binding | Σύμβασηnull |
Κύκλος ζωής: synchronous
Στείλτε το ακριβές ID μοντέλου και διατηρήστε ολόκληρη την εγγενή απόκριση.
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Token συμφραζομένων, πάνω από | Token συμφραζομένων, έως και | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις ανά token | Πίνακας χρεώσεωνΒασική χρέωση | Token συμφραζομένων, πάνω από— | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.00008 / 1K token Έξοδος · Token εξόδου $0 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηΕπίπεδο 1 βάσει μήκους αιτήματος | Πίνακας χρεώσεων— | Token συμφραζομένων, πάνω από0 | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.00008 / 1K token Έξοδος · Token εξόδου $0 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · System One
{
"model": "inception/mercury-decide",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='inception/mercury-decide'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · System One
json
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρείται κάθε απάντηση με το παρεχόμενο ID ερώτησης, τον ακριβή τύπο της, την τιμή noul/choice/score, τη βεβαιότητα, τις πιθανότητες και το υπόμνημα. Ολόκληρο το αρχικό JSON αποθηκεύεται και επιστρέφεται μόνο μετά την εκκαθάριση.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε την αρχική λειτουργία και την πλήρη ή μερική απάντηση· μην επαναλάβετε το POST.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοmodel | Τύποςstring |
Πεδίοid | Τύποςstring |
Πεδίοprovider | Τύποςstring |
Πεδίοanswers.<id>.type | Τύποςstring |
Πεδίοanswers.<id>.noul | Τύποςnumber |
Πεδίοanswers.<id>.choice | Τύποςstring |
Πεδίοanswers.<id>.score | Τύποςnumber |
Πεδίοanswers.<id>.confidence | Τύποςnumber |
Πεδίοanswers.<id>.probabilities | Τύποςobject |
Πεδίοanswers.<id>.legend | Τύποςobject |
Πεδίοusage.input_tokens | Τύποςinteger |
Πεδίοusage.output_tokens | Τύποςinteger |
Πεδίοusage.cost | Τύποςnumber |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρο απαιτούμενο πεδίο, αναπαράσταση ή τιμή | Επόμενο βήμαΔιορθώστε το υποδεικνυόμενο πεδίο του αιτήματος. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra inception/mercury-decide
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Inception: Mercury Decide
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/systemone·inception/mercury-decide:text→decisions- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/systemone·inception/mercury-decide:model,provider,questions,session_id,state,trace,user