Risoluzione dei problemi
Chiamate allo strumento di verifica dei backlink fallite nel tuo assistente: una tabella dei sintomi
Gli assistenti attenuano gli errori. Questa pagina elenca ciò che vedi nella chat, ciò che è accaduto sottostante e la soluzione, partendo dai sintomi che comportano il costo maggiore.
Team di ricerca di SEO AI Pal ·

Sintomo, causa, soluzione
| Cosa mostra la chat | Cosa è accaduto | Soluzione |
|---|---|---|
| "Impossibile recuperare i dati" senza dettagli | Probabile HTTP 401. La chiave è mancante, digitata male o incollata con uno spazio finale. | Incolla di nuovo la chiave. Testa con l'azione gratuita overview da terminale. |
| Funzionava ieri, "servizio non disponibile" oggi | Probabile HTTP 402. Il saldo è arrivato a zero dopo un ciclo o una sessione prolungata. | Ricarica con USDT (TRC-20) dalla pagina dell'account. Le azioni gratuite continuano a rispondere. |
| Un punteggio di 0 o nessuna riga per un sito reale | L'indice potrebbe non contenere ancora il dominio, oppure il nome è stato inviato con un percorso o https://. | Invia il dominio nudo e crudo. Riprova il mese successivo se il sito è appena nato. |
| Il nuovo link creato è mancante | L'indice si aggiorna circa una volta al mese. | Attendi l'aggiornamento. Non eseguire la chiamata dieci volte. |
| I numeri differiscono dalla dashboard di un altro fornitore | Crawler diversi e valutazioni diverse. Il nostro DR è una metrica proprietaria. | Confronta i trend, non i valori singoli. |
| La risposta elenca molte meno righe del previsto | Lo schema ha limitato il parametro per, oppure l'assistente ha letto solo la prima pagina. | Richiedi esplicitamente page=2. |
La risposta contiene numeri ma nessun _credits | Non è stata effettuata alcuna chiamata. Il modello ha risposto basandosi sulla memoria. | Applica le regole nel manuale delle prompt runbook. |
| Addebiti superiori a quanto pianificato | L'assistente ha ritentato un'azione a pagamento o ha eseguito un ciclo su una lista. | Limita i ritenti a uno e usa il batch con bulk_dr. |
Perché il codice di stato è più importante della frase
Un assistente trasforma un 402 in un paragrago educato. Leggi il paragrafo, non il codice. Chiedi lo stato grezzo. È la diagnosi più economica a tua disposizione.
Dividi la responsabilità in due. Prima di dare la colpa al modello, esegui lo stesso URL da terminale. Se curl restituisce JSON con ok true, l'API è funzionante e il problema risiede nel wrapper o nella prompt. Se anche curl fallisce, il problema è la chiave o il saldo, e nessuna formulazione della prompt lo risolverà.
Ninety secondi di triage
- Esegui la chiamata fallita con curl e un'azione gratuita. Ritorna
ok? - Eseguila con un'azione a pagamento. Un 401 indica la chiave, un 402 il saldo.
- Stampa il dominio esattamente come l'assistente l'ha inviato. Cerca
www., percorsi e virgolette. - Verifica la data del tuo ultimo ordine rispetto all'aggiornamento mensile.
- Leggi il registro delle chiamate agli strumenti del tuo prodotto assistant, non il riepilogo.

Quando uno script si interrompe a metà
Gli script sono dove il conto cresce silenziosamente. I tre casi seguenti mostrano come un'interruzione, una catena o un errore silenzioso si trasformino in più chiamate di quanto pianificato.
Un Ctrl-C può lasciare un batch a metà
Molti script iterano su un elenco di domini e eseguono una chiamata a pagamento per ogni elemento. Premi Ctrl-C a metà. Le chiamate già eseguite vengono fatturate, le altre non avvengono mai. Il tuo file di output dovrebbe indicare quali domini sono stati completati.
Scrivi ogni risultato su disco non appena arriva. In questo modo, un riavvio può saltare i domini già completati invece di pagare per loro due volte.
La concatenazione degli script moltiplica le chiamate
Eseguire tre script e unire i loro output in un'unica email sembra ordinato. Supponi che ciascuno dei tre script esegua due chiamate a pagamento e una singola esecuzione fatturi sei. Conta prima, poi pianifica.
Un singolo script che raccoglie i dati una volta sola, poi li formatta, mantiene il conto e la logica in un unico punto. Uno script pianificato dovrebbe anche stampare il numero di chiamate alla fine, così la prossima verifica del saldo avrà un numero da confrontare.
Leggi il corpo dell'errore prima di rieseguire
Una chiamata fallita di solito restituisce comunque un corpo con ok impostato su false e un breve messaggio. Leggi prima il messaggio. Una riesecuzione con la stessa chiave e lo stesso saldo fallirà nello stesso modo.
Gli script che ingoiano il corpo e stampano solo la parola failed sprecano l'unico indizio che avevi. Stampa lo stato e il messaggio così come sono arrivati. Una parafrasi da parte dell'assistente ha già perso il dettaglio che sarebbe stato utile. Verbatim, sempre.
Errori e soluzioni nel wrapper stesso
Gli stessi tre errori si presentano nella maggior parte dei wrapper. Inserire la chiave nell'URL significa che appare nei log e nelle trascrizioni condivise, quindi usa l'intestazione bearer dove il tuo prodotto lo consente.
Esporre ogni azione è il secondo errore. Il tuo GPT ha bisogno solo di quattro di esse, e ogni azione extra è un altro modo per spendere crediti non pianificati. Il terzo è richiedere 5.000 righe quando una risposta ne usa dieci.
Risolvili una volta e la maggior parte della tabella sopra smetterà di applicarsi. I numeri errati che sopravvivono a tutto questo sono trattati nella pagina sui miti.

Configura un registro delle chiamate che mostri i fallimenti
Un log è la diagnosi più economica che tu possa mai acquistare. Non costa nulla da mantenere e trasforma una vaga lamentela sulla chat in un elenco di codici di stato che puoi contare. Bastano due abitudini.
Una riga per chiamata, con lo stato
Scrivi timestamp, azione, dominio, stato HTTP e valore _credits su una riga. Il testo normale è sufficiente. Un foglio di calcolo può leggerlo in seguito, e una colonna di stati mostra un pattern che una singola risposta della chat nasconde.
Tieni le chiamate gratuite e a pagamento in colonne separate, così un aumento degli errori a pagamento non si nasconde nel totale. Segna qualsiasi chiamata che è stata ritentata e tieni il conteggio dei ritenti accanto all'originale. 402 ripetuti nella stessa ora indicano un ciclo, non una giornata storta. Leggi prima il log. Dai la colpa al modello per ultimo.
Imposta un alert sullo stato, non sul tono
Una finestra di chat può apparire calma mentre il log mostra un 402 in ogni riga. Imposta una regola per i codici di stato che ti interessano. Tienila noiosa. Un 401 indica la chiave, un 402 il saldo, e qualsiasi altro codice indica di leggere il corpo.
Le azioni gratuite continuano a rispondere mentre quelle a pagamento falliscono è un segnale chiaro. Il saldo è la causa probabile. Ricarica e il conteggio dei ritenti vengono prima. Le azioni gratuite servono anche come controllo, poiché mostrano che il percorso funziona ancora.
Riproduci una chiamata fallita in cinque passaggi
Lavora dall'esterno verso l'interno. Ogni passaggio esclude un livello, così il problema si localizza in un unico punto.
- 1
Copia l'URL esatto
Prendi la richiesta inviata dal tuo assistente o script, byte per byte, incluso il dominio e la sua ortografia. Spazi nascosti e un
https://avventurato sono colpevoli comuni. - 2
Esegui l'azione gratuita overview
Invia lo stesso dominio a
overview, che non richiede una chiave. Se quella risponde conoktrue, il percorso e il dominio sono corretti, e il problema risiede nella chiave o nel saldo. - 3
Esegui l'azione a pagamento con la chiave
Ripeti la chiamata a pagamento con la chiave nell'intestazione, come consiglia la configurazione del GPT personalizzato. Un 401 indica la chiave, un 402 il saldo.
- 4
Confronta la prima riga
Verifica che la prima riga restituita corrisponda alla stessa chiamata eseguita da terminale. Una discrepanza significa che il wrapper ha modificato qualcosa durante il passaggio.
- 5
Scrivi il risultato
Tieni insieme lo stato, l'azione, il dominio e il valore
_credits. La prossima persona che leggerà il log saprà cosa è successo senza chiedere.
Distinguere un risultato vuoto reale da uno rotto
Due tipi di risposta sembrano simili in una finestra di chat e significano cose molto diverse. Distinguili prima. Cambiare la cosa sbagliata costa tempo e talvolta crediti.
Zero righe è una risposta
Un dominio può tornare con ok true e un elenco vuoto. Quello è un risultato sull'indice. Non un errore nella chiamata. Potrebbe essere un sito appena nato, una discrepanza di ortografia o un link che non ha ancora raggiunto l'aggiornamento mensile.
Trattalo come un risultato. Segnalo in una frase. Tieni un breve elenco di domini che sono tornati vuoti, con la data di ogni chiamata. Se lo stesso dominio rimane vuoto per un mese, l'ortografia è il prossimo sospettato, e l'aggiornamento mensile può spiegare solo fino a un certo punto.
Troppe poche righe è un'impostazione
A volte la risposta è breve perché lo schema ha limitato le righe, o perché lo script ha letto solo la prima pagina. Una chiamata viene fatturata una volta indipendentemente dal numero di righe, quindi un per più grande nella richiesta non costa crediti extra. Controlla prima il limite nel tuo schema. Inizia da lì.
Chiedi esplicitamente la pagina due e dillo nella prompt, piuttosto che sperare che l'assistente noti che ci sono altri risultati.
Risposte rapide
- Uno strumento di verifica dei backlink è uguale a un rank tracker?
- No. Legge i link: domini che rimandano, anchor text, pagine principali e un punteggio da 0 a 100. Le posizioni delle parole chiave e i crawler giornalieri appartengono ad Ahrefs o Semrush, che sono prodotti più completi per quel lavoro. Usa ciascuno dove è più forte.
- Quante righe può restituire una singola chiamata?
- Fino a 1.000 righe per chiamata, con
pageeper(da 10 a 5000) per la paginazione, e una paginazione profonda limitata a 50.000. La chiamata viene fatturata una volta indipendentemente dal numero di righe, quindi unperpiù grande non costa di più. - Perché il mio DR differisce da Ahrefs?
- La nostra valutazione è round(100 log(ref_domains+1) / log(210^7)), una scala logaritmica sui domini che rimandano. Il DR di Ahrefs è una metrica separata con il suo metodo. Simile nello spirito, mai lo stesso numero.