Titkok és környezeti változók kulcsok chatbe illesztése nélkül

A legtöbb valódi appnak legalább egy titokra van szüksége: egy fizetésszolgáltató kulcsára, egy e-mail-szolgáltató kulcsára, egy AI API kulcsára. A Mythexben ezeket nem illeszted be a promptba. Amikor az ügynöknek szüksége van egyre, megjelenít egy titokkérő kártyát a csevegésben, te beírod az értéket a kártyába, és az projekt-titokként tárolódik, amelyet az appod olvashat — anélkül, hogy a kulcs bekerülne a beszélgetésbe.

Mit csinál

Minden Mythex-projekt tárolhat környezeti változókat: nevesített értékeket, például STRIPE_SECRET_KEY, amelyeket az appod futáskor olvas, ahelyett hogy a kódba írnák őket. A titkok olyan környezeti változók, amelyek értékének titokban kell maradnia.

Ugyanezek az értékek két helyen érhetők el:

• A sandboxban, ahol az ügynök építi és futtatja az appodat, miközben dolgozol.
• A közzétett telepítéseidben, ahol a látogatók használják.

Három módon adhatsz hozzá őket:

1. A titokkérő kártya, amelyet az ügynök a csevegésben mutat, ha valamit egy kulcs nélkül nem tud befejezni.
2. Projektbeállítások → Titkok, ahol bármikor hozzáadhatsz vagy szerkeszthetsz értékeket.
3. /secrets a csevegésben, titkok hozzáadására vagy frissítésére kérésre.

Miért segít

Az egyértelmű módja annak, hogy kulcsot adj egy AI ügynöknek, hogy beilleszted az üzenetedbe. Ez működik, de a kulcs ekkor a csevegési előzmények része lesz, egyszerű szövegként, minden más mondatod mellett.

A titokkártya kivezeti az értéket a beszélgetésből. A kártya mezőibe írod be, nem az üzenetmezőbe, és projekt-titokként tárolódik. Az ügynök a kulccsal a sandboxban folytatja a munkát.

A kulcsok projektbeállításokban tartása kódban helyett más előnyökkel is jár:

• A kulcsok kimaradnak a forráskód-kezelésből. A kódod névvel hivatkozik a kulcsra; az érték a projektbeállításokban van.
• Az ügynök és a futó appod ugyanazt a konfigurációt látja. Nincs elavuló másolat.
• Kulcsot forgathatsz kód átírása nélkül. Megváltoztatod az értéket a beállításokban; a kód továbbra is név szerint olvassa.

Ha az env változók még újak számodra, a mik azok a környezeti változók és titkok útmutatónk a fogalmat az alapoktól magyarázza el.

Hogyan használd a titokkártyát

1. Kérd a funkciót — például: „küldj üdvözlő e-mailt, amikor valaki regisztrál”.
2. Amikor az ügynöknek kulcsra van szüksége, megjelenik a titokkérő kártya a csevegésben, felsorolva a szükséges értéket.
3. Írd be az értéket a kártya mezőibe, ne az üzenetmezőbe.
4. Erősítsd meg. Az érték projekt-titokként tárolódik.
5. Az ügynök folytatja, a kulccsal a sandboxban.

Hogyan adj hozzá titkokat magad

1. Nyisd meg a projektbeállításokat, majd a Titkok részt.
2. Adj hozzá kulcsokat, például STRIPE_SECRET_KEY, OPENAI_API_KEY, vagy a saját szolgáltatásod hitelesítő adatait.
3. Kérd meg az ügynököt, hogy a keretrendszered szokásos módján olvassa be őket — például Node-appban a process.env-ből.
4. Publikálj újra, ha egy közzétett app-nak kell az új érték.

A /secrets paranccsal a csevegésben is hozzáadhatsz vagy frissíthetsz titkokat.

Titok módosítása közzétett appon

A közzétett app a közzétételkor veszi át a titkokat. Egy titok hozzáadása vagy módosítása után publikálj újra, hogy az éles telepítés megkapja az új értéket. Addig a látogatók a régi konfigurációval használják az appot.

Biztonsági tippek

• Soha ne commitolj titkot a repositoryba. Tartsd őket a projektbeállításokban.
• Privilegizált műveletekhez szerver oldali kulcsot használj. Egy kulcs, amely kártyát terhelhet vagy e-mailt küldhet, a szerveroldali kódba tartozik, nem olyasmibe, amit a látogató böngészője letölt.
• Ha egy kulcs valaha megjelent a csevegési előzményekben, forgasd. Hozz létre új kulcsot a szolgáltatónál, vond vissza a régit, és frissítsd az értéket a projektbeállításokban. Minden kulcsot, amelyet chatbe illesztettek, kompromittáltnak tekints.

Korlátok

• A kártya csak akkor segít, ha használod. Ha mégis a üzenetmezőbe illeszted be a kulcsot, az ott van az előzményekben. Forgasd a szolgáltatónál, és frissítsd a tárolt értéket.
• A közzétett appoknak újra kell publikálni ahhoz, hogy átvegyék az új vagy módosított titkokat.
• Egy kulcs biztonságos tárolása nem teszi biztonságossá a használatát. Számít, hol használod a kulcsot — tartsd a privilegizált kulcsokat az appod szerveroldalán.

További tudnivalók az app biztonságáról megosztás előtt: biztonsági ellenőrzőlistánk AI-val épített appokhoz.

A dokumentáció részletei: Környezeti változók és titkok és Titkok a csevegésben.