Το Codestral 2508 είναι το μοντέλο προγραμματισμού της Mistral AI για συχνές εργασίες συμπλήρωσης και παραγωγής που είναι ευαίσθητες στην καθυστέρηση. Λαμβάνει πηγαίο κώδικα και απαιτήσεις σε κείμενο και επιστρέφει κείμενο που μπορεί να περιέχει μια υλοποίηση, συμπλήρωση, διόρθωση ή εξήγηση. Η συγκεκριμένη έκδοση 2508 εστιάζει στο τρέχον πλαίσιο επεξεργασίας του προγραμματιστή και δεν είναι μοντέλο embeddings ούτε, από μόνη της, ολοκληρωμένος πράκτορας αποθετηρίου.
Συμπλήρωση κώδικα και ενημέρωση 2508
Ο κατασκευαστής προορίζει το Codestral για συμπλήρωση στο μέσο και επεξεργασία πολλών γραμμών. Η έκδοση περιγράφει βελτιώσεις στη συμπεριφορά συμπλήρωσης, μεταξύ των οποίων ο περιορισμός της ανεξέλεγκτης παραγωγής, καθώς και βελτιώσεις στην τήρηση οδηγιών και στις εργασίες κώδικα σε λειτουργία συνομιλίας. Πρόκειται για αλλαγές στη συγκεκριμένη έκδοση του Codestral· οι λειτουργίες ανάκτησης πληροφοριών και αυτόνομων πρακτόρων της περιβάλλουσας στοίβας προγραμματισμού ανήκουν σε ξεχωριστά κατονομαζόμενα συστατικά.
Για μια εργασία συμπλήρωσης, κρατήστε τη σχετική υπογραφή συνάρτησης, τις δηλώσεις και τα συμφραζόμενα κλήσης μαζί με τη θέση του δρομέα. Προσδιορίστε αν το επιθυμητό αποτέλεσμα είναι μόνο ο κώδικας που λείπει ή μια ολόκληρη αναθεωρημένη συνάρτηση. Ένα αίτημα για επεξεργαστή κώδικα μπορεί να ζητά σώμα βρόχου που διατηρεί τον υπάρχοντα τύπο επιστροφής, κρατά τις διπλότυπες τιμές και δεν μεταβάλλει την είσοδο του καλούντος. Το αποτέλεσμα αποκτά έτσι συγκεκριμένο σημείο εισαγωγής και καθορισμένη συμπεριφορά.
Προετοιμασία συμπλήρωσης στο μέσο
Στη διεπαφή FIM του κατασκευαστή, το prompt παρέχει κείμενο ή κώδικα προς συμπλήρωση και ένα προαιρετικό επίθημα παρέχει το υλικό μετά το κενό. Όταν παρέχονται και τα δύο, το μοντέλο συμπληρώνει τον χώρο ανάμεσά τους. Χωρίς επίθημα, συνεχίζει από το prompt. Αυτό διαφέρει από ένα συνηθισμένο αίτημα συνομιλίας που ζητά μια αλλαγή κώδικα και μια εξήγηση· κάθε τρόπος προετοιμασίας καθορίζει διαφορετικό συμβόλαιο εξόδου.
Μια χρήσιμη είσοδος για συμπλήρωση κενού περιλαμβάνει την αρχή της συνάρτησης, τον κώδικα που πρέπει να ακολουθήσει την εισαγωγή και τυχόν σχετικούς ορισμούς τύπων ή βοηθητικών συναρτήσεων. Διατηρήστε τις εσοχές και τους οριοθέτες, ώστε το επιστρεφόμενο κείμενο να μπορεί να ενσωματωθεί στο υπάρχον απόσπασμα. Αν χρειάζεται μόνο το σώμα που λείπει, ζητήστε αυτό και όχι επανεγγραφή ολόκληρου του αρχείου. Μια ξεχωριστή ερώτηση συνομιλίας μπορεί να εξηγεί γιατί το συμπληρωμένο απόσπασμα ικανοποιεί την απαίτηση.
Η επίσημη τεκμηρίωση FIM επιτρέπει προϋπολογισμό token εξόδου και απαιτεί το prompt μαζί με αυτόν τον προϋπολογισμό να παραμένουν μέσα στο πλαίσιο συμφραζομένων του μοντέλου. Τεκμηριώνει επίσης ακολουθίες τερματισμού και συνεχή ροή του παραγόμενου περιεχομένου. Επιλέξτε ροή συμπλήρωσης όταν το αποτέλεσμα πρέπει να ταιριάζει στο κενό του κώδικα και ροή συνομιλίας όταν η εργασία ζητά κώδικα μαζί με εξήγηση.
Συμφραζόμενα και υποστηρικτικές δυνατότητες
Η σελίδα του μοντέλου αναφέρει παράθυρο συμφραζομένων 128 χιλ. token. Χρησιμοποιήστε το για να διατηρείτε τον πηγαίο κώδικα και τις δηλώσεις που καθορίζουν την επιδιωκόμενη αλλαγή, κρατώντας παράλληλα ρητή την πραγματική εργασία επεξεργασίας. Για αίτημα διόρθωσης σφάλματος, δώστε την επηρεαζόμενη συνάρτηση, μια συγκεκριμένη είσοδο που αποτυγχάνει, το αναμενόμενο αποτέλεσμα και το σφάλμα ή την παρατηρούμενη συμπεριφορά. Ζητήστε την προτεινόμενη διόρθωση χωριστά από την εξήγηση και τα παραδείγματά της.
Η σελίδα αναφέρει επίσης δομημένες εξόδους, κλήση συναρτήσεων, προβλεπόμενες εξόδους, απαντήσεις σε ερωτήσεις εγγράφων, προθέματα απάντησης και ομαδική επεξεργασία, μαζί με τις δυνατότητες συνομιλίας και FIM. Για ένα δομημένο αποτέλεσμα ελέγχου κώδικα, ορίστε πεδία όπως το επηρεαζόμενο σύμβολο, η παρατηρούμενη ασυμφωνία, η προτεινόμενη αλλαγή και η παραδοχή που χρειάζεται ακόμη διευκρίνιση. Οι οδηγίες της Mistral για δομημένη έξοδο διακρίνουν τη λειτουργία JSON από ένα προσαρμοσμένο σχήμα, με την επιθυμητή μορφή JSON να δηλώνεται στο prompt.
Οι προβλεπόμενες έξοδοι προορίζονται για περιεχόμενο όπου σημαντικά μέρη της απάντησης είναι ήδη γνωστά. Μπορούν να χρησιμοποιηθούν κατά την αναδημιουργία εγγράφου ή αρχείου κώδικα με περιορισμένη αλλαγή, διατηρώντας το υπόλοιπο περιεχόμενο. Ορίστε την ακριβή αλλαγή και το υλικό που πρέπει να παραμείνει. Αντίθετα, ένα πρόθεμα απάντησης δίνει μια γνωστή αρχή από την οποία συνεχίζεται η παραγωγή· διαφέρει τόσο από ένα γνωστό πλήρες σώμα όσο και από ένα επίθημα FIM.
Μια ερώτηση τεκμηρίωσης μπορεί να χρησιμοποιήσει τη ροή επεξεργασίας εγγράφων του κατασκευαστή για την προετοιμασία κειμένου και δομής με OCR πριν από την ανάλυση του γλωσσικού μοντέλου. Για προγραμματιστικό υλικό που είναι ήδη διαθέσιμο ως κείμενο, δώστε τα σχετικά αποσπάσματα τεκμηρίωσης και ρωτήστε ποια προϋπόθεση διέπει την υλοποίηση. Κρατήστε κάθε εξαγόμενη απαίτηση συνδεδεμένη με την ενότητα πηγής της, ώστε ο παραγόμενος κώδικας ή η εξήγηση να παραμένει συνδεδεμένος με την παρεχόμενη προδιαγραφή.
Εργαλεία και πρακτικά αποτελέσματα
Η κλήση συναρτήσεων επιτρέπει στην εφαρμογή να παρέχει περιγεγραμμένες λειτουργίες και τις παραμέτρους τους. Το μοντέλο προετοιμάζει μια κλήση, η εφαρμογή την εκτελεί και το επιστρεφόμενο αποτέλεσμα γίνεται πλαίσιο για την επόμενη απάντηση. Ένας βοηθός κώδικα μπορεί να λάβει αποτέλεσμα αναζήτησης ή υπολογισμού μέσα από αυτόν τον κύκλο, αλλά η μεταγλώττιση, οι δοκιμές ή η εφαρμογή μιας προτεινόμενης αλλαγής εξακολουθούν να απαιτούν το περιβάλλον ανάπτυξης.
Για μια πρακτική διόρθωση, ορίστε τη δημόσια διεπαφή που πρέπει να παραμείνει συμβατή και ζητήστε το αναθεωρημένο απόσπασμα, μια συνοπτική εξήγηση και παραδείγματα εισόδων με αναμενόμενες εξόδους. Για μια παραγόμενη συνάρτηση, δηλώστε τους αποδεκτούς τύπους και τις οριακές συνθήκες. Για μια εξήγηση, δώστε την είσοδο της οποίας η εκτέλεση πρέπει να ανιχνευθεί, ώστε η απάντηση να συνδέει μια συγκεκριμένη διαδρομή εκτέλεσης με την επιστρεφόμενη τιμή.
Το Codestral παράγει κείμενο. Δεν κληρονομεί διανύσματα αναζήτησης κώδικα από το Codestral Embed, αυτοματοποίηση αποθετηρίου από το Devstral ή παραγωγή εικόνας από κάποιο οπτικό μοντέλο. Η συγκεκριμένη σελίδα του μοντέλου 2508 δεν δημοσιεύει πλήθος παραμέτρων ή αυτοτελές μέγιστο μήκος απάντησης που θα μπορούσε να δανειστεί από άλλη έκδοση. Διατηρήστε την ονομασμένη έκδοση, το πλαίσιο κώδικα και το απαιτούμενο παραδοτέο όταν προετοιμάζετε μια επαναλήψιμη ροή επεξεργαστή ή συνομιλίας.
", "aboutText": "Το Codestral 2508 είναι το μοντέλο προγραμματισμού της Mistral AI για συχνές εργασίες συμπλήρωσης και παραγωγής που είναι ευαίσθητες στην καθυστέρηση. Λαμβάνει πηγαίο κώδικα και απαιτήσεις σε κείμενο και επιστρέφει κείμενο που μπορεί να περιέχει μια υλοποίηση, συμπλήρωση, διόρθωση ή εξήγηση. Η συγκεκριμένη έκδοση 2508 εστιάζει στο τρέχον πλαίσιο επεξεργασίας του προγραμματιστή και δεν είναι μοντέλο embeddings ούτε, από μόνη της, ολοκληρωμένος πράκτορας αποθετηρίου.\n\nΣυμπλήρωση κώδικα και ενημέρωση 2508\n\nΟ κατασκευαστής προορίζει το Codestral για συμπλήρωση στο μέσο και επεξεργασία πολλών γραμμών. Η έκδοση περιγράφει βελτιώσεις στη συμπεριφορά συμπλήρωσης, μεταξύ των οποίων ο περιορισμός της ανεξέλεγκτης παραγωγής, καθώς και βελτιώσεις στην τήρηση οδηγιών και στις εργασίες κώδικα σε λειτουργία συνομιλίας. Πρόκειται για αλλαγές στη συγκεκριμένη έκδοση του Codestral· οι λειτουργίες ανάκτησης πληροφοριών και αυτόνομων πρακτόρων της περιβάλλουσας στοίβας προγραμματισμού ανήκουν σε ξεχωριστά κατονομαζόμενα συστατικά.\n\nΓια μια εργασία συμπλήρωσης, κρατήστε τη σχετική υπογραφή συνάρτησης, τις δηλώσεις και τα συμφραζόμενα κλήσης μαζί με τη θέση του δρομέα. Προσδιορίστε αν το επιθυμητό αποτέλεσμα είναι μόνο ο κώδικας που λείπει ή μια ολόκληρη αναθεωρημένη συνάρτηση. Ένα αίτημα για επεξεργαστή κώδικα μπορεί να ζητά σώμα βρόχου που διατηρεί τον υπάρχοντα τύπο επιστροφής, κρατά τις διπλότυπες τιμές και δεν μεταβάλλει την είσοδο του καλούντος. Το αποτέλεσμα αποκτά έτσι συγκεκριμένο σημείο εισαγωγής και καθορισμένη συμπεριφορά.\n\nΠροετοιμασία συμπλήρωσης στο μέσο\n\nΣτη διεπαφή FIM του κατασκευαστή, το prompt παρέχει κείμενο ή κώδικα προς συμπλήρωση και ένα προαιρετικό επίθημα παρέχει το υλικό μετά το κενό. Όταν παρέχονται και τα δύο, το μοντέλο συμπληρώνει τον χώρο ανάμεσά τους. Χωρίς επίθημα, συνεχίζει από το prompt. Αυτό διαφέρει από ένα συνηθισμένο αίτημα συνομιλίας που ζητά μια αλλαγή κώδικα και μια εξήγηση· κάθε τρόπος προετοιμασίας καθορίζει διαφορετικό συμβόλαιο εξόδου.\n\nΜια χρήσιμη είσοδος για συμπλήρωση κενού περιλαμβάνει την αρχή της συνάρτησης, τον κώδικα που πρέπει να ακολουθήσει την εισαγωγή και τυχόν σχετικούς ορισμούς τύπων ή βοηθητικών συναρτήσεων. Διατηρήστε τις εσοχές και τους οριοθέτες, ώστε το επιστρεφόμενο κείμενο να μπορεί να ενσωματωθεί στο υπάρχον απόσπασμα. Αν χρειάζεται μόνο το σώμα που λείπει, ζητήστε αυτό και όχι επανεγγραφή ολόκληρου του αρχείου. Μια ξεχωριστή ερώτηση συνομιλίας μπορεί να εξηγεί γιατί το συμπληρωμένο απόσπασμα ικανοποιεί την απαίτηση.\n\nΗ επίσημη τεκμηρίωση FIM επιτρέπει προϋπολογισμό token εξόδου και απαιτεί το prompt μαζί με αυτόν τον προϋπολογισμό να παραμένουν μέσα στο πλαίσιο συμφραζομένων του μοντέλου. Τεκμηριώνει επίσης ακολουθίες τερματισμού και συνεχή ροή του παραγόμενου περιεχομένου. Επιλέξτε ροή συμπλήρωσης όταν το αποτέλεσμα πρέπει να ταιριάζει στο κενό του κώδικα και ροή συνομιλίας όταν η εργασία ζητά κώδικα μαζί με εξήγηση.\n\nΣυμφραζόμενα και υποστηρικτικές δυνατότητες\n\nΗ σελίδα του μοντέλου αναφέρει παράθυρο συμφραζομένων 128 χιλ. token. Χρησιμοποιήστε το για να διατηρείτε τον πηγαίο κώδικα και τις δηλώσεις που καθορίζουν την επιδιωκόμενη αλλαγή, κρατώντας παράλληλα ρητή την πραγματική εργασία επεξεργασίας. Για αίτημα διόρθωσης σφάλματος, δώστε την επηρεαζόμενη συνάρτηση, μια συγκεκριμένη είσοδο που αποτυγχάνει, το αναμενόμενο αποτέλεσμα και το σφάλμα ή την παρατηρούμενη συμπεριφορά. Ζητήστε την προτεινόμενη διόρθωση χωριστά από την εξήγηση και τα παραδείγματά της.\n\nΗ σελίδα αναφέρει επίσης δομημένες εξόδους, κλήση συναρτήσεων, προβλεπόμενες εξόδους, απαντήσεις σε ερωτήσεις εγγράφων, προθέματα απάντησης και ομαδική επεξεργασία, μαζί με τις δυνατότητες συνομιλίας και FIM. Για ένα δομημένο αποτέλεσμα ελέγχου κώδικα, ορίστε πεδία όπως το επηρεαζόμενο σύμβολο, η παρατηρούμενη ασυμφωνία, η προτεινόμενη αλλαγή και η παραδοχή που χρειάζεται ακόμη διευκρίνιση. Οι οδηγίες της Mistral για δομημένη έξοδο διακρίνουν τη λειτουργία JSON από ένα προσαρμοσμένο σχήμα, με την επιθυμητή μορφή JSON να δηλώνεται στο prompt.\n\nΟι προβλεπόμενες έξοδοι προορίζονται για περιεχόμενο όπου σημαντικά μέρη της απάντησης είναι ήδη γνωστά. Μπορούν να χρησιμοποιηθούν κατά την αναδημιουργία εγγράφου ή αρχείου κώδικα με περιορισμένη αλλαγή, διατηρώντας το υπόλοιπο περιεχόμενο. Ορίστε την ακριβή αλλαγή και το υλικό που πρέπει να παραμείνει. Αντίθετα, ένα πρόθεμα απάντησης δίνει μια γνωστή αρχή από την οποία συνεχίζεται η παραγωγή· διαφέρει τόσο από ένα γνωστό πλήρες σώμα όσο και από ένα επίθημα FIM.\n\nΜια ερώτηση τεκμηρίωσης μπορεί να χρησιμοποιήσει τη ροή επεξεργασίας εγγράφων του κατασκευαστή για την προετοιμασία κειμένου και δομής με OCR πριν από την ανάλυση του γλωσσικού μοντέλου. Για προγραμματιστικό υλικό που είναι ήδη διαθέσιμο ως κείμενο, δώστε τα σχετικά αποσπάσματα τεκμηρίωσης και ρωτήστε ποια προϋπόθεση διέπει την υλοποίηση. Κρατήστε κάθε εξαγόμενη απαίτηση συνδεδεμένη με την ενότητα πηγής της, ώστε ο παραγόμενος κώδικας ή η εξήγηση να παραμένει συνδεδεμένος με την παρεχόμενη προδιαγραφή.\n\nΕργαλεία και πρακτικά αποτελέσματα\n\nΗ κλήση συναρτήσεων επιτρέπει στην εφαρμογή να παρέχει περιγεγραμμένες λειτουργίες και τις παραμέτρους τους. Το μοντέλο προετοιμάζει μια κλήση, η εφαρμογή την εκτελεί και το επιστρεφόμενο αποτέλεσμα γίνεται πλαίσιο για την επόμενη απάντηση. Ένας βοηθός κώδικα μπορεί να λάβει αποτέλεσμα αναζήτησης ή υπολογισμού μέσα από αυτόν τον κύκλο, αλλά η μεταγλώττιση, οι δοκιμές ή η εφαρμογή μιας προτεινόμενης αλλαγής εξακολουθούν να απαιτούν το περιβάλλον ανάπτυξης.\n\nΓια μια πρακτική διόρθωση, ορίστε τη δημόσια διεπαφή που πρέπει να παραμείνει συμβατή και ζητήστε το αναθεωρημένο απόσπασμα, μια συνοπτική εξήγηση και παραδείγματα εισόδων με αναμενόμενες εξόδους. Για μια παραγόμενη συνάρτηση, δηλώστε τους αποδεκτούς τύπους και τις οριακές συνθήκες. Για μια εξήγηση, δώστε την είσοδο της οποίας η εκτέλεση πρέπει να ανιχνευθεί, ώστε η απάντηση να συνδέει μια συγκεκριμένη διαδρομή εκτέλεσης με την επιστρεφόμενη τιμή.\n\nΤο Codestral παράγει κείμενο. Δεν κληρονομεί διανύσματα αναζήτησης κώδικα από το Codestral Embed, αυτοματοποίηση αποθετηρίου από το Devstral ή παραγωγή εικόνας από κάποιο οπτικό μοντέλο. Η συγκεκριμένη σελίδα του μοντέλου 2508 δεν δημοσιεύει πλήθος παραμέτρων ή αυτοτελές μέγιστο μήκος απάντησης που θα μπορούσε να δανειστεί από άλλη έκδοση. Διατηρήστε την ονομασμένη έκδοση, το πλαίσιο κώδικα και το απαιτούμενο παραδοτέο όταν προετοιμάζετε μια επαναλήψιμη ροή επεξεργαστή ή συνομιλίας.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "94ac2f931be57200b237969119c9a2a410a0bdd588617829ba54ae4182b079a3", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "el", "methods": [ { "html": "mistralai/codestral-2508:batchΤο Codestral 2508 είναι το μοντέλο κειμένου της Mistral AI για παραγωγή κώδικα και συμπλήρωση με επίγνωση των συμφραζομένων. Είναι βελτιστοποιημένο για συχνές εργασίες επεξεργαστή, όπως συμπλήρωση στο μέσο και αλλαγές πολλών γραμμών, με πλαίσιο 128 χιλ. token σύμφωνα με τον κατασκευαστή και τεκμηριωμένες λειτουργίες συνομιλίας, δομημένης εξόδου και εργαλείων.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Codestral 2508 είναι το μοντέλο προγραμματισμού της Mistral AI για συχνές εργασίες συμπλήρωσης και παραγωγής που είναι ευαίσθητες στην καθυστέρηση. Λαμβάνει πηγαίο κώδικα και απαιτήσεις σε κείμενο και επιστρέφει κείμενο που μπορεί να περιέχει μια υλοποίηση, συμπλήρωση, διόρθωση ή εξήγηση. Η συγκεκριμένη έκδοση 2508 εστιάζει στο τρέχον πλαίσιο επεξεργασίας του προγραμματιστή και δεν είναι μοντέλο embeddings ούτε, από μόνη της, ολοκληρωμένος πράκτορας αποθετηρίου.
Συμπλήρωση κώδικα και ενημέρωση 2508
Ο κατασκευαστής προορίζει το Codestral για συμπλήρωση στο μέσο και επεξεργασία πολλών γραμμών. Η έκδοση περιγράφει βελτιώσεις στη συμπεριφορά συμπλήρωσης, μεταξύ των οποίων ο περιορισμός της ανεξέλεγκτης παραγωγής, καθώς και βελτιώσεις στην τήρηση οδηγιών και στις εργασίες κώδικα σε λειτουργία συνομιλίας. Πρόκειται για αλλαγές στη συγκεκριμένη έκδοση του Codestral· οι λειτουργίες ανάκτησης πληροφοριών και αυτόνομων πρακτόρων της περιβάλλουσας στοίβας προγραμματισμού ανήκουν σε ξεχωριστά κατονομαζόμενα συστατικά.
Για μια εργασία συμπλήρωσης, κρατήστε τη σχετική υπογραφή συνάρτησης, τις δηλώσεις και τα συμφραζόμενα κλήσης μαζί με τη θέση του δρομέα. Προσδιορίστε αν το επιθυμητό αποτέλεσμα είναι μόνο ο κώδικας που λείπει ή μια ολόκληρη αναθεωρημένη συνάρτηση. Ένα αίτημα για επεξεργαστή κώδικα μπορεί να ζητά σώμα βρόχου που διατηρεί τον υπάρχοντα τύπο επιστροφής, κρατά τις διπλότυπες τιμές και δεν μεταβάλλει την είσοδο του καλούντος. Το αποτέλεσμα αποκτά έτσι συγκεκριμένο σημείο εισαγωγής και καθορισμένη συμπεριφορά.
Προετοιμασία συμπλήρωσης στο μέσο
Στη διεπαφή FIM του κατασκευαστή, το prompt παρέχει κείμενο ή κώδικα προς συμπλήρωση και ένα προαιρετικό επίθημα παρέχει το υλικό μετά το κενό. Όταν παρέχονται και τα δύο, το μοντέλο συμπληρώνει τον χώρο ανάμεσά τους. Χωρίς επίθημα, συνεχίζει από το prompt. Αυτό διαφέρει από ένα συνηθισμένο αίτημα συνομιλίας που ζητά μια αλλαγή κώδικα και μια εξήγηση· κάθε τρόπος προετοιμασίας καθορίζει διαφορετικό συμβόλαιο εξόδου.
Μια χρήσιμη είσοδος για συμπλήρωση κενού περιλαμβάνει την αρχή της συνάρτησης, τον κώδικα που πρέπει να ακολουθήσει την εισαγωγή και τυχόν σχετικούς ορισμούς τύπων ή βοηθητικών συναρτήσεων. Διατηρήστε τις εσοχές και τους οριοθέτες, ώστε το επιστρεφόμενο κείμενο να μπορεί να ενσωματωθεί στο υπάρχον απόσπασμα. Αν χρειάζεται μόνο το σώμα που λείπει, ζητήστε αυτό και όχι επανεγγραφή ολόκληρου του αρχείου. Μια ξεχωριστή ερώτηση συνομιλίας μπορεί να εξηγεί γιατί το συμπληρωμένο απόσπασμα ικανοποιεί την απαίτηση.
Η επίσημη τεκμηρίωση FIM επιτρέπει προϋπολογισμό token εξόδου και απαιτεί το prompt μαζί με αυτόν τον προϋπολογισμό να παραμένουν μέσα στο πλαίσιο συμφραζομένων του μοντέλου. Τεκμηριώνει επίσης ακολουθίες τερματισμού και συνεχή ροή του παραγόμενου περιεχομένου. Επιλέξτε ροή συμπλήρωσης όταν το αποτέλεσμα πρέπει να ταιριάζει στο κενό του κώδικα και ροή συνομιλίας όταν η εργασία ζητά κώδικα μαζί με εξήγηση.
Συμφραζόμενα και υποστηρικτικές δυνατότητες
Η σελίδα του μοντέλου αναφέρει παράθυρο συμφραζομένων 128 χιλ. token. Χρησιμοποιήστε το για να διατηρείτε τον πηγαίο κώδικα και τις δηλώσεις που καθορίζουν την επιδιωκόμενη αλλαγή, κρατώντας παράλληλα ρητή την πραγματική εργασία επεξεργασίας. Για αίτημα διόρθωσης σφάλματος, δώστε την επηρεαζόμενη συνάρτηση, μια συγκεκριμένη είσοδο που αποτυγχάνει, το αναμενόμενο αποτέλεσμα και το σφάλμα ή την παρατηρούμενη συμπεριφορά. Ζητήστε την προτεινόμενη διόρθωση χωριστά από την εξήγηση και τα παραδείγματά της.
Η σελίδα αναφέρει επίσης δομημένες εξόδους, κλήση συναρτήσεων, προβλεπόμενες εξόδους, απαντήσεις σε ερωτήσεις εγγράφων, προθέματα απάντησης και ομαδική επεξεργασία, μαζί με τις δυνατότητες συνομιλίας και FIM. Για ένα δομημένο αποτέλεσμα ελέγχου κώδικα, ορίστε πεδία όπως το επηρεαζόμενο σύμβολο, η παρατηρούμενη ασυμφωνία, η προτεινόμενη αλλαγή και η παραδοχή που χρειάζεται ακόμη διευκρίνιση. Οι οδηγίες της Mistral για δομημένη έξοδο διακρίνουν τη λειτουργία JSON από ένα προσαρμοσμένο σχήμα, με την επιθυμητή μορφή JSON να δηλώνεται στο prompt.
Οι προβλεπόμενες έξοδοι προορίζονται για περιεχόμενο όπου σημαντικά μέρη της απάντησης είναι ήδη γνωστά. Μπορούν να χρησιμοποιηθούν κατά την αναδημιουργία εγγράφου ή αρχείου κώδικα με περιορισμένη αλλαγή, διατηρώντας το υπόλοιπο περιεχόμενο. Ορίστε την ακριβή αλλαγή και το υλικό που πρέπει να παραμείνει. Αντίθετα, ένα πρόθεμα απάντησης δίνει μια γνωστή αρχή από την οποία συνεχίζεται η παραγωγή· διαφέρει τόσο από ένα γνωστό πλήρες σώμα όσο και από ένα επίθημα FIM.
Μια ερώτηση τεκμηρίωσης μπορεί να χρησιμοποιήσει τη ροή επεξεργασίας εγγράφων του κατασκευαστή για την προετοιμασία κειμένου και δομής με OCR πριν από την ανάλυση του γλωσσικού μοντέλου. Για προγραμματιστικό υλικό που είναι ήδη διαθέσιμο ως κείμενο, δώστε τα σχετικά αποσπάσματα τεκμηρίωσης και ρωτήστε ποια προϋπόθεση διέπει την υλοποίηση. Κρατήστε κάθε εξαγόμενη απαίτηση συνδεδεμένη με την ενότητα πηγής της, ώστε ο παραγόμενος κώδικας ή η εξήγηση να παραμένει συνδεδεμένος με την παρεχόμενη προδιαγραφή.
Εργαλεία και πρακτικά αποτελέσματα
Η κλήση συναρτήσεων επιτρέπει στην εφαρμογή να παρέχει περιγεγραμμένες λειτουργίες και τις παραμέτρους τους. Το μοντέλο προετοιμάζει μια κλήση, η εφαρμογή την εκτελεί και το επιστρεφόμενο αποτέλεσμα γίνεται πλαίσιο για την επόμενη απάντηση. Ένας βοηθός κώδικα μπορεί να λάβει αποτέλεσμα αναζήτησης ή υπολογισμού μέσα από αυτόν τον κύκλο, αλλά η μεταγλώττιση, οι δοκιμές ή η εφαρμογή μιας προτεινόμενης αλλαγής εξακολουθούν να απαιτούν το περιβάλλον ανάπτυξης.
Για μια πρακτική διόρθωση, ορίστε τη δημόσια διεπαφή που πρέπει να παραμείνει συμβατή και ζητήστε το αναθεωρημένο απόσπασμα, μια συνοπτική εξήγηση και παραδείγματα εισόδων με αναμενόμενες εξόδους. Για μια παραγόμενη συνάρτηση, δηλώστε τους αποδεκτούς τύπους και τις οριακές συνθήκες. Για μια εξήγηση, δώστε την είσοδο της οποίας η εκτέλεση πρέπει να ανιχνευθεί, ώστε η απάντηση να συνδέει μια συγκεκριμένη διαδρομή εκτέλεσης με την επιστρεφόμενη τιμή.
Το Codestral παράγει κείμενο. Δεν κληρονομεί διανύσματα αναζήτησης κώδικα από το Codestral Embed, αυτοματοποίηση αποθετηρίου από το Devstral ή παραγωγή εικόνας από κάποιο οπτικό μοντέλο. Η συγκεκριμένη σελίδα του μοντέλου 2508 δεν δημοσιεύει πλήθος παραμέτρων ή αυτοτελές μέγιστο μήκος απάντησης που θα μπορούσε να δανειστεί από άλλη έκδοση. Διατηρήστε την ονομασμένη έκδοση, το πλαίσιο κώδικα και το απαιτούμενο παραδοτέο όταν προετοιμάζετε μια επαναλήψιμη ροή επεξεργαστή ή συνομιλίας.
POST /v1/batchestexttext| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοendpoint | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια /v1/chat/completions | Προεπιλογή— |
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια mistralai/codestral-2508:batch | Προεπιλογή— |
Πεδίοrequests | Τύποςbatch_item[] | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 | Προεπιλογή— |
Πεδίοrequests[].custom_id | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοrequests[].body.messages | Τύποςmessage[] | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοcompletion_window | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 24h | Προεπιλογή— |
Πεδίοprovider | Τύποςobject|null | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοrequests[].body.model | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια mistralai/codestral-2508:batch, mistralai/codestral-2508 | Προεπιλογή— |
Πεδίοprovider.only | Τύποςstring[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια mistral | Προεπιλογή— |
Πεδίοprovider.allow_fallbacks | Τύποςboolean|null | ΑπαίτησηΠροαιρετικό | Τιμές και όρια false, null | Προεπιλογή— |
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηendpoint, model, requests |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςrepresentation | ΣύμβασηΕνσωματωμένος πίνακας requests[]· κάθε στοιχείο έχει custom_id και body |
Παράμετροςrequest_endpoint_profile | Σύμβαση/v1/chat/completions |
Παράμετροςfile_material | ΣύμβασηΟ καλών μπορεί να διαβάσει το πραγματικό υλικό UTF-8 JSONL τοπικά στον πίνακα requests[]. Δεν χρησιμοποιείται παράμετρος purpose για μεταφόρτωση, input_file_id ή αναφορά σε αρχείο. Αν το υλικό του πελάτη λείπει ή είναι κενό, η προετοιμασία σταματά πριν από το POST. |
Παράμετροςserialization_order | Σύμβασηendpoint, model, provider (αν παρέχεται), completion_window (αν παρέχεται), requests στο τέλος |
Παράμετροςoptional_controls | Σύμβασηprovider.only, provider.allow_fallbacks, completion_window |
Παράμετροςschema_scope | ΣύμβασηΣώματα αιτημάτων Text Chat Completions στον τεκμηριωμένο ενσωματωμένο φάκελο Batch. |
Κύκλος ζωής: asynchronous
GET /v1/batches/{operation_id} · Το πραγματικό response.id της αρχικής απόκρισης δημιουργίας· ο ίδιος χρήστης, το ίδιο κλειδί και η ίδια ομάδα
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Token συμφραζομένων, πάνω από | Token συμφραζομένων, έως και | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις ανά token | Πίνακας χρεώσεωνΒασική χρέωση | Token συμφραζομένων, πάνω από— | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0003 / 1K token Έξοδος · Token εξόδου $0.0009 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.00003 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηΕπίπεδο 1 βάσει μήκους αιτήματος | Πίνακας χρεώσεων— | Token συμφραζομένων, πάνω από0 | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου $0.0003 / 1K token Έξοδος · Token εξόδου $0.0009 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.00003 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"mistralai/codestral-2508:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n if supplied_model is not None and supplied_model not in ['mistralai/codestral-2508:batch', 'mistralai/codestral-2508']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"mistralai/codestral-2508:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nΕνσωματωμένο JSON στο results[].response.body
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nΔιατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε ολόκληρο το αρχικό JSON κατάστασης, κάθε result/custom_id και ολόκληρο το σώμα της απόκρισης ή του σφάλματος. Αποθηκεύστε τα ολοκληρωμένα results[] ως JSONL χωρίς φιλτράρισμα.
Διατηρήστε το αρχικό ID της λειτουργίας. Η απόκριση 503 result_pending_check περιέχει X-Should-Retry:false· μην υποβάλετε ποτέ ξανά μια αρχική μαζική εργασία με άγνωστη έκβαση.
| Πεδίο | Τύπος |
|---|---|
Πεδίοresults[].custom_id | Τύποςstring |
Πεδίοresults[].response.body.choices[].message.content | Τύποςstring|null |
Πεδίοresults[].error | Τύποςobject|null |
Πεδίοusage | Τύποςobject|null |
Πεδίοid | Τύποςstring |
Πεδίοmodel | Τύποςstring |
Πεδίοendpoint | Τύποςstring |
Πεδίοstatus | Τύποςstring |
Πεδίοrequest_counts | Τύποςobject |
Πεδίοresults[].id | Τύποςstring |
Πεδίοresults[].response.status_code | Τύποςinteger |
Πεδίοresults[].response.request_id | Τύποςstring |
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρος τεκμηριωμένος ενσωματωμένος φάκελος, διπλότυπα κλειδιά, ταυτότητα στοιχείου ή σύγκρουση με τις ρυθμισμένες δυνατότητες του μοντέλου. | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από οποιαδήποτε νέα υποβολή. |
Απάντηση401 · authentication_error | ΣυνθήκηΜη έγκυρο κλειδί API. | Επόμενο βήμαΧρησιμοποιήστε το εξουσιοδοτημένο κλειδί Ailoot. |
Απάντηση403 · permission_error | ΣυνθήκηΗ ομάδα μαζικής επεξεργασίας δεν είναι διαθέσιμη. | Επόμενο βήμαΕλέγξτε τα δικαιώματα πρόσβασης του κλειδιού/της ομάδας. |
Απάντηση422 · invalid_request_error | ΣυνθήκηΗ μαζική επεξεργασία χρεώνεται στο υπόλοιπο· η δημιουργία μέσω συνδρομής απορρίπτεται. | Επόμενο βήμαΧρησιμοποιήστε την εξουσιοδοτημένη ομάδα που χρεώνεται στο υπόλοιπο. |
Απάντηση422 · price_unavailable | ΣυνθήκηΔεν μπορεί να υπολογιστεί προσφορά κόστους για την είσοδο της μαζικής εργασίας. | Επόμενο βήμαΔιατηρήστε την απόκριση· χρησιμοποιήστε την τεκμηριωμένη είσοδο της οικογένειας API. |
Απάντηση402 · billing_error | ΣυνθήκηΤο ποσό δέσμευσης για τη μαζική επεξεργασία δεν είναι διαθέσιμο. | Επόμενο βήμαΕπιλύστε το ζήτημα αποδοχής πριν από ένα νέο αίτημα. |
Απάντηση503 · price_unavailable | ΣυνθήκηΗ τιμή της μεθόδου μαζικής επεξεργασίας/οι εγγενείς τιμές δεν είναι διαθέσιμες. | Επόμενο βήμαΔιατηρήστε την απόκριση· μην αντικαθιστάτε τις τιμές. |
Απάντηση503 · api_error | ΣυνθήκηΗ ακριβής διαδρομή του προμηθευτή δεν είναι διαθέσιμη. | Επόμενο βήμαΔιατηρήστε την απόκριση για τη διόρθωση της διαδρομής. |
Απάντηση503 · result_pending_check | ΣυνθήκηΤο αρχικό αποτέλεσμα χρειάζεται έλεγχο· X-Should-Retry:false. | Επόμενο βήμαΔιατηρήστε το αρχικό operation_id/id και διαβάστε την κατάστασή του· μην επαναλάβετε ποτέ το αρχικό POST. |
Απάντηση404 · not_found | ΣυνθήκηΗ λειτουργία κατάστασης της μαζικής εργασίας δεν υπάρχει ή ανήκει σε άλλη ταυτότητα. | Επόμενο βήμαΧρησιμοποιήστε το ακριβές αρχικό id και τον ίδιο χρήστη, το ίδιο κλειδί και την ίδια ομάδα. |
Ailoot Ultra mistralai/codestral-2508:batch
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.