Secrete și variabile de mediu, fără să lipești chei în chat

Majoritatea aplicațiilor reale au nevoie de cel puțin un secret: cheia unui furnizor de plăți, cheia unui serviciu de e-mail, o cheie pentru un API AI. În Mythex nu le lipești într-un prompt. Când agentul are nevoie de una, afișează în chat un card de secrets request, tu scrii valoarea în card, iar ea este stocată ca secret al proiectului pe care aplicația ta îl poate citi — fără ca cheia să ajungă în conversație.

Ce face

Fiecare proiect Mythex poate stoca variabile de mediu: valori cu nume, cum ar fi STRIPE_SECRET_KEY, pe care aplicația ta le citește la rulare, în loc să fie scrise direct în cod. Secretele sunt variabile de mediu ale căror valori trebuie să rămână private.

Aceleași valori sunt disponibile în două locuri:

Sandbox-ul, unde agentul construiește și rulează aplicația cât lucrezi.
Deployment-urile publicate, unde le folosesc vizitatorii.

Există trei moduri de a le adăuga:

Cardul de cerere pentru secrete, pe care agentul îl afișează în chat când are nevoie de o cheie ca să termine ceva.
Project settings → Secrets, unde poți adăuga sau edita valori oricând.
/secrets în chat, pentru a adăuga sau actualiza secrete la cerere.

De ce ajută

Modul evident de a da o cheie unui agent AI este să o lipești în mesaj. Funcționează, dar cheia devine atunci parte din istoricul conversației, stând în text clar lângă tot ce ai spus.

Cardul pentru secrete ține valoarea în afara transcriptului. O introduci în câmpurile cardului, nu în caseta de mesaj, iar ea este stocată ca secret al proiectului. Agentul continuă cu cheia disponibilă în sandbox.

Păstrarea cheilor în setările proiectului, nu în cod, are și alte avantaje:

Cheile rămân în afara controlului versiunilor. Codul tău se referă la o cheie după nume; valoarea trăiește în setările proiectului.
Agentul și aplicația ta care rulează văd aceeași configurație. Nu există o copie care se învechește.
Poți roti o cheie fără să rescrii codul. Schimbi valoarea în setări; codul o citește în continuare după nume.

Dacă variabilele de mediu îți sunt noi, ghidul nostru despre ce sunt variabilele de mediu și secretele explică ideea de la zero.

Cum folosești cardul pentru secrete

Cere funcționalitatea — de exemplu, "trimite un e-mail de bun venit când se înscrie cineva".
Când agentul are nevoie de o cheie, apare în chat un card de cerere pentru secrete, care listează valoarea necesară.
Introdu valoarea în câmpurile cardului, nu în caseta de mesaj.
Confirmă. Valoarea este stocată ca secret al proiectului.
Agentul continuă, cu cheia disponibilă în sandbox.

Cum adaugi singur secrete

Deschide project settings, apoi Secrets.
Adaugă chei precum STRIPE_SECRET_KEY, OPENAI_API_KEY sau credențialele propriului tău serviciu.
Cere agentului să le citească în modul standard pentru framework-ul tău — de exemplu din process.env într-o aplicație Node.
Republică dacă o aplicație publicată are nevoie de noile valori.

Poți scrie și /secrets în chat ca să le adaugi sau să le actualizezi acolo.

Schimbarea unui secret într-o aplicație publicată

O aplicație publicată preia secretele în momentul publicării. După ce adaugi sau schimbi unul, publică din nou pentru ca deployment-ul live să primească noua valoare. Până atunci, vizitatorii folosesc în continuare aplicația cu configurația veche.

Sfaturi de securitate

Nu salva niciodată secrete în repository. Păstrează-le în setările proiectului.
Preferă chei doar pentru server pentru operațiunile privilegiate. O cheie care poate debita carduri sau trimite e-mailuri aparține codului care rulează pe server, nu oricărui lucru pe care îl descarcă browserul unui vizitator.
Dacă o cheie a apărut vreodată în istoricul chatului, rotește-o. Creează o cheie nouă la furnizor, revocă-o pe cea veche și actualizează valoarea în setările proiectului. Consideră expusă orice cheie lipită într-un chat.

Limite

Cardul ajută doar dacă îl folosești. Dacă lipești totuși o cheie în caseta de mesaj, ea ajunge în transcript. Rotește-o la furnizor și actualizează valoarea stocată.
Aplicațiile publicate au nevoie de o republicare pentru a prelua secretele noi sau modificate.
A stoca o cheie în siguranță nu face sigură orice folosire a ei. Contează în continuare unde este folosită — păstrează cheile privilegiate pe partea de server a aplicației tale.

Pentru mai multe despre păstrarea unei aplicații în siguranță înainte de a o partaja, vezi lista noastră de verificare a securității pentru aplicațiile construite cu AI.

Documentația are detaliile: Variabile de mediu și secrete și Secrete în chat.