𝗢𝗯𝘀𝗲𝗿𝘃𝗮𝗯𝗶𝗹𝗶𝘁𝘆 𝗳𝗼𝗿 𝗘𝗺𝗮𝗶𝗹 𝗔𝗴𝗲𝗻𝘁𝘀

𝗢𝗯𝘀𝗲𝗿𝘃𝗮𝗯𝗶𝗹𝗶𝘁𝘆 𝗳𝗼𝗿 𝗘𝗺𝗮𝗶𝗹 𝗔𝗴𝗲𝗻𝘁𝘀

ਤੁਸੀਂ ਕਿਸੇ ਈਮੇਲ ਏਜੰਟ ਨੂੰ ਰੀਅਲ-ਟਾਈਮ ਵਿੱਚ ਕੰਮ ਕਰਦੇ ਹੋਏ ਨਹੀਂ ਦੇਖ ਸਕਦੇ।

ਪਰ ਤੁਸੀਂ ਇੱਕ API ਕਾਲ ਰਾਹੀਂ ਇਹ ਦੇਖ ਸਕਦੇ ਹੋ ਕਿ ਉਸਨੇ ਕੱਲ੍ਹ ਕੀ ਕੁਝ ਕੀਤਾ ਸੀ।

ਈਮੇਲ 'ਤੇ ਏਜੰਟ ਬਣਾਉਣ ਨਾਲ ਤੁਹਾਨੂੰ ਇਨ-ਬਿਲਟ (built-in) ਓਬਜ਼ਰਵੇਬਿਲਟੀ ਮਿਲਦੀ ਹੈ। ਜ਼ਿਆਦਾਤਰ ਆਟੋਨੋਮਸ ਸਿਸਟਮਾਂ ਨੂੰ ਟ੍ਰੇਸਿੰਗ (tracing) ਅਤੇ ਲੌਗਸ (logs) ਲਈ ਵਾਧੂ ਟੂਲਸ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ। ਇੱਕ ਈਮੇਲ ਏਜੰਟ ਨੂੰ ਇਹ ਸਭ ਮੁਫ਼ਤ ਵਿੱਚ ਮਿਲ ਜਾਂਦਾ ਹੈ ਕਿਉਂਕਿ ਮੇਲਬਾਕਸ ਹੀ ਰਿਕਾਰਡ ਹੁੰਦਾ ਹੈ।

ਇੱਥੇ ਦੱਸਿਆ ਗਿਆ ਹੈ ਕਿ ਤੁਸੀਂ ਆਪਣੇ ਏਜੰਟਾਂ ਦੀ ਨਿਗਰਾਨੀ ਕਰਨ ਲਈ ਈਮੇਲ ਦੀ ਵਰਤੋਂ ਕਿਵੇਂ ਕਰ ਸਕਦੇ ਹੋ:

• ਇਨਪੁਟ ਮਾਨੀਟਰਿੰਗ (Input Monitoring) ਹਰ ਆਉਣ ਵਾਲਾ (inbound) ਸੁਨੇਹਾ ਇੱਕ message.created ਈਵੈਂਟ ਨੂੰ ਟ੍ਰਿਗਰ ਕਰਦਾ ਹੈ। ਇਹ ਤੁਹਾਨੂੰ ਉਹ thread ID ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ ਜਿਸਦੀ ਤੁਹਾਨੂੰ ਗੱਲਬਾਤ ਨੂੰ ਦੁਬਾਰਾ ਬਣਾਉਣ ਲਈ ਲੋੜ ਹੁੰਦੀ ਹੈ। ਜੇਕਰ ਕੋਈ ਸੁਨੇਹਾ ਬਹੁਤ ਵੱਡਾ ਹੈ, ਤਾਂ message.created.truncated ਟ੍ਰਿਗਰ ਨੂੰ ਦੇਖੋ। ਇਹ ਤੁਹਾਨੂੰ ID ਰਾਹੀਂ ਪੂਰਾ ਬਾਡੀ (body) ਫੈਚ ਕਰਨ ਲਈ ਕਹਿੰਦਾ ਹੈ।

• ਆਊਟਪੁਟ ਮਾਨੀਟਰਿੰਗ (Output Monitoring) ਪਲੇਟਫਾਰਮ ਹਰ ਭੇਜੇ ਗਏ ਸੁਨੇਹੇ ਦੀ ਰਿਪੋਰਟ ਦਿੰਦਾ ਹੈ। ਆਪਣੀ ਡਿਲੀਵਰੀ ਸਿਹਤ (delivery health) ਦੇਖਣ ਲਈ ਇਹਨਾਂ ਤਿੰਨ ਟ੍ਰਿਗਰਾਂ 'ਤੇ ਨਜ਼ਰ ਰੱਖੋ: • message.send_success: ਪ੍ਰਾਪਤਕਰਤਾ ਸਰਵਰ ਨੇ ਮੇਲ ਸਵੀਕਾਰ ਕਰ ਲਈ। • message.send_failed: ਕਿਸੇ ਨਿਯਮ ਜਾਂ ਪਾਲਿਸੀ ਨੇ ਬਾਹਰੀ ਮੇਲ ਨੂੰ ਰੋਕ ਦਿੱਤਾ। • message.bounce_detected: ਰਿਮੋਟ ਸਰਵਰ ਨੇ ਮੇਲ ਨੂੰ ਰੱਦ ਕਰ ਦਿੱਤਾ।

send_failed ਦੀ ਗਿਣਤੀ ਵਿੱਚ ਵਾਧਾ ਸਮੱਸਿਆ ਦਾ ਪਹਿਲਾ ਸੰਕੇਤ ਹੈ। ਇਸਦਾ ਮਤਲਬ ਹੈ ਕਿ ਕੋਈ ਨਿਯਮ ਜਾਂ ਕੋਟਾ (quota) ਤੁਹਾਡੇ ਏਜੰਟ ਦੀ ਗਤੀ ਨੂੰ ਸੀਮਤ (throttling) ਕਰ ਰਿਹਾ ਹੈ।

• ਸਟੇਟ ਮਾਨੀਟਰਿੰਗ (State Monitoring) ਮੇਲਬਾਕਸ ਫੋਲਡਰ ਇੱਕ ਸਟੇਟ ਮਸ਼ੀਨ (state machine) ਵਜੋਂ ਕੰਮ ਕਰਦੇ ਹਨ। • ਜੰਕ (Junk) ਫੋਲਡਰ: ਇਹ ਤੁਹਾਨੂੰ ਦਿਖਾਉਂਦਾ ਹੈ ਕਿ ਤੁਹਾਡੇ ਸਪੈਮ ਫਿਲਟਰ ਕੀ ਫੜ ਰਹੇ ਹਨ। • ਡਰਾਫਟਸ (Drafts) ਫੋਲਡਰ: ਇਹ 'human-in-the-loop' ਡਿਜ਼ਾਈਨਾਂ ਲਈ ਇੱਕ ਪ੍ਰਵਾਨਗੀ ਕਿਊ (approval queue) ਵਜੋਂ ਕੰਮ ਕਰਦਾ ਹੈ। ਜੇਕਰ ਕੋਈ ਡਰਾਫਟ ਉੱਥੇ ਬਹੁਤ ਦੇਰ ਤੱਕ ਰਹਿੰਦਾ ਹੈ, ਤਾਂ ਤੁਹਾਡੀ ਪ੍ਰਵਾਨਗੀ ਪ੍ਰਕਿਰਿਆ ਰੁਕ ਗਈ ਹੈ। • ਸੈਂਟ (Sent) ਫੋਲਡਰ: ਇੱਕ ਵਧੀਆ ਆਡਿਟ ਲੌਗ (audit log) ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ। ਲੌਗ ਹਕੀਕਤ ਨਾਲ ਅਸੰਗਤ ਨਹੀਂ ਹੋ ਸਕਦਾ ਕਿਉਂਕਿ ਈਮੇਲ ਹੀ ਹਕੀਕਤ ਹੈ।

• ਗਵਰਨੈਂਸ ਮਾਨੀਟਰਿੰਗ (Governance Monitoring) ਜੇਕਰ ਕੋਈ ਏਜੰਟ ਸੁਨੇਹਾ ਮਿਸ ਕਰ ਦਿੰਦਾ ਹੈ, ਤਾਂ ਨਿਯਮਾਂ ਦੇ ਮੁਲਾਂਕਣ (rule evaluations) ਦੀ ਜਾਂਚ ਕਰੋ। ਤੁਸੀਂ SMTP ਲੇਅਰ 'ਤੇ ਇਹ ਪੁੱਛ ਸਕਦੇ ਹੋ ਕਿ ਕਿਸੇ ਨਿਯਮ ਨੇ ਸੁਨੇਹੇ ਨੂੰ ਕਿਉਂ ਰੱਦ ਕੀਤਾ। ਇਹ ਅੰਦਾਜ਼ੇ ਲਗਾਉਣ ਦੀ ਬਜਾਏ ਡੇਟਾ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ।

ਯਾਦ ਰੱਖਣ ਵਾਲੀ ਇੱਕ ਸੀਮਾ: ਤੁਸੀਂ ਡਿਲੀਵਰੀ ਨੂੰ ਟ੍ਰੈਕ ਕਰ ਸਕਦੇ ਹੋ, ਪਰ ਤੁਸੀਂ ਇਸ API ਰਾਹੀਂ ਇਹ ਟ੍ਰੈਕ ਨਹੀਂ ਕਰ ਸਕਦੇ ਕਿ ਕਿਸੇ ਇਨਸਾਨ ਨੇ ਲਿੰਕ ਖੋਲ੍ਹਿਆ ਜਾਂ ਕਲਿੱਕ ਕੀਤਾ ਹੈ। ਤੁਹਾਨੂੰ ਆਪਣੀ ਤਰਕਸ਼ੀਲਤਾ (reasoning) ਨੂੰ ਵੀ ਲੌਗ ਕਰਨ ਦੀ ਲੋੜ ਹੈ। ਮੇਲਬਾਕਸ ਦਿਖਾਉਂਦਾ ਹੈ ਕਿ ਏਜੰਟ ਨੇ ਕੀ ਕੀਤਾ, ਪਰ ਤੁਹਾਨੂੰ ਇਹ ਲੌਗ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ ਕਿ ਏਜੰਟ ਨੇ ਅਜਿਹਾ ਕਰਨ ਦਾ ਫੈਸਲਾ ਕਿਉਂ ਲਿਆ।

ਇਹਨਾਂ ਤਿੰਨਾਂ ਨੂੰ ਟ੍ਰੈਕ ਕਰਨ ਨਾਲ ਸ਼ੁਰੂਆਤ ਕਰੋ:

1. message.send_success
2. message.send_failed
3. message.bounce_detected

ਇਨਪੁਟ ਫੇਲ੍ਹ ਹੋਣਾ ਸਪੱਸ਼ਟ ਅਤੇ ਸਾਫ਼ ਹੁੰਦਾ ਹੈ। ਆਊਟਪੁਟ ਫੇਲ੍ਹ ਹੋਣਾ ਸ਼ਾਂਤ ਹੁੰਦਾ ਹੈ। ਇਹਨਾਂ ਸੰਕੇਤਾਂ ਨੂੰ ਟ੍ਰੈਕ ਕਰਨ ਨਾਲ ਤੁਹਾਨੂੰ ਹਫ਼ਤਿਆਂ ਦੀ ਬਜਾਏ ਮਿੰਟਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਲੱਭਣ ਵਿੱਚ ਮਦਦ ਮਿਲਦੀ ਹੈ।

ਸਰੋਤ: https://dev.to/qasim157/observability-for-email-agents-4egn

ਵਿਕਲਪਿਕ ਲਰਨਿੰਗ ਕਮਿਊਨਿਟੀ: https://t.me/GyaanSetuAi