Salaisuudet ja ympäristömuuttujat ilman avainten liittämistä chattiin

Useimmat oikeat sovellukset tarvitsevat vähintään yhden salaisuuden: maksupalveluntarjoajan avaimen, sähköpostipalvelun avaimen tai avaimen tekoälyrajapintaan. Mythexissä niitä ei liitetä kehotteeseen. Kun agentti tarvitsee avaimen, se näyttää chatissa salaisuuspyyntö-kortin, sinä kirjoitat arvon kortille, ja se tallennetaan projektin salaisuutena, jota sovelluksesi voi lukea. Avain ei päädy keskusteluun.

Mitä se tekee

Jokainen Mythex-projekti voi tallentaa ympäristömuuttujia: nimettyjä arvoja, kuten STRIPE_SECRET_KEY, joita sovelluksesi lukee ajon aikana eikä niitä kirjoiteta suoraan koodiin. Salaisuudet ovat ympäristömuuttujia, joiden arvot pitää pitää yksityisinä.

Samat arvot ovat saatavilla kahdessa paikassa:

• Sandbox, jossa agentti rakentaa ja ajaa sovellustasi, kun työskentelet.
• Julkaistut käyttöönotot, joita kävijät käyttävät.

Niitä voi lisätä kolmella tavalla:

1. Salaisuuspyyntö-kortti, jonka agentti näyttää chatissa, kun se tarvitsee avaimen jonkin asian loppuun saattamiseen.
2. Projektiasetukset → Salaisuudet, joista voit lisätä tai muokata arvoja milloin tahansa.
3. /secrets chatissa, kun haluat lisätä tai päivittää salaisuuksia pyynnöstä.

Miksi tämä auttaa

Ilmeinen tapa antaa tekoälyagentille avain on liittää se viestiisi. Se toimii, mutta avain jää silloin chat-historiaan selkokielisenä tekstinä kaiken muun sanomasi viereen.

Salaisuuskortti pitää arvon poissa keskustelusta. Syötät arvon kortin kenttiin, et viestikenttään, ja se tallennetaan projektin salaisuutena. Agentti jatkaa työtään, ja avain on käytettävissä sandboxissa.

Avainten pitäminen projektiasetuksissa koodin sijaan tuo muitakin etuja:

• Avaimet pysyvät poissa versionhallinnasta. Koodi viittaa avaimeen nimellä, ja arvo on projektiasetuksissa.
• Agentti ja käynnissä oleva sovelluksesi näkevät saman asetuksen. Ei kopioita, jotka vanhenevat.
• Avaimen voi vaihtaa ilman koodin muokkaamista. Muuta arvo asetuksissa, koodi lukee edelleen samannimisen muuttujan.

Jos ympäristömuuttujat ovat sinulle uusia, oppaamme mitä ympäristömuuttujat ja salaisuudet ovat selittää idean alusta asti.

Miten salaisuuskorttia käytetään

1. Pyydä ominaisuutta, esimerkiksi "lähetä tervetuloviesti, kun joku rekisteröityy".
2. Kun agentti tarvitsee avaimen, chatiin ilmestyy salaisuuspyyntö-kortti, jossa lukee tarvittava arvo.
3. Kirjoita arvo kortin kenttiin, älä viestikenttään.
4. Vahvista. Arvo tallennetaan projektin salaisuutena.
5. Agentti jatkaa työtään avaimen ollessa käytettävissä sandboxissa.

Miten lisäät salaisuuksia itse

1. Avaa projektiasetukset ja sieltä Salaisuudet.
2. Lisää avaimia, kuten STRIPE_SECRET_KEY, OPENAI_API_KEY tai oman palvelusi tunnukset.
3. Pyydä agenttia lukemaan ne kehyksesi tavallisella tavalla, esimerkiksi process.env-muuttujasta Node-sovelluksessa.
4. Julkaise uudelleen, jos julkaistu sovellus tarvitsee uudet arvot.

Voit myös kirjoittaa chatiin /secrets lisätäksesi tai päivittääksesi salaisuuksia siellä.

Julkaistun sovelluksen salaisuuden vaihtaminen

Julkaistu sovellus ottaa salaisuudet käyttöön julkaisun yhteydessä. Kun lisäät tai muutat salaisuuden, julkaise uudelleen, jotta julkaistu käyttöönotto saa uuden arvon. Siihen asti kävijät käyttävät sovellusta vanhalla asetuksella.

Turvallisuusvinkit

• Älä koskaan tallenna salaisuuksia repositorioon. Pidä ne projektiasetuksissa.
• Käytä palvelinpuolen avaimia etuoikeutettuihin toimintoihin. Avain, joka voi veloittaa kortteja tai lähettää sähköpostia, kuuluu koodiin, joka ajetaan palvelimella, ei mihinkään, mitä kävijän selain lataa.
• Jos avain on joskus päätynyt chat-historiaan, vaihda se. Luo uusi avain palveluntarjoajalla, mitätöi vanha ja päivitä arvo projektiasetuksiin. Pidä jokaista chattiin liitettyä avainta vuotaneena.

Rajoitukset

• Kortti auttaa vain, jos käytät sitä. Jos liität avaimen silti viestikenttään, se jää keskusteluun. Vaihda se palveluntarjoajalla ja päivitä tallennettu arvo.
• Julkaistut sovellukset tarvitsevat uuden julkaisun, jotta ne saavat uudet tai muutetut salaisuudet.
• Avaimen turvallinen tallennus ei tee kaikista sen käyttötavoista turvallisia. Sillä on merkitystä, missä avainta käytetään. Pidä etuoikeutetut avaimet sovelluksesi palvelinpuolella.

Lisätietoja sovelluksen turvaamisesta ennen jakamista on turvallisuuslistassamme tekoälyllä rakennetuille sovelluksille.

Dokumentaatiossa on yksityiskohdat: Ympäristömuuttujat ja salaisuudet ja Salaisuudet chatissa.