Voltar às perguntas frequentes sobre Ferramentas
CENTRAL DE AJUDA · FAQFerramentas1 min de leitura

O que fazer quando uma chamada de ferramenta expira, mas pode ter sido concluída?

O tempo esgotado significa que quem chamou não recebeu o resultado a tempo; não prova que a operação falhou. Antes de tentar novamente, inspecione o estado do alvo ou consulte o identificador da operação, especialmente se repetir puder criar duplicatas ou efeitos externos.

Ferramentas

Verifique a conclusão com segurança

Se a ferramenta retornar um identificador de solicitação ou tarefa, consulte o status dessa operação em vez de reenviar o comando. Caso contrário, inspecione o recurso por uma chamada somente de leitura e compare com o estado esperado.

Para criar registros ou enviar mensagens, use uma chave de idempotência ou identidade estável quando houver suporte. Assim, a repetição se refere à mesma operação, evitando uma segunda execução.

Tente novamente com um limite claro

Se a evidência indicar que a ação não terminou, tente novamente depois de entender a causa. Se o estado for ambíguo e a ação tiver consequência, interrompa tentativas repetidas e reúna informação para não ampliar o efeito.

Registre o timeout, a identidade da operação e o estado observado. Se a ferramenta não expuser o status nem permitir repetição segura, considere essa limitação no fluxo e inclua uma verificação.

Voltar às perguntas frequentes sobre Ferramentas