Respan: Span-01
Το Span-01 είναι ο ταξινομητής συμπεριφορών κειμένου της Respan για συνομιλίες και ίχνη πρακτόρων. Ορίστε τις συμπεριφορές σε απλή γλώσσα και επιστρέφει τρεις πιθανότητες για καθεμία: παρουσία, απουσία και μη παρατηρησιμότητα, διατηρώντας την αβεβαιότητα όταν το παρεχόμενο ίχνος δεν μπορεί να επιλύσει το ερώτημα.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Span-01 είναι το μοντέλο βαθμολόγησης συμπεριφορών της Respan για συνομιλίες και ίχνη πρακτόρων. Διαβάζει μια αλληλεπίδραση κειμένου μαζί με ορισμούς συμπεριφορών σε απλή γλώσσα και επιστρέφει πιθανότητες για κάθε ορισμό. Η έξοδος διακρίνει αν μια συμπεριφορά είναι παρούσα, απούσα ή μη παρατηρήσιμη στο παρεχόμενο ίχνος. Αυτό δίνει σε μια ροή αξιολόγησης ένα αριθμητικό σήμα με ρητό τρόπο αναπαράστασης της έλλειψης στοιχείων, αντί για μια παραγόμενη εξήγηση που πρέπει να αναλυθεί.
Ορίστε τη συμπεριφορά που θέλετε να παρατηρήσετε
Τις συμπεριφορές τις παρέχει ο καλών. Η έγχυση prompt, οι ατεκμηρίωτοι ισχυρισμοί, η έκθεση μυστικών, οι επαναλαμβανόμενοι βρόχοι, η κακή χρήση εργαλείων και η απογοήτευση του χρήστη είναι πιθανοί ορισμοί, όχι μια σταθερή ταξινομία ενσωματωμένη στο μοντέλο. Δηλώστε τι μετρά ως συμπεριφορά και τι όχι. Ένας στενός ορισμός μπορεί να διακρίνει έναν χρήστη που ζητά μεταβίβαση σε άνθρωπο από κάποιον που απλώς εκφράζει απογοήτευση. Ένας άλλος μπορεί να διακρίνει έναν βοηθό που αναγνωρίζει ένα πρόβλημα από έναν που υπόσχεται ενέργεια την οποία δεν μπορεί να εκτελέσει.
Χρησιμοποιήστε σταθερά αναγνωριστικά με τους ορισμούς, ώστε τα αποτελέσματα να παραμένουν συνδεδεμένα με τη συμπεριφορά που αξιολογείται. Εστιάστε το κριτήριο σε κάτι που μπορεί να δείξει το ίχνος. Αν η συμπεριφορά απαιτεί έγγραφο προέλευσης, αποτέλεσμα εργαλείου ή μεταγενέστερη απάντηση πελάτη, συμπεριλάβετε αυτά τα στοιχεία στην αλληλεπίδραση κειμένου στο σημείο που ανήκουν. Ένας ορισμός από μόνος του δεν μπορεί να διαπιστώσει ένα γεγονός που απουσιάζει από το ίχνος.
Προετοιμάστε το προηγούμενο πλαίσιο και τον γύρο της συνομιλίας προς αξιολόγηση
Η τεκμηριωμένη είσοδος διαχωρίζει τα προηγούμενα μηνύματα στο span.input από τον γύρο της συνομιλίας προς αξιολόγηση στο span.output. Το περιεχόμενο κάθε μηνύματος είναι συμβολοσειρά. Δώστε το πραγματικό πλαίσιο της συνομιλίας και τον γύρο που θέλετε να βαθμολογηθεί, διατηρώντας τους ρόλους των ομιλητών και τη σειρά των μηνυμάτων που χρειάζεται για την ερμηνεία του. Πρόκειται για προφίλ βαθμολόγησης κειμένου· προετοιμασμένο κείμενο εγγράφου ή μια απομαγνητοφώνηση μπορούν να αποτελούν στοιχεία, ενώ τα μέσα από τα οποία προήλθε αυτό το κείμενο δεν αποτελούν τα ίδια την τεκμηριωμένη είσοδο.
Για μια αλληλεπίδραση υποστήριξης, κρατήστε το αίτημα του πελάτη μαζί με την προτεινόμενη απάντηση του βοηθού. Για έναν πράκτορα που χρησιμοποιεί εργαλεία, διατηρήστε τη σχετική παρατήρηση του εργαλείου και την απάντηση που βασίστηκε σε αυτή. Ένας ενδεικτικός ορισμός τεκμηρίωσης μπορεί να ρωτά αν ο βοηθός διατυπώνει συμπέρασμα που δεν υποστηρίζει η παρεχόμενη παρατήρηση. Το χρήσιμο αποτέλεσμα αφορά την ορισμένη συμπεριφορά σε αυτό το τμήμα, όχι μια πλήρη διάγνωση ολόκληρης της εφαρμογής.
Διαβάστε τρεις πιθανότητες για κάθε ορισμό
Κάθε αποτέλεσμα περιλαμβάνει το αναγνωριστικό της συμπεριφοράς και τα p_present, p_absent και p_not_observable. Οι τρεις πιθανότητες αθροίζονται περίπου σε 1. Η παρουσία εκτιμά ότι η συμπεριφορά συνέβη· η απουσία εκτιμά ότι δεν συνέβη· η μη παρατηρησιμότητα εκτιμά ότι το παρεχόμενο τμήμα στερείται των στοιχείων που απαιτούνται για να ληφθεί απόφαση. Πρόκειται για διαφορετικά νοήματα που πρέπει να παραμένουν χωριστά κατά την ερμηνεία των αποτελεσμάτων.
Για παράδειγμα, ένα τμήμα που τελειώνει με τον βοηθό να λέει ότι θα λύσει ένα πρόβλημα μπορεί να δείχνει μια υπόσχεση. Δεν μπορεί ακόμη να δείχνει ότι ο πελάτης αποδέχθηκε την τελική λύση, αν δεν υπάρχει απάντηση πελάτη. Αντιμετωπίστε αυτό το αποτέλεσμα έλλειψης στοιχείων ως άγνωστο αντί να το μετατρέπετε σε απουσία. Μια χαμηλή πιθανότητα παρουσίας δεν είναι αυτομάτως ισχυρή ένδειξη απουσίας όταν σημαντικό μέρος της κατανομής αντιστοιχεί σε μη παρατηρησιμότητα.
Βαθμολόγηση πολλών ορισμών συμπεριφορών σε ένα πέρασμα
Η Respan περιγράφει το Span-01 ως ταξινομητή με συλλογισμό που εκπαιδεύτηκε πρώτα για γενική ταξινόμηση με RLAIF και στη συνέχεια εξειδικεύτηκε στην ανίχνευση συμπεριφορών. Κάθε ορισμός εκτελείται ως παράλληλος κλάδος πάνω στο ίδιο ίχνος και το μοντέλο επιστρέφει τις πιθανότητες συμπεριφορών σε ένα πέρασμα εμπρόσθιας διάδοσης. Η υβριδική προσοχή υποστηρίζει τον χειρισμό μακρών, σύνθετων ιχνών. Δεν παράγει tokens, δεν γράφει αφηγηματική κρίση ούτε δίνει εξήγηση ελεύθερης μορφής για την ταξινόμησή του.
Ο εννοιολογικός οδηγός και η αναφορά βαθμολόγησης δεν τεκμηριώνουν ανώτατο πλήθος συμπεριφορών ανά αίτημα. Κάθε ορισμός εξακολουθεί να είναι μέρος της παρεχόμενης αξιολόγησης, γι’ αυτό κρατήστε τον σαφή και σχετικό αντί να θεωρείτε την απουσία ορίου πλήθους απόδειξη απεριόριστης χωρητικότητας εισόδου. Το αποτέλεσμα περιέχει μία εγγραφή ανά συμπεριφορά με τη σειρά του αιτήματος, προσδιορισμένη από το id της. Πολλοί ορισμοί περιγράφουν πολλές ανεξάρτητες παρατηρήσεις· δεν είναι αμοιβαία αποκλειόμενες επιλογές κατηγοριών που πρέπει να αθροίζονται σε ένα μεταξύ συμπεριφορών.
Προετοιμασία χρήσιμου παραδοτέου αξιολόγησης
Συνδυάστε τις επιστρεφόμενες πιθανότητες με κατώφλια ειδικά για την εργασία και κανόνες ελέγχου εκτός του μοντέλου. Ο παραγωγός συνιστά τη χρήση συνομιλιών με ετικέτες για την επιλογή αυτών των κατωφλίων και την εξέταση οριακών αποτελεσμάτων παρουσίας ή αποτελεσμάτων με υψηλή μη παρατηρησιμότητα. Μια ροή υποστήριξης μπορεί να καταγράφει χωριστά απογοήτευση, προτεινόμενη κλιμάκωση και ατεκμηρίωτη υπόσχεση. Μια ροή ποιότητας πρακτόρων μπορεί να παρακολουθεί επαναλαμβανόμενες ενέργειες ή αν μια απάντηση χρησιμοποίησε τα στοιχεία που της διατέθηκαν.
Διατηρήστε μαζί το τμήμα κειμένου, τον ορισμό συμπεριφοράς, το αναγνωριστικό αποτελέσματος και την πλήρη κατανομή τριών ενδεχομένων. Όταν αλλάζει ο ορισμός, αναγνωρίστε ότι αλλάζει και αυτό που μετρά η πιθανότητα. Ελέγξτε τα φαινομενικά σφάλματα ως προς την πραγματική συνομιλία αντί να θεωρείτε ένα αριθμητικό αποτέλεσμα απόδειξη μη παρατηρημένου συμβάντος. Ένα χρήσιμο παραδοτέο είναι μια εγγραφή συμπεριφοράς συνδεδεμένη με το ίχνος και το κριτήριο, με διατήρηση της αβεβαιότητας για μεταγενέστερη εξέταση ή για την επόμενη απόφαση της εφαρμογής.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Εισαγωγή
Το Span-01 είναι ο ταξινομητής συμπεριφορών κειμένου της Respan για συνομιλίες και ίχνη πρακτόρων. Ορίστε τις συμπεριφορές σε απλή γλώσσα και επιστρέφει τρεις πιθανότητες για καθεμία: παρουσία, απουσία και μη παρατηρησιμότητα, διατηρώντας την αβεβαιότητα όταν το παρεχόμενο ίχνος δεν μπορεί να επιλύσει το ερώτημα.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- decisions
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · System One POST /v1/systemone
- Είσοδος
text- Έξοδος
decisions- Μορφή εξόδου
- json
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια respan/span-01 | Προεπιλογή— |
Πεδίο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.00004 / 1K token Έξοδος · Token εξόδου $0 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηΕπίπεδο 1 βάσει μήκους αιτήματος | Πίνακας χρεώσεων— | Token συμφραζομένων, πάνω από0 | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.00004 / 1K token Έξοδος · Token εξόδου $0 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · System One
{
"model": "respan/span-01",
"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']='respan/span-01'
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 respan/span-01
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Respan: Span-01
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/systemone·respan/span-01:text→decisions- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user