Erreurs et dépannage

​

Gérer les échecs de la passerelle

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

​

Gérer les erreurs de schéma

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

​

Examiner l’exécution en échec

• result.run.status
• result.run.error
• status, error et modelAttempts de la dernière étape
• requestId et nativeResponseId pour les corréler aux journaux de la passerelle

​

Vérifications courantes

• Vérifiez que le processus serveur dispose de PHASEO_API_KEY.
• Attribuez à chaque outil un id unique et stable.
• Utilisez les ID exacts des appels d’outil pour approuver, rejeter ou fournir une sortie manuelle.
• Limitez les nouvelles tentatives du modèle ; ne réessayez pas à l’aveugle après un échec de validation ou d’approbation.
• Enregistrez l’état d’une exécution en pause avant de rendre le contrôle au navigateur ou au worker de file d’attente.

​

Guides associés

• Hooks de cycle de vie
• Outils de développement
• État et approbation