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