मुख्य सामग्री पर जाएं
एक TypeScript एजेंट बनाएँ जो स्थानीय टूल से pull request की जाँच करे, सख्त JSON रिव्यू प्लान लौटाए, और जब प्लान कहे कि अनुमोदन चाहिए, तब किसी व्यक्ति के लिए रुक जाए। अंत में आपके पास एक स्क्रिप्ट होगी जो सत्यापित CodeReviewPlan प्रिंट करती है और किसी के अनुमोदन तक waiting_for_human पर रुकी रहती है। टूल तय नमूना डेटा लौटाते हैं, इसलिए यह स्क्रिप्ट उदाहरण के लिए है; इन्हें अपने कोड होस्ट और CI की कॉल से बदलें। पैकेज किया गया संस्करण packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts में है।

इसे बनाएँ

1

इंस्टॉल करें

2

एजेंट लिखें

review-agent.ts
responseFormat से Gateway यही स्कीमा माँगता है, और outputSchema आपकी प्रोसेस में पार्स किए गए नतीजे को फिर से जाँचता है। सख्त response healing मोड सिर्फ़ उसी JSON को खोलता है जो पहले से वैध है।
3

इसे चलाएँ

जाँचें कि यह काम किया

  • इवेंट लॉग में दोनों टूल के लिए tool.started और tool.completed दिखते हैं, फिर टूल चरण के बाद checkpoint.saved।
  • needsApproval: true वाला प्लान पहले रन को waiting_for_human पर रोकता है, और प्लान result.run.pause.payload में होता है; APPROVE=yes के साथ रन completed तक जारी रहता है।
  • सेटिंग → उपयोग → लॉग्स में हर मॉडल टर्न के टूल कॉल दिखते हैं, और अनुरोध का प्लगइन रिकॉर्ड बताता है कि healing चली या नहीं।
  • स्कीमा तोड़ने वाला प्लान गलत डेटा लौटाने के बजाय रन को AgentSchemaValidationError के साथ विफल कर देता है।

असली रिपॉज़िटरी के लिए इसे सुरक्षित बनाएँ

रिव्यू टूल सिर्फ़ पढ़ने वाले रखें। अगर आप ऐसा टूल जोड़ते हैं जो टिप्पणी करे, push करे या merge करे, तो उस पर requireApproval: true सेट करें ताकि उसके चलने से पहले रन रुक जाए, और उसे continueRun({ run, client, approvals: [toolCallId] }) से अनुमोदित करें। diff की सामग्री को अविश्वसनीय इनपुट मानें: कोड टिप्पणियों में मॉडल के लिए लिखे निर्देश हो सकते हैं। रिव्यू के इंतज़ार के दौरान रीस्टार्ट से बचे रहने के लिए, टिकाऊ लूप की तरह state एक्सेसर से रन सहेजें। स्थिति और अनुमोदन में अनुमोदन और अस्वीकृति की जानकारी है।
अंतिम संशोधन 5 नवंबर 2026