𝗗𝗲𝘃 𝗟𝗼𝗴: 𝗠𝗖𝗣, 𝗘𝗺𝗮𝗶𝗹 𝗧𝗿𝗮𝗰𝗸𝗶𝗻𝗴, 𝗮𝗻𝗱 𝗠𝗲𝗻𝘂 𝗦𝘁𝗿𝘂𝗰𝘁𝘂𝗿𝗲

મેં આખો દિવસ MCP સર્વર્સ, ઓટોમેટેડ ઈમેલ ટ્રેકિંગ અને સ્કેલેબલ એડમિન મેનુ બનાવવા પાછળ વિતાવ્યો.

અહીં આ કામમાંથી મળેલા મુખ્ય પાઠ છે.

𝗠𝗖𝗣 𝗦𝗲𝗿𝘃𝗲𝗿 𝗦𝗮𝗳𝗲𝘁𝘆

મેં એક જનરિક MCP ટૂલબોક્સ તૈયાર કર્યું અને ઘણા એન્ટરપ્રાઇઝ એપ્સમાં સર્વર્સ તૈનાત કર્યા. જ્યારે તમે એવા એજન્ટ્સ બનાવો છો જે તમારી સિસ્ટમ સાથે વાતચીત કરી શકે, ત્યારે આ નિયમોનું પાલન કરો:

  • એજન્ટ્સને 'read' ટૂલ્સ મુક્તપણે આપો.
  • 'write' ટૂલ્સ મર્યાદિત પ્રમાણમાં આપો.
  • દરેક 'write' એક્શનને માનવ-નિયંત્રિત (human-gated) રનબુક દ્વારા જ ફરજિયાત બનાવો.
  • તમારા 'create-user' ટૂલ્સમાં પાસવર્ડને હેશ (hash) કરો. ક્યારેય પ્લેનટેક્સ્ટ (plaintext) સ્ટોર ન કરો.
  • ઓડિટ લોગ્સ માટે પબ્લિક UUIDs નો ઉપયોગ કરો. ક્યારેય ઇન્ટરનલ ડેટાબેઝ ID લીક ન કરો.
  • યુઝર કોન્ટેક્સ્ટ માટે ફોલબેક (fallback) નો ઉપયોગ કરો. એજન્ટ HTTP અથવા STDIO નો ઉપયોગ કરી શકે છે. ખાતરી કરો કે તમારો કોડ બંનેને હેન્ડલ કરે છે.

𝗘𝗺𝗮𝗶𝗹 𝗧𝗿𝗮𝗰𝗸𝗶𝗻𝗴 𝗪𝗶𝘁𝗵𝗼𝘂𝘁 𝗠𝗮𝗻𝘂𝗮𝗹 𝗪𝗼𝗿𝗸

મેં એક એવી સિસ્ટમ બનાવી છે જે ઈમેલ ઓપન અને ક્લિક્સને આપમેળે ટ્રેક કરે છે. ડેવલપર્સને દરેક ઈમેલમાં ટ્રેકિંગ પિક્સેલ્સ ઉમેરવા માટે મજબૂર ન કરો. તેના બદલે, મેઈલ-સેન્ડિંગ લિસનર (mail-sending listener) નો ઉપયોગ કરો.

  • લિસનર મેસેજને ઇન્ટરસેપ્ટ (intercept) કરે છે.
  • તે HTML માં ટ્રેકિંગ પિક્સેલ ઇન્જેક્ટ કરે છે.
  • તે ક્લિક ટ્રેકિંગ માટે તમામ લિંક્સને રેપ (wrap) કરે છે.
  • તે સરળ કોરિલેશન માટે મેટાડેટા હેશ ઉમેરે છે.

બે મહત્વની નોંધો:

  • Mail::raw() ટાળો. તે HTML રીરાઈટિંગ પાથને સ્કીપ કરે છે. ટ્રેકિંગ કામ કરે તેની ખાતરી કરવા માટે યોગ્ય HTML Mailables નો ઉપયોગ કરો.
  • ટ્રેકિંગને ડિફોલ્ટ રીતે "on" રાખો. જો યુઝર્સને તેને સક્ષમ (enable) કરવું પડશે, તો તેઓ ભૂલી જશે.

𝗦𝗰𝗮𝗹𝗮𝗯𝗹𝗲 𝗔𝗱𝗺𝗶𝗻 𝗠𝗲𝗻𝘂𝘀

જ્યારે તમે મલ્ટીપલ એપ્સમાં મેનુ મેનેજ કરો છો, ત્યારે એક વિશાળ ફાઇલનો ઉપયોગ ન કરો. દરેક ગ્રુપ માટે નાની બિલ્ડર ક્લાસનો ઉપયોગ કરો.

  • દરેક ગ્રુપ માટે એક ક્લાસ બનાવો (દા.ત., Settings, User Management).
  • દરેક ક્લાસ તેના પોતાના આઇટમ્સ અને જરૂરી પરમિશન જાહેર કરે છે.
  • આ તમારા નેવિગેશનને ડિકલેરેટિવ (declarative) રાખે છે.
  • લાંબા લેબલ્સને કમ્પોનન્ટની અંદર ટ્રંકેટ (truncate) કરો, દરેક આઇટમ દીઠ નહીં.
  • ટૂલ્સને બે ચેક પાછળ સુરક્ષિત કરો: યુઝર પરમિશન અને ચોક્કસ એપ એડિશન.

𝗧𝗵𝗲 𝗕𝗶𝗴𝗴𝗲𝗿 𝗣𝗶𝗰𝘁𝘂𝗿𝗲

ધ્યેય સેફ્