చాట్‌లో కీలు అతికించకుండా సీక్రెట్స్ మరియు ఎన్విరాన్‌మెంట్ వేరియబుల్స్

చాలా నిజమైన యాప్‌లకు కనీసం ఒక సీక్రెట్ అవసరం: చెల్లింపు ప్రొవైడర్ కీ, ఇమెయిల్ సర్వీస్ కీ, AI API కీ. Mythex లో వాటిని ప్రాంప్ట్‌లో అతికించాల్సిన అవసరం లేదు. ఏజెంట్‌కు కీ అవసరమైనప్పుడు, చాట్‌లో secrets request కార్డ్ చూపిస్తుంది. మీరు విలువను ఆ కార్డ్‌లో టైప్ చేస్తారు, అది మీ యాప్ చదవగల ప్రాజెక్ట్ సీక్రెట్‌గా సేవ్ అవుతుంది. ఈ విధంగా కీ సంభాషణలో చేరదు.

ఇది ఏమి చేస్తుంది

ప్రతి Mythex ప్రాజెక్ట్ ఎన్విరాన్‌మెంట్ వేరియబుల్స్ను నిల్వ చేయగలదు: STRIPE_SECRET_KEY వంటి పేరున్న విలువలు, వాటిని మీ యాప్ కోడ్‌లో రాయకుండా, అది రన్ అయినప్పుడు చదువుతుంది. సీక్రెట్స్ అంటే విలువలు ప్రైవేట్‌గా ఉండాల్సిన ఎన్విరాన్‌మెంట్ వేరియబుల్స్.

ఈ విలువలు రెండు చోట్ల అందుబాటులో ఉంటాయి:

• Sandbox, ఇక్కడ మీరు పని చేస్తున్నప్పుడు ఏజెంట్ మీ యాప్‌ను నిర్మించి రన్ చేస్తుంది.
• మీ ప్రచురించిన డిప్లాయ్‌మెంట్‌లు, ఇక్కడ విజిటర్లు యాప్‌ను ఉపయోగిస్తారు.

వీటిని జోడించడానికి మూడు మార్గాలు ఉన్నాయి:

1. Secrets request కార్డ్, ఏదైనా పూర్తి చేయడానికి కీ అవసరమైనప్పుడు ఏజెంట్ చాట్‌లో చూపిస్తుంది.
2. Project settings → Secrets, ఇక్కడ ఎప్పుడైనా విలువలను జోడించవచ్చు లేదా సవరించవచ్చు.
3. చాట్‌లో /secrets, అభ్యర్థించినప్పుడు సీక్రెట్స్‌ను జోడించడానికి లేదా అప్‌డేట్ చేయడానికి.

ఇది ఎందుకు సహాయపడుతుంది

AI ఏజెంట్‌కు కీ ఇవ్వడానికి సాధారణ మార్గం దాన్ని మీ మెసేజ్‌లో అతికించడం. అది పనిచేస్తుంది, కానీ అప్పుడు కీ మీ చాట్ హిస్టరీలో భాగమవుతుంది, మీరు చెప్పిన ప్రతిదాని పక్కన సాదా టెక్స్ట్‌లో ఉంటుంది.

Secrets కార్డ్ విలువను ట్రాన్‌స్క్రిప్ట్ బయట ఉంచుతుంది. మీరు విలువను మెసేజ్ బాక్స్‌లో కాకుండా కార్డ్ ఫీల్డ్‌లలో నమోదు చేస్తారు, అది ప్రాజెక్ట్ సీక్రెట్‌గా నిల్వ అవుతుంది. ఏజెంట్ sandbox లో కీ అందుబాటులో ఉండగానే కొనసాగుతుంది.

కోడ్‌లో కాకుండా ప్రాజెక్ట్ settings లో కీలను ఉంచడం వల్ల ఇతర లాభాలు కూడా ఉన్నాయి:

• కీలు source control లోకి వెళ్లవు. మీ కోడ్ కీని పేరుతో సూచిస్తుంది; విలువ ప్రాజెక్ట్ settings లో ఉంటుంది.
• ఏజెంట్, మీ రన్నింగ్ యాప్ ఒకే configuration ను చూస్తాయి. పాతబడిన కాపీ ఉండదు.
• కోడ్ రాయకుండానే కీని మార్చవచ్చు. Settings లో విలువను మార్చండి; కోడ్ ఇంకా పేరుతోనే చదువుతుంది.

ఎన్విరాన్‌మెంట్ వేరియబుల్స్ మీకు కొత్తగా ఉంటే, environment variables మరియు secrets అంటే ఏమిటి అనే మా గైడ్ ఆలోచనను మొదటి నుంచి వివరిస్తుంది.

Secrets కార్డ్‌ను ఎలా ఉపయోగించాలి

1. ఫీచర్ అడగండి — ఉదాహరణకు, “ఎవరైనా సైన్ అప్ చేసినప్పుడు స్వాగత ఇమెయిల్ పంపండి”.
2. ఏజెంట్‌కు కీ అవసరమైనప్పుడు, అవసరమైన విలువను జాబితా చేస్తూ చాట్‌లో secrets request కార్డ్ కనిపిస్తుంది.
3. విలువను కార్డ్ ఫీల్డ్‌లలో నమోదు చేయండి, మెసేజ్ బాక్స్‌లో కాదు.
4. నిర్ధారించండి. విలువ ప్రాజెక్ట్ సీక్రెట్‌గా సేవ్ అవుతుంది.
5. ఏజెంట్ కొనసాగుతుంది, కీ sandbox లో అందుబాటులో ఉంటుంది.

సీక్రెట్స్‌ను మీరే ఎలా జోడించాలి

1. Project settings తెరిచి, తర్వాత Secrets ఎంచుకోండి.
2. STRIPE_SECRET_KEY, OPENAI_API_KEY, లేదా మీ స్వంత సర్వీస్ credentials వంటి కీలను జోడించండి.
3. మీ ఫ్రేమ్‌వర్క్‌కు ప్రామాణిక పద్ధతిలో చదవమని ఏజెంట్‌ను అడగండి — ఉదాహరణకు Node యాప్‌లో process.env నుంచి.
4. ప్రచురించిన యాప్‌కు కొత్త విలువలు అవసరమైతే మళ్లీ ప్రచురించండి (Republish).

చాట్‌లో /secrets టైప్ చేసి కూడా వాటిని జోడించవచ్చు లేదా అప్‌డేట్ చేయవచ్చు.

ప్రచురించిన యాప్‌లో సీక్రెట్‌ను మార్చడం

ప్రచురించిన యాప్ ప్రచురణ సమయంలో సీక్రెట్స్‌ను తీసుకుంటుంది. ఒకదాన్ని జోడించిన లేదా మార్చిన తర్వాత, లైవ్ డిప్లాయ్‌మెంట్‌కు కొత్త విలువ చేరడానికి మళ్లీ ప్రచురించండి. అప్పటివరకు విజిటర్లు పాత configuration తోనే యాప్‌ను ఉపయోగిస్తారు.

భద్రతా చిట్కాలు

• సీక్రెట్స్‌ను ఎప్పుడూ repository లో commit చేయవద్దు. వాటిని ప్రాజెక్ట్ settings లో ఉంచండి.
• ప్రత్యేక కార్యకలాపాలకు server-only కీలను ఉపయోగించండి. కార్డులు ఛార్జ్ చేయగల లేదా ఇమెయిల్ పంపగల కీ సర్వర్‌పై రన్ అయ్యే కోడ్‌లో ఉండాలి, విజిటర్ బ్రౌజర్ డౌన్‌లోడ్ చేసే దేనిలోనూ కాదు.
• కీ ఎప్పుడైనా చాట్ హిస్టరీలో కనిపిస్తే, దాన్ని రొటేట్ చేయండి. ప్రొవైడర్ వద్ద కొత్త కీ సృష్టించండి, పాతదాన్ని రద్దు చేయండి, ప్రాజెక్ట్ settings లో విలువను అప్‌డేట్ చేయండి. చాట్‌లో అతికించిన ఏ కీనైనా బహిర్గతమైనదిగా పరిగణించండి.

పరిమితులు

• కార్డ్ ఉపయోగిస్తేనే సహాయపడుతుంది. మీరు కీని మెసేజ్ బాక్స్‌లో అతికిస్తే, అది ట్రాన్‌స్క్రిప్ట్‌లో ఉంటుంది. ప్రొవైడర్ వద్ద దాన్ని రొటేట్ చేసి, నిల్వ చేసిన విలువను అప్‌డేట్ చేయండి.
• ప్రచురించిన యాప్‌లు కొత్త లేదా మార్చిన సీక్రెట్స్ తీసుకోవడానికి మళ్లీ ప్రచురించాలి.
• కీని సురక్షితంగా నిల్వ చేయడం అంటే దాని ఉపయోగం సురక్షితమని కాదు. కీని ఎక్కడ ఉపయోగిస్తారో ఇంకా ముఖ్యమే — ప్రత్యేక కీలను మీ యాప్ సర్వర్ వైపు ఉంచండి.

షేర్ చేసే ముందు యాప్‌ను సురక్షితంగా ఉంచడం గురించి మరింత తెలుసుకోవడానికి, మా AI తో నిర్మించిన యాప్‌ల కోసం సెక్యూరిటీ చెక్‌లిస్ట్ చూడండి.

వివరాలు డాక్స్‌లో ఉన్నాయి: Environment variables and secrets మరియు Secrets in chat.