Fehlerbehebung

​

Gateway-Fehler behandeln

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;
}

​

Schema-Fehler behandeln

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;
}

​

Fehlgeschlagenen Lauf untersuchen

• result.run.status
• result.run.error
• status, error und modelAttempts des letzten Schritts
• requestId und nativeResponseId für den Abgleich mit Gateway-Logs

​

Häufige Prüfungen

• Stelle sicher, dass der Serverprozess auf PHASEO_API_KEY zugreifen kann.
• Weise jedem Tool eine eindeutige, stabile id zu.
• Verwende beim Freigeben, Ablehnen oder Bereitstellen manueller Ausgaben die exakten Tool-Aufruf-IDs.
• Begrenze Modell-Retries; wiederhole Validierungs- oder Freigabefehler nicht blind.
• Speichere den Status eines pausierten Laufs, bevor du die Kontrolle an einen Browser oder Queue-Worker zurückgibst.

​

Zugehörige Anleitungen

• Lifecycle-Hooks
• DevTools
• Status und Freigabe