Vai al contenuto
SEO AI Pal
SEO AI PalRegistrati

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 ·

Detective in argilla che ispeziona quattro serrature rotte che rappresentano diversi fallimenti nel controllo dei link

Sintomo, causa, soluzione

Gli stati sono quelli restituiti dall'API: 401 per una chiave mancante o errata, 402 quando i crediti si esauriscono.
Cosa mostra la chatCosa è accadutoSoluzione
"Impossibile recuperare i dati" senza dettagliProbabile 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" oggiProbabile 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 realeL'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 è mancanteL'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 fornitoreCrawler diversi e valutazioni diverse. Il nostro DR è una metrica proprietaria.Confronta i trend, non i valori singoli.
La risposta elenca molte meno righe del previstoLo 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 _creditsNon è stata effettuata alcuna chiamata. Il modello ha risposto basandosi sulla memoria.Applica le regole nel manuale delle prompt runbook.
Addebiti superiori a quanto pianificatoL'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.
Strada in argilla che si interrompe a metà con ghiaia sparsa e una catena intrecciata

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.

Bilancia in argilla che bilancia una piuma e una pietra con una lente d'ingrandimento su una panchina

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. 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. 2

    Esegui l'azione gratuita overview

    Invia lo stesso dominio a overview, che non richiede una chiave. Se quella risponde con ok true, il percorso e il dominio sono corretti, e il problema risiede nella chiave o nel saldo.

  3. 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. 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. 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 page e per (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 un per più 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.