Skip to main content
जब app को तय करना हो कि retry करना है, user से अलग input माँगना है या operator को request details दिखानी हैं, तब Agent SDK structured errors उपयोग करें।

गेटवे विफलताओं को संभालें

Gateway failures को AgentGatewayError के रूप में rethrow किया जाता है:
Failed runs और steps में उपलब्ध होने पर gateway error details सुरक्षित रहते हैं।

स्कीमा विफलताओं को संभालें

AgentSchemaValidationError अमान्य टूल इनपुट/आउटपुट, प्रगति घटनाओं या अंतिम आउटपुट की पहचान करता है। इन्हें अस्थायी मॉडल विफलताओं के बजाय अनुबंध विफलताएँ मानें।

विफल रन की जाँच करें

Runtime failure को checkpoint कर सके, तो ये देखें:
  • result.run.status
  • result.run.error
  • latest step का status, error और modelAttempts
  • Gateway logs से correlate करने के लिए requestId और nativeResponseId

सामान्य जाँचें

  • Confirm करें कि server process को PHASEO_API_KEY उपलब्ध है।
  • हर tool को unique और stable id दें।
  • Approve, reject या manual output देते समय exact tool-call IDs का उपयोग करें।
  • Model retries सीमित रखें; validation और approval failures पर blindly retry न करें।
  • Browser या queue worker को control लौटाने से पहले paused run state persist करें।

संबंधित गाइड

अंतिम संशोधन 2 अक्टूबर 2026