Errores y solución de problemas

​

Gestionar fallos del gateway

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

​

Gestionar errores de esquema

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

​

Inspeccionar la ejecución fallida

• result.run.status
• result.run.error
• status, error y modelAttempts del paso más reciente
• requestId y nativeResponseId para correlacionarlos con los registros del gateway

​

Comprobaciones habituales

• Confirma que el proceso del servidor tenga acceso a PHASEO_API_KEY.
• Asigna a cada herramienta un id único y estable.
• Usa los ID exactos de llamada a herramienta al aprobar, rechazar o proporcionar una salida manual.
• Limita los reintentos del modelo; no reintentes a ciegas ante fallos de validación o aprobación.
• Guarda el estado de una ejecución pausada antes de devolver el control al navegador o al trabajador de cola.

​

Guías relacionadas

• Hooks del ciclo de vida
• DevTools
• Estado y aprobación