Устранение неисправностей
Неудачные вызовы инструмента проверки backlink в вашем ассистенте: таблица симптомов
Ассистенты сглаживают ошибки. На этой странице перечислено, что вы видите в чате, что произошло под капотом и как это исправить, начиная с симптомов, которые обходятся дороже всего.
Исследовательская группа SEO AI Pal ·
Симптом, причина, исправление
| Что показывает чат | Что произошло | Исправление |
|---|---|---|
| "Не удалось получить данные" без подробностей | Вероятно, HTTP 401. Ключ отсутствует, в нем опечатка или он скопирован с пробелом в конце. | Снова вставьте ключ. Протестируйте с помощью бесплатного действия overview в терминале. |
| Работало вчера, сегодня «сервис недоступен» | Вероятно, HTTP 402. Баланс достиг нуля после цикла или долгой сессии. | Пополните баланс с помощью USDT (TRC-20) на странице аккаунта. Бесплатные действия все еще отвечают. |
| Рейтинг 0 или отсутствие строк для реального сайта | Индекс может еще не содержать домен, или имя было отправлено с путем или https://. | Отправляйте чистый домен. Повторите попытку в следующем месяце, если сайт совсем новый. |
| Построенная вами новая ссылка отсутствует | Индекс обновляется примерно раз в месяц. | Подождите обновления. Не запускайте вызов десять раз подряд. |
| Числа отличаются от панели управления другого поставщика | Разные краулеры и разные методы оценки. Наш DR — это отдельная метрика. | Сравнивайте тренды, а не отдельные цифры. |
| Ответ содержит гораздо меньше строк, чем ожидалось | Схема ограничила значение per, или ассистент прочитал только первую страницу. | Явно запросите page=2. |
В ответе есть числа, но нет _credits | Вызов не был выполнен. Модель ответила, опираясь на память. | Примените правила из руководства по запуску промпта. |
| Списания больше, чем вы планировали | Ассистент повторил платное действие или зациклился на списке. | Ограничьте повторные попытки одной и используйте пакетную обработку с bulk_dr. |
Почему код статуса важнее текста
Ассистент превращает 402 в вежливый абзац. Вы читаете абзац, а не код. Запросите сырой статус. Это самая дешевая диагностика, которая у вас есть.
Разделите проблему на две части. Прежде чем винить модель, запустите тот же URL в терминале. Если curl возвращает JSON с ok true, API работает исправно, и проблема в обертке или промпте. Если curl тоже падает, проблема в ключе или балансе, и никакие формулировки промпта это не исправят.
Девяносто секунд на диагностику
- Запустите падающий вызов с curl и бесплатным действием. Возвращается ли
ok? - Запустите его с платным действием. 401 указывает на ключ, 402 — на баланс.
- Выведите домен точно так же, как его отправил ассистент. Ищите
www., пути и кавычки. - Проверьте дату вашего последнего заказа относительно ежемесячного обновления.
- Читайте журнал вызовов инструмента вашего продукта ассистента, а не его сводку.
Когда скрипт останавливается на полпути
Скрипты — это место, где счет растет незаметно. Три случая ниже показывают, как остановка, цепочка или тихая ошибка превращаются в большее количество вызовов, чем вы планировали.
Ctrl-C может оставить пакет частично выполненным
Многие скрипты перебирают список доменов и делают одно платное обращение для каждого элемента. Нажмите Ctrl-C посередине. Уже выполненные обращения будут оплачены, а остальные не произойдут. Ваш выходной файл должен показывать, какие домены завершены.
Записывайте каждый результат на диск сразу по его поступлении. Тогда перезапуск сможет пропустить уже выполненные домены, вместо того чтобы платить за них дважды.
Цепочка скриптов умножает количество вызовов
Запуск трех скриптов и объединение их вывода в одно письмо выглядит аккуратно. Скажем, каждый из трех скриптов делает два платных обращения, и один запуск обходится в шесть. Считайте сначала, затем планируйте.
Один скрипт, который собирает данные один раз, а затем форматирует их, держит счет и логику в одном месте. Запланированный скрипт также должен выводить количество вызовов в конце, чтобы при следующем проверке баланса было с чем сравнить.
Прочитайте тело ошибки перед повторным запуском
Неудачный вызов обычно все еще возвращает тело с ok равным false и коротким сообщением. Сначала прочитайте сообщение. Повторный запуск с тем же ключом и тем же балансом завершится той же ошибкой.
Скрипты, которые глотают тело и выводят только слово failed, тратят единственную подсказку, которая у вас была. Цитируйте статус и сообщение такими, какие они были. Перефразирование ассистентом уже потеряло деталь, которая помогла бы. Дословно, всегда.
Ошибки и исправления в самой обертке
Те же три ошибки проявляются в большинстве оберткок. Помещение ключа в URL означает, что он появляется в логах и общих транскриптах, поэтому используйте заголовок bearer там, где позволяет ваш продукт.
Открытие всех действий — второе. Вашему GPT нужно только четыре из них, и каждое дополнительное действие — это еще один способ потратить кредиты, которые вы не планировали тратить. Третье — запрос 5000 строк, когда ответ использует десять.
Исправьте их один раз, и большая часть приведенной выше таблицы перестанет применяться. Неправильные числа, которые выживают после всего этого, описаны на странице мифов.
Настройте журнал вызовов, который показывает сбои
Журнал — самая дешевая диагностика, которую вы когда-либо купите. Его содержание ничего не стоит, и он превращает расплывчатую жалобу на чат в список кодов статуса, которые можно посчитать. Достаточно двух привычек.
Одна строка на вызов, со статусом
Записывайте метку времени, действие, домен, HTTP-статус и значение _credits в одну строку. Достаточно обычного текста. Электронная таблица может прочитать это позже, а столбец статусов покажет закономерность, которую скрывает один ответ чата.
Храните бесплатные и платные вызовы в отдельных столбцах, чтобы рост платных ошибок не терялся в общем счете. Отмечайте любой вызов, который был повторен, и сохраняйте количество повторений рядом с оригиналом. Повторяющиеся 402 в тот же час указывают на цикл, а не на плохой день. Сначала читайте журнал. Вину модели возлагайте в последнюю очередь.
Оповещайте по статусу, а не по тону
Окно чата может выглядеть спокойным, в то время как журнал показывает 402 в каждой строке. Установите правило для кодов статуса, которые вас интересуют. Сделайте его скучным. 401 означает ключ, 402 — баланс, а все остальное означает чтение тела.
Бесплатные действия все еще отвечают, в то время как платные падают — это явный сигнал. Вероятная причина — баланс. Пополнение и счетчик повторных попыток должны быть первыми шагами. Бесплатные действия также служат контролем, так как они показывают, что путь все еще работает.
Воспроизведение падающего вызова за пять шагов
Двигайтесь извне внутрь. Каждый шаг исключает один слой, так что проблема оказывается в одном месте.
- 1
Скопируйте точный URL
Возьмите запрос, который отправил ваш ассистент или скрипт, байт в байт, включая домен и его написание. Скрытые пробелы и случайный
https://— частые виновники. - 2
Запустите бесплатное действие overview
Отправьте тот же домен в
overview, которому не нужен ключ. Если он отвечает сoktrue, путь и домен в порядке, а проблема в ключе или балансе. - 3
Запустите платное действие с ключом
Повторите платный вызов с ключом в заголовке, как рекомендует настройка кастомного GPT. 401 указывает на ключ, а 402 — на баланс.
- 4
Сравните первую строку
Проверьте, что первая возвращенная строка совпадает с тем же вызовом, сделанным в терминале. Несоответствие означает, что обертка что-то изменила по пути.
- 5
Запишите результат
Храните статус, действие, домен и значение
_creditsвместе. Следующему человеку, читающему журнал, будет понятно, что произошло, без вопросов.
Отличие реального пустого результата от сломанного
Два вида ответа выглядят похоже в окне чата и означают очень разные вещи. Сначала различите их. Изменение не той вещи стоит времени и иногда кредитов.
Нулевое количество строк — это ответ
Домен может вернуться с ok true и пустым списком. Это вывод об индексе. Не ошибка в вызове. Это может быть совсем новый сайт, несоответствие в написании или ссылка, которая еще не достигла ежемесячного обновления.
Относитесь к этому как к результату. Сообщите об этом в одном предложении. Ведите короткий список доменов, которые вернулись пустыми, с датой каждого вызова. Если тот же домен остается пустым в течение месяца, следующим подозреваемым является написание, а ежемесячное обновление может объяснить не так уж много.
Слишком мало строк — это настройка
Иногда ответ короткий, потому что схема ограничила количество строк, или потому что скрипт прочитал только первую страницу. Вызов оплачивается один раз независимо от количества строк, поэтому больший per в запросе не стоит дополнительных кредитов. Сначала проверьте ограничение в вашей схеме. Начните с этого.
Целенаправленно запрашивайте вторую страницу и укажите это в промпте, а не надейтесь, что ассистент заметит, что есть больше.
Быстрые ответы
- Является ли инструмент проверки backlink тем же, что и трекер позиций?
- Нет. Он читает ссылки: реферальные домены, якоря, топ-страницы и рейтинг от 0 до 100. Позиции ключевых слов и ежедневные краулеры принадлежат Ahrefs или Semrush, которые являются более полными продуктами для этой задачи. Используйте каждый там, где он силен.
- Сколько строк может вернуть один вызов?
- До 1000 строк за вызов, с
pageиper(от 10 до 5000) для постраничной навигации, и глубокая пагинация ограничена 50000. Вызов оплачивается один раз независимо от количества строк, поэтому большийperне стоит больше. - Почему мой DR отличается от Ahrefs?
- Наш рейтинг — это round(100 log(ref_domains+1) / log(210^7)), логарифмическая шкала по реферальным доменам. DR от Ahrefs — это отдельная метрика со своим методом. Похожа по духу, но никогда не совпадает по числам.
