Solução de problemas
Chamadas de ferramentas de verificação de backlink falhando no seu assistente: uma tabela de sintomas
Os assistentes suavizam os erros. Esta página lista o que você vê no chat, o que aconteceu nos bastidores e a solução, começando pelos sintomas que custam mais.
Equipe de pesquisa da SEO AI Pal ·
Sintoma, causa, correção
| O que o chat mostra | O que aconteceu | Correção |
|---|---|---|
| "Não foi possível recuperar dados" sem detalhes | Provavelmente HTTP 401. A chave está ausente, digitada incorretamente ou colada com um espaço no final. | Cole novamente a chave. Teste com a ação overview gratuita em um terminal. |
| Funcionava ontem, "serviço indisponível" hoje | Provavelmente HTTP 402. O saldo chegou a zero após um loop ou uma sessão longa. | Recarregue com USDT (TRC-20) na página da conta. As ações gratuitas ainda respondem. |
| Uma classificação de 0 ou sem linhas para um site real | O índice pode não conter o domínio ainda, ou o nome foi enviado com um caminho ou https://. | Envie o domínio nu. Tente novamente no próximo mês se o site for muito novo. |
| O novo link que você construiu está faltando | O índice é atualizado aproximadamente uma vez por mês. | Aguarde a atualização. Não execute a chamada dez vezes. |
| Os números diferem do painel de outro fornecedor | Crawlers diferentes e pontuações diferentes. Nosso DR é uma métrica própria. | Compare tendências, não números isolados. |
| A resposta lista muito menos linhas do que o esperado | O esquema limitou per, ou o assistente leu apenas a primeira página. | Solicite page=2 explicitamente. |
A resposta tem números, mas sem _credits | Nenhuma chamada foi feita. O modelo respondeu de memória. | Aplique as regras em o manual de execução de prompts. |
| Cobranças maiores do que o planejado | O assistente tentou novamente uma ação paga ou iterou sobre uma lista. | Limite as tentativas a uma e agrupe com bulk_dr. |
Por que o código de status é mais importante do que a frase
Um assistente transforma um 402 em um parágrafo educado. Você lê o parágrafo, não o código. Peça o status bruto. É o diagnóstico mais barato que você tem.
Divida a falha em duas. Antes de culpar o modelo, execute a mesma URL em um terminal. Se o curl retornar JSON com ok true, a API está OK e a falha está no wrapper ou no prompt. Se o curl falhar também, a chave ou o saldo são o problema, e nenhuma redação de prompt irá corrigi-lo.
Noventa segundos de triagem
- Execute a chamada falha com curl e uma ação gratuita. O
oké retornado? - Execute com uma ação paga. Um 401 aponta para a chave, um 402 para o saldo.
- Imprima o domínio exatamente como o assistente o enviou. Procure por
www., caminhos e aspas. - Verifique a data do seu último pedido em relação à atualização mensal.
- Leia o log de chamadas de ferramentas do seu produto de assistente, não o resumo.
Quando um script para no meio do caminho
Scripts são onde a conta cresce silenciosamente. Os três casos abaixo mostram como uma parada, uma cadeia ou um erro silencioso se traduz em mais chamadas do que o planejado.
Um Ctrl-C pode deixar um lote parcialmente concluído
Muitos scripts iteram sobre uma lista de domínios e fazem uma chamada paga por item. Pressione Ctrl-C no meio. As chamadas que já foram executadas são cobradas, e as restantes nunca acontecem. Seu arquivo de saída deve indicar quais domínios foram concluídos.
Escreva cada resultado no disco assim que chegar. Assim, uma reinicialização pode pular os domínios já concluídos em vez de pagar por eles duas vezes.
Encadear scripts multiplica as chamadas
Executar três scripts e mesclar suas saídas em um único e-mail parece organizado. Digamos que cada um dos três scripts faça duas chamadas pagas, e uma única execução facture seis. Conte primeiro, depois agende.
Um único script que coleta os dados uma vez e depois os formata mantém a conta e a lógica em um só lugar. Um script agendado também deve imprimir sua contagem de chamadas no final, para que a próxima verificação do saldo tenha um número para comparar.
Leia o corpo do erro antes de executar novamente
Uma chamada falha geralmente ainda retorna um corpo com ok definido como false e uma mensagem curta. Leia a mensagem primeiro. Uma nova execução com a mesma chave e o mesmo saldo falhará da mesma forma.
Scripts que engolem o corpo e imprimem apenas a palavra falhada desperdiçam a única pista que você tinha. Cite o status e a mensagem exatamente como vieram. Uma paráfrase pelo assistente já perdeu o detalhe que teria ajudado. Verbatim, sempre.
Erros e correções no próprio wrapper
Os mesmos três erros aparecem na maioria dos wrappers. Colocar a chave na URL significa que ela aparece nos logs e em transcrições compartilhadas, então use o cabeçalho bearer onde seu produto permitir.
Expor todas as ações é a segunda. Seu GPT precisa apenas de quatro deles, e cada ação extra é outra maneira de gastar créditos que você não planejou. A terceira é solicitar 5.000 linhas quando uma resposta usa dez.
Corrija-os uma vez e a maioria da tabela acima deixa de se aplicar. Números errados que sobrevivem a tudo isso são abordados na página de mitos.
Configure um log de chamadas que mostre falhas
Um log é o diagnóstico mais barato que você vai comprar. Não custa nada manter, e transforma uma reclamação vaga sobre o chat em uma lista de códigos de status que você pode contar. Dois hábitos são suficientes.
Uma linha por chamada, com o status
Escreva o carimbo de data/hora, a ação, o domínio, o status HTTP e o valor de _credits em uma linha. Texto simples é suficiente. Uma planilha pode lê-la mais tarde, e uma coluna de status mostra um padrão que uma única resposta de chat oculta.
Mantenha as chamadas gratuitas e pagas em colunas separadas, para que um aumento em erros pagos não fique escondido no total. Marque qualquer chamada que foi reexecutada e mantenha a contagem de reexecuções ao lado da original. 402 repetidos na mesma hora apontam para um loop, não para um dia ruim. Leia o log primeiro. Culpe o modelo por último.
Alerte sobre o status, não sobre o tom
Uma janela de chat pode parecer calma enquanto o log mostra um 402 em todas as linhas. Defina uma regra para os códigos de status que importam. Mantenha-a simples. Um 401 significa a chave, um 402 significa o saldo, e qualquer outra coisa significa ler o corpo.
Ações gratuitas ainda respondendo enquanto as pagas falham é um sinal claro. O saldo é a causa provável. Recarga e contagem de reexecuções vêm primeiro. As ações gratuitas também servem como controle, pois mostram que o caminho em si ainda funciona.
Reproduza uma chamada falha em cinco etapas
Trabalhe de fora para dentro. Cada etapa elimina uma camada, então a falha termina em um só lugar.
- 1
Copie a URL exata
Pegue a solicitação que seu assistente ou script enviou, byte por byte, incluindo o domínio e sua ortografia. Espaços ocultos e um
https://solto são culpados comuns. - 2
Execute a ação gratuita de visão geral
Envie o mesmo domínio para
overview, que não precisa de chave. Se isso responder comoktrue, o caminho e o domínio estão OK, e o problema está com a chave ou o saldo. - 3
Execute a ação paga com a chave
Repita a chamada paga com a chave no cabeçalho, conforme recomendado na configuração do GPT personalizado. Um 401 aponta para a chave, e um 402 aponta para o saldo.
- 4
Compare a primeira linha
Verifique se a primeira linha retornada corresponde à mesma chamada feita em um terminal. Uma discrepância significa que o wrapper alterou algo no caminho.
- 5
Registre o resultado
Mantenha o status, a ação, o domínio e o valor de
_creditsjuntos. A próxima pessoa a ler o log saberá o que aconteceu sem perguntar.
Diferenciar um resultado vazio real de um quebrado
Dois tipos de resposta parecem iguais em uma janela de chat e significam coisas muito diferentes. Diferencie-os primeiro. Alterar a coisa errada custa tempo e às vezes créditos.
Zero linhas é uma resposta
Um domínio pode retornar com ok true e uma lista vazia. Isso é uma descoberta sobre o índice. Não uma falha na chamada. Pode ser um site muito novo, uma diferença de ortografia ou um link que ainda não alcançou a atualização mensal.
Trate-o como um resultado. Relate-o em uma frase. Mantenha uma lista curta de domínios que retornaram vazios, com a data de cada chamada. Se o mesmo domínio permanecer vazio por um mês, a ortografia é o próximo suspeito, e a atualização mensal pode explicar apenas até certo ponto.
Muitas poucas linhas é uma configuração
Às vezes, a resposta é curta porque o esquema limitou as linhas, ou porque o script leu apenas a primeira página. Uma chamada é cobrada uma vez, independentemente da contagem de linhas, então um per maior na solicitação não custa crédito extra. Verifique o limite no seu esquema primeiro. Comece por aí.
Peça a página dois de propósito e diga isso no prompt, em vez de esperar que o assistente perceba que há mais.
Respostas rápidas
- Uma ferramenta de verificação de backlink é a mesma que um rastreador de classificações?
- Não. Ela lê links: domínios de referência, âncoras, páginas principais e uma classificação de 0-100. Posições de palavras-chave e crawls diários pertencem ao Ahrefs ou Semrush, que são produtos mais completos para esse trabalho. Use cada um onde ele é forte.
- Quantas linhas uma chamada pode retornar?
- Até 1.000 linhas por chamada, com
pageeper(10 a 5000) para paginação, e paginação profunda limitada a 50.000. A chamada é cobrada uma vez, independentemente da contagem de linhas, então umpermaior não custa mais. - Por que meu DR difere do Ahrefs?
- Nossa classificação é round(100 log(ref_domains+1) / log(210^7)), uma escala logarítmica em domínios de referência. A DR do Ahrefs é uma métrica separada com seu próprio método. Semelhante em espírito, nunca o mesmo número.
