අපගේ AI‑සහාය ලබා දෙන හෙල්ප්ඩෙස්ක් පද්ධතියේ API ලේඛනවල ඇති ලුහුබැඳියක් හේතුවෙන්, රොබෝ ඒජන්ට්ස් ටිකට් අංකයක් ග්රහණය කර පසුදා පූර්ණයෙන්ම අසාර්ථක වුණා. මේ ගැටලුව සොයාගෙන, ඉතා සරල නමුත් බලවත් නිවැරදි කිරීමක් කරා.
ආරම්භක වශයෙන්, create_ticket මෙවලම JSON අංකයක් ලෙස ticketId ආපසු දෙයි (උදා: {"ticketId": 47}). එත්, get_ticket_context මෙවලම ticketId ස්ට්රින්ග් එකක් ලෙස බලාපොරොත්තු වෙයි. එම නිසා AI ඒජන්ට් එකක් පළමු ප්රතිචාරයෙන් ලැබුන අංකය දෙවන මෙවලමට යවද්දී, Expected string, received number යන වැරදි පණිවිඩයක් ලැබේ.
මෙම ගැටලුව තේරුම් ගැනීමට මූලික කරුණ වන්නේ, මනුෂ්ය පරිශීලකයන් සාමාන්යයෙන් අංකය ක්ලික් කර පූර්ව-පරිවර්තනය කර ගැනීමයි. එයට විරුද්ධව, AI ඒජන්ට්ස් “ඇත්තේම” API ලේඛන පරිදි අංකය 그대로 භාවිතා කරයි. අපගේ ටෙස්ට් සූට් එකත්, අංකය String(ticket.id) ලෙස පරිවර්තනය කර තිබූ නිසා, ගැටලුව දැකගැනීමට නොහැකි වුණා.
අපි සියලුම මෙවලම් පරීක්ෂා කළා, 24 ක් අංකයක් ආපසු දෙයි, 14 ක් අංකය ස්ට්රින්ග් එකක් ලෙස ඉල්ලයි. 121 ක් පවතින මෙවලම් සම්බන්ධතා අතර 107 ක් අසාර්ථක වුණා. ඒ නිසා, “list_tickets” මගින් ලැබෙන අංකය “string” ලෙස භාවිතා කරන්න” කියන ලේඛනයේ පදයක් පවා වැරදියි.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලාංකීය සංවර්ධකයින්, සිසුන් සහ ව්යාපාරිකයින් සඳහා මෙම අවධානයෙන් ඉගෙන ගත යුතු කරුණු කිහිපයක් ඇත:
- API සැලසුම්යේ අනුකූලතාවය – ඉදිරිපත් කරන ආකාරය (output) සහ පිළිගැනීමේ ආකාරය (input) එකිනෙකට ගැලපෙන්නේ කෙසේදැයි පරීක්ෂා කිරීම අත්යවශ්ය.
- පරීක්ෂණ කේතයේ නිදසුන – ටෙස්ට් සූට් එකේ “defensive casts” (String(), Number()) පාවිච්චියෙන් වැරදි සඟවා නොගෙන, නිරවද්ය තත්වය පරීක්ෂා කිරීම.
- කොන්ට්රාක්ට් වෙනස් නොකිරීම – ප්රතිදානයේ වර්ගය (number → string) වෙනස් කිරීම පාරිභෝගිකයන්ට අහිතකර විය හැකි බැවින්, ප්රතිදානය වෙනස් නොකර, ප්රවේශය (input) පමණක් ලවණය කිරීම වඩා ආරක්ෂිත.
- z.preprocess වැනි උපකරණ භාවිතයෙන්, අංකය සුරක්ෂිත පූර්ණ සංඛ්යාවක් නම් ස්ට්රින්ග් එකට පරිවර්තනය කර, අනෙකුත් අගයන් (null, float, negative) පරණ පරික්ෂණ පණිවිඩය ලබා දීමට ඉඩ දීම.
මෙම අලුත් පරිසරය, ශ්රී ලංකාවේ AI‑චලිත සේවා, මයික්රොසේවා, හා API‑මූලික ව්යාපාර සඳහා විශ්වාසනීය සංවර්ධන පදනමක් සපයයි. ඉදිරියේදී, තවත් ව්යාපාරිකයන් මෙම “round‑trip testing” නීතිය අනුගමනය කර, පද්ධති අඩුපාඩු අඩු කර ගැනීමට හැකියාව ලැබේ.
අවසන් වශයෙන්, API ලේඛනවල වර්ග ගැටලු සලකා බලන, පරීක්ෂණ කේතය නිරවද්ය කිරීම, සහ නිවැරදි “preprocess” ක්රමය භාවිතා කිරීම, AI ඒජන්ට්ස් සමඟ වැඩ කරන සැම සංවර්ධකයෙකුටම අත්යවශ්ය පියවරයි.
