Секреттер және орта айнымалылары: кілтті чатқа қоймай-ақ

Нақты қолданбалардың көпшілігіне кем дегенде бір құпия мән керек: төлем провайдерінің кілті, электрондық пошта қызметінің кілті немесе AI API кілті. Mythex-те оларды сұрауға қоспайсыз. Агенттің кілт керегі болғанда чатта secrets сұрау карточкасы шығады, сіз мәнді карточкаға теріп енгізесіз, ол жоба secret ретінде сақталады, ал қолданбаңыз оны оқи алады. Кілт чат тарихына түспейді.

Бұл не істейді

Әрбір Mythex жобасы орта айнымалыларын сақтай алады: STRIPE_SECRET_KEY сияқты аталған мәндер, қолданбаңыз оларды іске қосылған кезде оқиды, кодқа жазылмайды. Secrets — мәндері құпия күйінде қалуы тиіс орта айнымалылары.

Бірдей мәндер екі жерде қолжетімді:

• Sandbox, онда агент пен қолданбаңызды сіз жұмыс істеп жатқанда құрастырып, іске қосады.
• Жарияланған деплойменттер, оларды келушілер пайдаланады.

Мәндерді қосудың үш жолы бар:

1. Secrets сұрау карточкасы. Агент бір нәрсені аяқтау үшін кілт керек болғанда оны чатта көрсетеді.
2. Project settings → Secrets. Мәндерді кез келген уақытта қосуға немесе өңдеуге болады.
3. Чаттағы /secrets. Secrets-ті сұрауы бойынша қосу немесе жаңарту үшін.

Неліктен бұл пайдалы

AI агентіне кілт беудің ең оңай жолы оны хабарламаға қою. Бұл жұмыс істейді, бірақ сонда кілт чат тарихының бөлігіне айналады да, сіз айтқан барлық нәрсенің қасында мәтін түрінде тұрады.

Secrets карточкасы кілтті транскрипттен тыс ұстайды. Мәнді хабарлама жолағына емес, карточканың өрістеріне енгізесіз, ол жоба secret ретінде сақталады. Агент кілтті sandbox ішінде қолжетімді күйде жалғастырады.

Кілттерді код ішінде емес, жоба параметрлерінде сақтаудың басқа да артықшылықтары бар:

• Кілттер бастапқы кодты басқару жүйесінен тыс қалады. Кодыңыз кілтке аты арқылы сілтейді, мәні жоба параметрлерінде тұрады.
• Агент пен іске қосылған қолданба бірдей конфигурацияны көреді. Ескірген көшірме болмайды.
• Кілтті кодты қайта жазбай-ақ ауыстыруға болады. Параметрлерде мәнді өзгертесіз, код оны әлі де аты бойынша оқиды.

Орта айнымалылары сізге жаңа болса, орта айнымалылары мен secrets деген не деген нұсқаулығымыз идеяны нөлден түсіндіреді.

Secrets карточкасын қалай пайдалану керек

1. Мүмкіндікті сұраңыз, мысалы: «біреу тіркелгенде қош келдіңіз хатын жіберу».
2. Агентке кілт керек болғанда чатта secrets сұрау карточкасы шығады, қажет мәнді тізімдейді.
3. Мәнді карточканың өрістеріне енгізіңіз, хабарлама жолағына емес.
4. Растаңыз. Мән жоба secret ретінде сақталады.
5. Агент жалғасады, кілт sandbox ішінде қолжетімді болады.

Secrets-ті өзіңіз қалай қосуға болады

1. Project settings бөлімін, содан кейін Secrets бөлімін ашыңыз.
2. STRIPE_SECRET_KEY, OPENAI_API_KEY сияқты кілттерді немесе өз қызметіңіздің деректерін қосыңыз.
3. Агенттен оларды фреймворкіңізге сәйкес стандартты жолмен оқуды сұраңыз, мысалы Node қолданбасында process.env арқылы.
4. Жарияланған қолданбаға жаңа мәндер керек болса, қайта жариялаңыз.

Чатта /secrets деп теріп те, оларды сонда қосуға немесе жаңартуға болады.

Жарияланған қолданбада secret-ті өзгерту

Жарияланған қолданба secrets-ті жарияланған кезде алады. Бір мәнді қосқан немесе өзгерткеннен кейін қайта жариялаңыз, сонда жанды деплойменттің жаңа мәні болады. Дейін келушілер қолданбаны ескі конфигурациямен пайдаланып тұрады.

Қауіпсіздік кеңестері

• Secrets-ті ешқашан репозиторийге коммит жасамаңыз. Оларды жоба параметрлерінде сақтаңыз.
• Артықшылықты операциялар үшін тек серверлік кілттерді таңдаңыз. Карталардан ақша алуға немесе электрондық пошта жіберуге болатын кілт сервер жағындағы кодта тұруы керек, келушінің браузері жүктей алатын ешнәрседе емес.
• Кілт чат тарихында пайда болса, оны ауыстырыңыз. Провайдерде жаңа кілт жасаңыз, ескісін жойыңыз, жоба параметрлерінде мәнді жаңартыңыз. Чатқа қойылған кез келген кілтті жария болған деп қараңыз.

Шектеулер

• Карточка тек пайдаланылған жағдайда ғана көмектеседі. Кілтті барлығына бірдей хабарлама жолағына қойсаңыз, ол транскриптте қалады. Провайдерде оны ауыстырып, сақталған мәнді жаңартыңыз.
• Жарияланған қолданбалар жаңа немесе өзгерген secrets-ті алу үшін қайта жариялануы керек.
• Кілтті қауіпсіз сақтау оны қауіпсіз пайдалануға кепілдік бермейді. Кілттің қай жерде қолданылатыны да маңызды: артықшылықты кілттерді қолданбаңыздың серверлік жағында ұстаңыз.

Жария етпес бұрын қолданбаны қорғау туралы көбірек білгіңіз келсе, AI арқылы жасалған қолданбаларға арналған қауіпсіздік тізімімізді оқыңыз.

Толық ақпарат құжаттарда бар: Орта айнымалылары мен secrets және Чаттағы secrets.