ఈమెయిల్ ఏజెంట్ల కోసం అబ్జర్వబిలిటీ (Observability for Email Agents)
మీరు ఒక ఈమెయిల్ ఏజెంట్ రియల్ టైమ్లో పని చేయడాన్ని చూడలేరు.
కానీ కేవలం ఒక API కాల్ ద్వారా అది నిన్న చేసిన ప్రతి విషయాన్ని మీరు చూడవచ్చు.
ఈమెయిల్ ఆధారంగా ఏజెంట్లను నిర్మించడం వల్ల మీకు ఇన్-బిల్ట్ అబ్జర్వబిలిటీ లభిస్తుంది. చాలా స్వయంప్రతిపత్తి కలిగిన (autonomous) వ్యవస్థలకు ట్రేసింగ్ మరియు లాగ్స్ కోసం అదనపు సాధనాలు అవసరమవుతాయి. ఈమెయిల్ ఏజెంట్కు ఇవి ఉచితంగానే లభిస్తాయి, ఎందుకంటే మెయిల్బాక్స్ అనేది ఒక రికార్డులా పనిచేస్తుంది.
మీ ఏజెంట్లను పర్యవేక్షించడానికి ఈమెయిల్ను ఎలా ఉపయోగించాలో ఇక్కడ ఉంది:
ఇన్పుట్ మానిటరింగ్ (Input Monitoring) ప్రతి ఇన్బౌండ్ మెసేజ్
message.createdఈవెంట్ను ట్రిగ్గర్ చేస్తుంది. సంభాషణను తిరిగి నిర్మించడానికి మీకు అవసరమైన థ్రెడ్ ID (thread ID) ఇది అందిస్తుంది. ఒకవేళ మెసేజ్ చాలా పెద్దదిగా ఉంటే,message.created.truncatedట్రిగ్గర్ను చూడండి. దీని ద్వారా మీరు ID ద్వారా పూర్తి బాడీని (full body) పొందవచ్చని తెలుస్తుంది.అవుట్పుట్ మానిటరింగ్ (Output Monitoring) ప్లాట్ఫారమ్ ప్రతి పంపిన మెసేజ్ గురించి రిపోర్ట్ చేస్తుంది. మీ డెలివరీ ఆరోగ్యాన్ని (delivery health) తెలుసుకోవడానికి ఈ మూడు ట్రిగ్గర్లను ట్రాక్ చేయండి: •
message.send_success: రిసీపియంట్ సర్వర్ మెయిల్ను స్వీకరించింది. •message.send_failed: ఒక రూల్ లేదా పాలసీ అవుట్బౌండ్ మెయిల్ను బ్లాక్ చేసింది. •message.bounce_detected: రిమోట్ సర్వర్ మెయిల్ను తిరస్కరించింది.
send_failed సంఖ్య పెరగడం అనేది సమస్యకు మొదటి సంకేతం. అంటే ఏదైనా రూల్ లేదా కోటా మీ ఏజెంట్ను పరిమితం (throttling) చేస్తోందని అర్థం.
స్టేట్ మానిటరింగ్ (State Monitoring) మెయిల్బాక్స్ ఫోల్డర్లు ఒక స్టేట్ మెషీన్లా పనిచేస్తాయి. • Junk ఫోల్డర్: మీ స్పామ్ ఫిల్టర్లు దేనిని పట్టుకుంటున్నాయో ఇది చూపిస్తుంది. • Drafts ఫోల్డర్: 'human-in-the-loop' డిజైన్ల కోసం ఇది ఒక అప్రూవల్ క్యూ (approval queue)లా పనిచేస్తుంది. ఒకవేళ డ్రాఫ్ట్ అక్కడ ఎక్కువ సేపు ఉంటే, మీ అప్రూవల్ ప్రక్రియ నిలిచిపోయిందని అర్థం. • Sent ఫోల్డర్: ఇది ఒక పరిపూర్ణమైన ఆడిట్ లాగ్ను (audit log) అందిస్తుంది. ఈమెయిల్ అనేది వాస్తవం కాబట్టి, ఈ లాగ్ వాస్తవానికి విరుద్ధంగా ఉండదు.
గవర్నెన్స్ మానిటరింగ్ (Governance Monitoring) ఒకవేళ ఏజెంట్ ఏదైనా మెసేజ్ను మిస్ అయితే, రూల్ ఎవాల్యుయేషన్స్ (rule evaluations) తనిఖీ చేయండి. SMTP లేయర్లో ఒక రూల్ ఎందుకు మెసేజ్ను తిరస్కరించిందో మీరు క్వెరీ చేయవచ్చు. ఇది ఊహల స్థానంలో డేటాను అందిస్తుంది.
గుర్తుంచుకోవలసిన ఒక పరిమితి: మీరు డెలివరీని ట్రాక్ చేయవచ్చు, కానీ ఈ API ద్వారా ఒక మనిషి మెసేజ్ను ఓపెన్ చేశారా లేదా లింక్ను క్లిక్ చేశారా అనేది మీరు ట్రాక్ చేయలేరు. మీరు మీ స్వంత రీజనింగ్ను (reasoning) కూడా లాగ్ చేయాలి. మెయిల్బాక్స్ ఏజెంట్ ఏమి చేసిందో చూపిస్తుంది, కానీ ఏజెంట్ ఎందుకు అలా చేయాలని నిర్ణయించుకుందో మీరు లాగ్ చేయాలి.
ఈ మూడింటిని ట్రాక్ చేయడం ద్వారా ప్రారంభించండి:
message.send_successmessage.send_failedmessage.bounce_detected
ఇన్పుట్ ఫెయిల్యూర్స్ (Input failures) స్పష్టంగా మరియు సులభంగా కనిపిస్తాయి. అవుట్పుట్ ఫెయిల్యూర్స్ (Output failures) నిశ్శబ్దంగా ఉంటాయి. ఈ సిగ్నల్స్ను ట్రాక్ చేయడం వల్ల వారాల సమయం పట్టే లోపాలను నిమిషాల్లో కనుగొనడానికి సహాయపడుతుంది.
Source: https://dev.to/qasim157/observability-for-email-agents-4egn
Optional learning community: https://t.me/GyaanSetuAi