الأخطاء واستكشاف المشكلات وإصلاحها

​

معالجة إخفاقات البوابة

import { AgentGatewayError } from "@phaseo/agent-sdk";

try {
  await agent.run({ input, client });
} catch (error) {
  if (error instanceof AgentGatewayError) {
    console.error(error.status, error.requestId, error.reason);
  }
  throw error;
}

​

معالجة أخطاء المخطط

import { AgentSchemaValidationError } from "@phaseo/agent-sdk";

try {
  await agent.run({ input, client });
} catch (error) {
  if (error instanceof AgentSchemaValidationError) {
    console.error(error.target, error.message);
  }
  throw error;
}

​

فحص عملية التشغيل الفاشلة

• result.run.status
• result.run.error
• status وerror وmodelAttempts الخاصة بأحدث خطوة
• requestId وnativeResponseId لمطابقتهما مع سجلات البوابة

​

عمليات التحقق الشائعة

• تأكد من إتاحة PHASEO_API_KEY لعملية الخادم.
• امنح كل أداة id فريدًا وثابتًا.
• استخدم معرّفات استدعاء الأداة الدقيقة عند الموافقة أو الرفض أو تقديم مخرجات يدوية.
• حدّد عدد محاولات النموذج؛ ولا تُعِد المحاولة عشوائيًا عند فشل التحقق أو الموافقة.
• احفظ حالة التشغيل المتوقفة مؤقتًا قبل إعادة التحكم إلى المتصفح أو عامل قائمة الانتظار.

​

أدلة ذات صلة

• خطافات دورة الحياة
• أدوات التطوير
• الحالة والموافقة