मुख्य सामग्री पर जाएं
TypeScript Agent SDK से टूल इस्तेमाल करने वाला एजेंट चलाएँ और हर चरण के बाद उसकी स्थिति सहेजें, ताकि क्रैश या रीस्टार्ट हुई प्रोसेस वहीं से आगे बढ़े जहाँ रुकी थी। अंत में आपके पास एक स्क्रिप्ट होगी जो lookup टूल से दस्तावेज़ का सवाल हल करती है, हर रन को .agent-runs/<run id>.json में लिखती है, और रन ID देने पर उस रन को फिर से शुरू करती है। यह स्क्रिप्ट उदाहरण के लिए है: फ़ाइल स्टोर एक ही मशीन के लिए ठीक है। प्रोडक्शन में वही load/save जोड़ी रखें, लेकिन उसके पीछे अपना डेटाबेस लगाएँ। Phaseo आपके लिए Agent SDK रन संग्रहीत नहीं करता।

इसे बनाएँ

1

इंस्टॉल करें

@phaseo/agent-sdk अपने साथ @phaseo/sdk इंस्टॉल करता है। अपनी कुंजी सेट करें:
2

एजेंट लिखें

agent.ts
3

इसे चलाएँ

रीज़्यूम आज़माने के लिए, पहली checkpoint लाइन के बाद Ctrl+C से स्क्रिप्ट रोकें, फिर उसने जो रन ID (एक UUID) प्रिंट किया था उसे पास करें:

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

  • स्क्रिप्ट हर चरण में एक बार checkpoint प्रिंट करती है, फिर रन ID, completed, और phaseo.app/docs URL वाला जवाब।
  • .agent-runs/<run id>.json में रन ID, स्थिति, संदेश इतिहास, हर चरण के टूल कॉल और उनके नतीजे, और अंतिम आउटपुट होता है।
  • बाधित रन के बाद, रीज़्यूम कमांड नया रन शुरू करने के बजाय उसी रन ID को पूरा करता है।
  • हर मॉडल टर्न सेटिंग → उपयोग → लॉग्स में दिखता है। रन ID को हर अनुरोध ID के साथ लॉग करें ताकि आप उन्हें मिला सकें।

सहेजी गई स्थिति में क्या होता है

हर सहेजा गया नतीजा पूरा AgentRunResult होता है: run (ID, स्थिति, संदेश, उपयोग, कोई भी पॉज़), गेटवे अनुरोध ID और टूल कॉल वाले steps, और रन पूरा होने पर output। continueRun() इसे सीधे स्वीकार करता है, या runId के साथ state लेकर खुद load() कॉल करता है। प्रोसेस रुकते समय चल रही टूल कॉल का असर शायद पहले ही हो चुका हो, इसलिए टूल idempotent रखें। आगे बढ़ने से पहले SDK उस कॉल का इतिहास ठीक करता है जिसे कभी नतीजा नहीं मिला। स्थिति और अनुमोदन में पॉज़ और अनुमोदन की जानकारी है।

इसे सावधानी से बढ़ाएँ

हर वर्कफ़्लो के लिए एक एजेंट, टूल की छोटी सूची, और हर रन के लिए रन ID और अनुरोध ID वाली एक लॉग लाइन रखें। जब आपको अनुमोदन पॉज़ या एक ही टूल साझा करने वाले कई एजेंट चाहिए, तो यही गेटवे क्लाइंट और स्थिति वाली जोड़ी रखें और उनके आसपास निर्माण करें: कोड रिव्यू एजेंट अनुमोदन पॉज़ जोड़ता है, और समानांतर टूल टूल को साथ-साथ चलाता है। साझा अनुरोध डिफ़ॉल्ट के लिए तय मॉडल के बजाय प्रीसेट कॉल करें।
अंतिम संशोधन 5 नवंबर 2026