Hemligheter och miljövariabler utan att klistra in nycklar i chatten

De flesta riktiga appar behöver minst en hemlighet: en betalningsleverantörs nyckel, en e-posttjänsts nyckel eller en nyckel till ett AI-API. I Mythex klistrar du inte in dem i en prompt. När agenten behöver en nyckel visar den ett kort för begäran om hemlighet i chatten, du skriver värdet i kortet, och det lagras som en projekthemlighet som din app kan läsa – utan att nyckeln hamnar i konversationen.

Vad det gör

Varje Mythex-projekt kan lagra miljövariabler: namngivna värden, till exempel STRIPE_SECRET_KEY, som din app läser när den körs i stället för att de skrivs in i koden. Hemligheter är miljövariabler vars värden måste hållas privata.

Samma värden finns på två ställen:

• Sandlådan, där agenten bygger och kör din app medan du arbetar.
• Dina publiceringar, där besökare använder appen.

Det finns tre sätt att lägga till dem:

1. Kortet för begäran om hemlighet, som agenten visar i chatten när den behöver en nyckel för att slutföra något.
2. Projektinställningar → Secrets, där du när som helst kan lägga till eller redigera värden.
3. /secrets i chatten, för att lägga till eller uppdatera hemligheter på begäran.

Varför det hjälper

Det uppenbara sättet att ge en AI-agent en nyckel är att klistra in den i ditt meddelande. Det fungerar, men då blir nyckeln en del av chatthistoriken, i klartext bredvid allt annat du skrivit.

Kortet för hemligheter håller värdet utanför konversationen. Du skriver in det i kortets fält, inte i meddelanderutan, och det lagras som en projekthemlighet. Agenten fortsätter med nyckeln tillgänglig i sandlådan.

Att förvara nycklar i projektinställningarna i stället för i koden ger dessutom andra fördelar:

• Nycklar hamnar inte i källkodshanteringen. Din kod refererar till en nyckel med namn; värdet ligger i projektinställningarna.
• Agenten och din körande app ser samma konfiguration. Ingen kopia som hamnar efter.
• Du kan byta en nyckel utan att skriva om kod. Ändra värdet i inställningarna; koden läser det fortfarande med samma namn.

Om miljövariabler är nya för dig förklarar vår guide om vad miljövariabler och hemligheter är idén från grunden.

Så använder du kortet för hemligheter

1. Be om funktionen, till exempel "skicka ett välkomstmejl när någon registrerar sig".
2. När agenten behöver en nyckel visas ett kort för begäran om hemlighet i chatten, med värdet den behöver.
3. Skriv in värdet i kortets fält, inte i meddelanderutan.
4. Bekräfta. Värdet lagras som en projekthemlighet.
5. Agenten fortsätter, med nyckeln tillgänglig i sandlådan.

Så lägger du till hemligheter själv

1. Öppna projektinställningar och sedan Secrets.
2. Lägg till nycklar som STRIPE_SECRET_KEY, OPENAI_API_KEY eller dina egna tjänsters uppgifter.
3. Be agenten läsa dem på det standardsätt som ditt ramverk använder – till exempel från process.env i en Node-app.
4. Publicera igen om en publicerad app behöver de nya värdena.

Du kan också skriva /secrets i chatten för att lägga till eller uppdatera dem där.

Att ändra en hemlighet i en publicerad app

En publicerad app hämtar hemligheter när den publiceras. Efter att du lagt till eller ändrat en måste du publicera igen så att den live-versionen får det nya värdet. Tills dess använder besökare appen med den gamla konfigurationen.

Säkerhetstips

• Committa aldrig hemligheter till repositoryt. Förvara dem i projektinställningarna.
• Använd helst serverbaserade nycklar för privilegierade åtgärder. En nyckel som kan debitera kort eller skicka mejl hör hemma i kod som körs på servern, inte i något som en besökares webbläsare laddar ner.
• Om en nyckel någonsin hamnat i chatthistoriken, byt ut den. Skapa en ny nyckel hos leverantören, återkalla den gamla och uppdatera värdet i projektinställningarna. Behandla varje nyckel som klistrats in i en chatt som exponerad.

Begränsningar

• Kortet hjälper bara om du använder det. Om du ändå klistrar in en nyckel i meddelanderutan hamnar den i historiken. Byt ut den hos leverantören och uppdatera det lagrade värdet.
• Publicerade appar behöver en ny publicering för att ta emot nya eller ändrade hemligheter.
• Att lagra en nyckel säkert gör inte varje användning av den säker. Var nyckeln används spelar fortfarande roll – behåll privilegierade nycklar på serversidan av din app.

För mer om hur du håller en app säker innan du delar den, se vår säkerhetschecklista för AI-byggda appar.

Dokumentationen har detaljerna: Miljövariabler och hemligheter och Hemligheter i chatten.