Erros e solução de problemas

​

Tratar falhas do 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;
}

​

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

​

Inspecionar a execução malsucedida

• result.run.status
• result.run.error
• status, error e modelAttempts da etapa mais recente
• requestId e nativeResponseId para correlacionar com os logs do gateway

​

Verificações comuns

• Confirme que o processo do servidor tenha acesso a PHASEO_API_KEY.
• Atribua a cada ferramenta um id exclusivo e estável.
• Use os IDs exatos das chamadas de ferramentas ao aprovar, rejeitar ou fornecer uma saída manual.
• Limite as tentativas do modelo; não repita cegamente em caso de falhas de validação ou aprovação.
• Persista o estado da execução pausada antes de devolver o controle ao navegador ou ao worker da fila.

​

Guias relacionados

• Hooks do ciclo de vida
• DevTools
• Estado e aprovação