Μυστικά και μεταβλητές περιβάλλοντος χωρίς επικόλληση κλειδιών στη συνομιλία

Οι περισσότερες πραγματικές εφαρμογές χρειάζονται τουλάχιστον ένα μυστικό: το κλειδί ενός παρόχου πληρωμών, μιας υπηρεσίας email ή ενός API τεχνητής νοημοσύνης. Στο Mythex δεν τα επικολλάτε σε ένα prompt. Όταν ο πράκτορας χρειαστεί ένα, εμφανίζει στη συνομιλία μια κάρτα αιτήματος μυστικού, εσείς πληκτρολογείτε την τιμή μέσα στην κάρτα, και αποθηκεύεται ως μυστικό του έργου που μπορεί να διαβάσει η εφαρμογή σας — χωρίς το κλειδί να καταλήγει στη συνομιλία.

Τι κάνει

Κάθε έργο του Mythex μπορεί να αποθηκεύει μεταβλητές περιβάλλοντος: ονομασμένες τιμές, όπως το STRIPE_SECRET_KEY, που η εφαρμογή σας διαβάζει όταν τρέχει, αντί να τις έχετε γραμμένες μέσα στον κώδικα. Τα μυστικά είναι μεταβλητές περιβάλλοντος των οποίων οι τιμές πρέπει να μένουν ιδιωτικές.

Οι ίδιες τιμές είναι διαθέσιμες σε δύο σημεία:

• Στο sandbox, όπου ο πράκτορας χτίζει και τρέχει την εφαρμογή ενώ δουλεύετε.
• Στις δημοσιευμένες αναπτύξεις σας, όπου τις χρησιμοποιούν οι επισκέπτες.

Υπάρχουν τρεις τρόποι να τις προσθέσετε:

1. Η κάρτα αιτήματος μυστικών, που ο πράκτορας εμφανίζει στη συνομιλία όταν χρειάζεται ένα κλειδί για να ολοκληρώσει κάτι.
2. Ρυθμίσεις έργου → Μυστικά, όπου μπορείτε να προσθέτετε ή να επεξεργάζεστε τιμές ανά πάσα στιγμή.
3. /secrets στη συνομιλία, για να προσθέσετε ή να ενημερώσετε μυστικά όταν το ζητήσετε.

Γιατί βοηθά

Ο προφανής τρόπος να δώσετε ένα κλειδί σε πράκτορα τεχνητής νοημοσύνης είναι να το επικολλήσετε στο μήνυμά σας. Λειτουργεί, αλλά τότε το κλειδί γίνεται μέρος του ιστορικού της συνομιλίας σας, σε απλό κείμενο δίπλα σε όλα όσα έχετε γράψει.

Η κάρτα μυστικών κρατά την τιμή έξω από το ιστορικό. Την εισάγετε στα πεδία της κάρτας, όχι στο πεδίο μηνύματος, και αποθηκεύεται ως μυστικό του έργου. Ο πράκτορας συνεχίζει με το κλειδί διαθέσιμο στο sandbox.

Το να φυλάτε τα κλειδιά στις ρυθμίσεις του έργου αντί στον κώδικα έχει και άλλα πλεονεκτήματα:

• Τα κλειδιά μένουν έξω από τον έλεγχο εκδόσεων. Ο κώδικάς σας αναφέρεται σε ένα κλειδί με το όνομά του· η τιμή βρίσκεται στις ρυθμίσεις του έργου.
• Ο πράκτορας και η εφαρμογή σας που τρέχει βλέπουν την ίδια διαμόρφωση. Δεν υπάρχει αντίγραφο που ξεφεύγει με τον καιρό.
• Μπορείτε να αλλάξετε κλειδί χωρίς να ξαναγράψετε κώδικα. Αλλάζετε την τιμή στις ρυθμίσεις· ο κώδικας συνεχίζει να τη διαβάζει με το όνομά της.

Αν οι μεταβλητές περιβάλλοντος είναι καινούργιες για εσάς, ο οδηγός μας για το τι είναι οι μεταβλητές περιβάλλοντος και τα μυστικά εξηγεί την ιδέα από την αρχή.

Πώς χρησιμοποιείτε την κάρτα μυστικών

1. Ζητήστε τη λειτουργία — για παράδειγμα, «στείλε καλωσορισμό με email όταν εγγράφεται κάποιος».
2. Όταν ο πράκτορας χρειαστεί κλειδί, εμφανίζεται στη συνομιλία μια κάρτα αιτήματος μυστικών με την τιμή που χρειάζεται.
3. Εισάγετε την τιμή στα πεδία της κάρτας, όχι στο πεδίο μηνύματος.
4. Επιβεβαιώστε. Η τιμή αποθηκεύεται ως μυστικό του έργου.
5. Ο πράκτορας συνεχίζει, με το κλειδί διαθέσιμο στο sandbox.

Πώς προσθέτετε μυστικά μόνοι σας

1. Ανοίξτε τις ρυθμίσεις του έργου, και μετά Secrets.
2. Προσθέστε κλειδιά όπως STRIPE_SECRET_KEY, OPENAI_API_KEY ή τα δικά σας διαπιστευτήρια μιας υπηρεσίας.
3. Ζητήστε από τον πράκτορα να τα διαβάζει με τον τυπικό τρόπο του framework σας — για παράδειγμα από το process.env σε εφαρμογή Node.
4. Δημοσιεύστε ξανά αν μια δημοσιευμένη εφαρμογή χρειάζεται τις νέες τιμές.

Μπορείτε επίσης να γράψετε /secrets στη συνομιλία για να τα προσθέσετε ή να τα ενημερώσετε εκεί.

Αλλαγή μυστικού σε δημοσιευμένη εφαρμογή

Μια δημοσιευμένη εφαρμογή παίρνει τα μυστικά της τη στιγμή της δημοσίευσης. Αφού προσθέσετε ή αλλάξετε ένα, δημοσιεύστε ξανά ώστε η ζωντανή ανάπτυξη να πάρει τη νέα τιμή. Μέχρι τότε, οι επισκέπτες χρησιμοποιούν την εφαρμογή με την παλιά διαμόρφωση.

Συμβουλές ασφαλείας

• Ποτέ μην κάνετε commit μυστικά στο αποθετήριο. Κρατήστε τα στις ρυθμίσεις του έργου.
• Προτιμήστε κλειδιά μόνο για διακομιστή για τις προνομιακές λειτουργίες. Ένα κλειδί που μπορεί να χρεώσει κάρτες ή να στείλει email ανήκει σε κώδικα που τρέχει στον διακομιστή, όχι σε κάτι που κατεβάζει το πρόγραμμα περιήγησης ενός επισκέπτη.
• Αν ένα κλειδί εμφανιστεί ποτέ στο ιστορικό συνομιλίας, ανανεώστε το. Δημιουργήστε νέο κλειδί στον πάροχο, ανακαλέστε το παλιό και ενημερώστε την τιμή στις ρυθμίσεις του έργου. Θεωρήστε κάθε κλειδί που έχει επικολληθεί σε συνομιλία ως εκτεθειμένο.

Όρια

• Η κάρτα βοηθά μόνο αν τη χρησιμοποιείτε. Αν επικολλήσετε κλειδί στο πεδίο μηνύματος παρ' όλα αυτά, θα βρίσκεται στο ιστορικό. Ανανεώστε το στον πάροχο και ενημερώστε την αποθηκευμένη τιμή.
• Οι δημοσιευμένες εφαρμογές χρειάζονται νέα δημοσίευση για να πάρουν νέα ή αλλαγμένα μυστικά.
• Η ασφαλής αποθήκευση ενός κλειδιού δεν κάνει ασφαλή κάθε χρήση του. Το σημείο όπου χρησιμοποιείται το κλειδί μετράει — κρατήστε τα προνομιακά κλειδιά στην πλευρά του διακομιστή της εφαρμογής.

Για περισσότερα σχετικά με το πώς κρατάτε μια εφαρμογή ασφαλή πριν την μοιραστείτε, δείτε τη λίστα ελέγχου ασφαλείας για εφαρμογές που φτιάχνονται με AI.

Η τεκμηρίωση έχει τις λεπτομέρειες: Μεταβλητές περιβάλλοντος και μυστικά και Μυστικά στη συνομιλία.