Налагодження
Невдачі викликів інструменту перевірки посилань у вашому асистенті: таблиця симптомів
Асистенти згладжують помилки. Ця сторінка перелічує, що ви бачите в чаті, що сталося під обкладинкою та як це виправити, починаючи з симптомів, які коштують найбільше.
Дослідницька команда 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 у запиті не коштує додаткових кредитів. Спочатку перевірте ліміт у вашій схемі. Почніть звідти.
Навмисно запитайте другу сторінку і скажіть про це в промпті, замість того щоб сподіватися, що асистент помітить, що є більше.
Швидкі відповіді
- Чи є інструмент перевірки посилань тим самим, що й трекер позицій?
- Ні. Він читає посилання: посилаючі домени, якорі, топ-сторінки та рейтинг 0-100. Позиції ключових слів та щоденні краули належать Ahrefs або Semrush, які є повнішими продуктами для цієї роботи. Використовуйте кожен там, де він сильний.
- Скільки рядків може повернути один виклик?
- До 1000 рядків за виклик, з
pageтаper(10 до 5000) для пагінації, та глибока пагінація обмежена 50 000. Виклик нараховується один раз незалежно від кількості рядків, тому більшийperне коштує більше. - Чому мій DR відрізняється від Ahrefs?
- Наш рейтинг — це round(100 log(ref_domains+1) / log(210^7)), логарифмічна шкала по посилаючим доменам. Ahrefs DR — це окрема метрика з власним методом. Подібні за духом, ніколи однакові за числом.
