Khắc phục sự cố
Lệnh gọi kiểm tra backlink bị lỗi trong trợ lý của bạn: bảng triệu chứng
Các trợ lý làm mượt các lỗi. Trang này liệt kê những gì bạn thấy trong cuộc trò chuyện, những gì đã xảy ra bên dưới và cách khắc phục, bắt đầu từ các triệu chứng gây tốn kém nhất.
Nhóm nghiên cứu SEO AI Pal ·

Triệu chứng, nguyên nhân, cách sửa
| Cuộc trò chuyện hiển thị gì | Điều đã xảy ra | Cách khắc phục |
|---|---|---|
| "Tôi không thể lấy dữ liệu" mà không có chi tiết | Có thể là HTTP 401. Khóa bị thiếu, gõ sai hoặc dán kèm theo khoảng trắng ở cuối. | Dán lại khóa. Kiểm tra bằng hành động overview miễn phí trong terminal. |
| Hôm qua hoạt động, hôm nay "dịch vụ không khả dụng" | Có thể là HTTP 402. Số dư đã đạt mức 0 sau một vòng lặp hoặc phiên dài. | Nạp tiền bằng USDT (TRC-20) từ trang tài khoản. Các hành động miễn phí vẫn hoạt động. |
| Xếp hạng 0 hoặc không có hàng nào cho một trang web thực | Chỉ mục có thể chưa chứa tên miền, hoặc tên miền được gửi kèm theo đường dẫn hoặc https://. | Gửi tên miền thuần. Thử lại vào tháng sau nếu trang web mới hoàn toàn. |
| Liên kết mới bạn đã xây dựng bị thiếu | Chỉ mục được làm mới khoảng một lần mỗi tháng. | Chờ đợi lần làm mới. Không chạy lại lệnh gọi mười lần. |
| Số liệu khác với bảng điều khiển của nhà cung cấp khác | Các trình thu thập dữ liệu và cách tính điểm khác nhau. DR của chúng tôi là một chỉ số riêng. | So sánh xu hướng, không phải các con số đơn lẻ. |
| Phản hồi liệt kê ít hàng hơn mong đợi | Schema đã giới hạn per, hoặc trợ lý chỉ đọc trang một. | Yêu cầu page=2 một cách rõ ràng. |
Phản hồi có số liệu nhưng không có _credits | Không có lệnh gọi nào được thực hiện. Mô hình đã trả lời từ bộ nhớ. | Áp dụng các quy tắc trong sách hướng dẫn chạy lệnh. |
| Chi phí cao hơn bạn dự kiến | Trợ lý đã thử lại một hành động trả phí, hoặc lặp qua một danh sách. | Giới hạn số lần thử lại ở một và thực hiện hàng loạt với bulk_dr. |
Tại sao mã trạng thái quan trọng hơn câu văn
Một trợ lý chuyển đổi mã 402 thành một đoạn văn lịch sự. Bạn đọc đoạn văn, không phải mã. Hãy yêu cầu mã trạng thái thô. Đó là cách chẩn đoán rẻ nhất mà bạn có.
Chia lỗi thành hai phần. Trước khi đổ lỗi cho mô hình, hãy chạy cùng URL đó trong terminal. Nếu curl trả về JSON với ok là true, API hoạt động bình thường và lỗi nằm ở lớp bọc hoặc lệnh nhắc. Nếu curl cũng thất bại, vấn đề nằm ở khóa hoặc số dư, và không có cách diễn đạt nào trong lệnh nhắc sẽ khắc phục được.
Ba mươi giây phân loại
- Chạy lệnh gọi bị lỗi với curl và một hành động miễn phí.
okcó trả về không? - Chạy nó với một hành động trả phí. Mã 401 chỉ ra khóa, mã 402 chỉ ra số dư.
- In tên miền chính xác như trợ lý đã gửi. Tìm
www., đường dẫn và dấu ngoặc kép. - Kiểm tra ngày đặt hàng cuối cùng của bạn so với lần làm mới hàng tháng.
- Đọc nhật ký lệnh gọi công cụ của sản phẩm trợ lý của bạn, không phải bản tóm tắt của nó.

Khi một tập lệnh dừng giữa chừng
Tập lệnh là nơi hóa đơn tăng lên một cách âm thầm. Ba trường hợp dưới đây cho thấy cách một lần dừng, một chuỗi hoặc một lỗi im lặng chuyển thành nhiều lệnh gọi hơn bạn dự kiến.
Ctrl-C có thể khiến một lô hàng bị dở dang
Nhiều tập lệnh lặp qua một danh sách tên miền và thực hiện một lệnh gọi trả phí cho mỗi mục. Nhấn Ctrl-C ở giữa. Các lệnh gọi đã chạy sẽ được tính phí, và phần còn lại không bao giờ xảy ra. Tập tin đầu ra của bạn nên cho biết những tên miền nào đã hoàn thành.
Ghi mỗi kết quả vào đĩa ngay khi nó đến. Sau đó, một lần khởi động lại có thể bỏ qua các tên miền đã hoàn thành thay vì trả tiền cho chúng hai lần.
Kết nối các tập lệnh nhân đôi số lệnh gọi
Chạy ba tập lệnh và hợp nhất kết quả của chúng vào một email nghe có vẻ gọn gàng. Giả sử mỗi tập lệnh trong ba tập lệnh thực hiện hai lệnh gọi trả phí, và một lần chạy duy nhất sẽ tính phí sáu lệnh gọi. Hãy đếm trước, sau đó lên lịch.
Một tập lệnh duy nhất thu thập dữ liệu một lần, sau đó định dạng nó, giữ hóa đơn và logic ở một nơi. Một tập lệnh được lên lịch cũng nên in số lệnh gọi của nó vào cuối, để lần kiểm tra số dư tiếp theo có một con số để đối chiếu.
Đọc thân lỗi trước khi chạy lại
Một lệnh gọi thất bại thường vẫn trả về một thân với ok được đặt là false và một thông báo ngắn. Hãy đọc thông báo trước. Một lần chạy lại với cùng khóa và cùng số dư sẽ thất bại theo cách tương tự.
Các tập lệnh nuốt chửng thân và chỉ in từ thất bại sẽ lãng đi manh mối quý giá nhất mà bạn có. Hãy trích dẫn mã trạng thái và thông báo chính xác như khi chúng đến. Một lời diễn giải bởi trợ lý đã mất đi chi tiết đã giúp ích. Luôn luôn nguyên văn.
Lỗi và cách sửa trong chính lớp bọc
Ba lỗi tương tự xuất hiện trong hầu hết các lớp bọc. Việc đặt khóa trong URL có nghĩa là nó xuất hiện trong nhật ký và trong các bản ghi chia sẻ, vì vậy hãy sử dụng tiêu đề bearer khi sản phẩm của bạn cho phép.
Tiếp xúc với mọi hành động là lỗi thứ hai. GPT của bạn chỉ cần bốn hành động trong số đó, và mỗi hành động bổ sung là một cách khác để tiêu tốn tín dụng mà bạn không dự định. Lỗi thứ ba là yêu cầu 5.000 hàng khi phản hồi chỉ sử dụng mười hàng.
Sửa chúng một lần và hầu hết bảng trên sẽ không còn áp dụng. Các số liệu sai sót tồn tại sau tất cả những điều đó được đề cập trong trang huyền thoại.

Thiết lập nhật ký lệnh gọi hiển thị các lỗi
Nhật ký là cách chẩn đoán rẻ nhất mà bạn sẽ từng mua. Nó không tốn gì để giữ, và nó biến một lời phàn nàn mơ hồ về cuộc trò chuyện thành một danh sách các mã trạng thái mà bạn có thể đếm. Chỉ cần hai thói quen.
Một dòng cho mỗi lệnh gọi, với trạng thái
Viết dấu thời gian, hành động, tên miền, trạng thái HTTP và giá trị _credits trên một dòng. Văn bản thuần là đủ. Một bảng tính có thể đọc nó sau này, và một cột trạng thái cho thấy một mẫu mà một phản hồi cuộc trò chuyện đơn lẻ ẩn đi.
Giữ các lệnh gọi miễn phí và trả phí trong các cột riêng biệt, để sự gia tăng lỗi trả phí không bị ẩn trong tổng số. Đánh dấu bất kỳ lệnh gọi nào đã được thử lại, và giữ số lần thử lại bên cạnh lệnh gọi gốc. Các mã 402 lặp lại trong cùng một giờ chỉ ra một vòng lặp, không phải một ngày xấu. Đọc nhật ký trước. Đổ lỗi cho mô hình sau cùng.
Cảnh báo dựa trên trạng thái, không phải giọng điệu
Một cửa sổ trò chuyện có thể đọc bình tĩnh trong khi nhật ký hiển thị mã 402 trong mọi hàng. Đặt một quy tắc cho các mã trạng thái bạn quan tâm. Giữ nó đơn giản. Mã 401 có nghĩa là khóa, mã 402 có nghĩa là số dư, và bất kỳ điều gì khác có nghĩa là đọc thân.
Các hành động miễn phí vẫn trả lời trong khi các hành động trả phí thất bại là một tín hiệu rõ ràng. Số dư là nguyên nhân có thể xảy ra. Nạp tiền và đếm số lần thử lại là ưu tiên hàng đầu. Các hành động miễn phí cũng đóng vai trò là một kiểm soát, vì chúng cho thấy rằng đường dẫn vẫn hoạt động.
Tái tạo một lệnh gọi bị lỗi trong năm bước
Làm việc từ ngoài vào trong. Mỗi bước loại trừ một lớp, vì vậy lỗi cuối cùng nằm ở một nơi.
- 1
Sao chép chính xác URL
Sao chép yêu cầu mà trợ lý hoặc tập lệnh của bạn đã gửi, từng byte một, bao gồm tên miền và cách đánh vần của nó. Các khoảng trắng ẩn và
https://lạc chỗ là những nguyên nhân phổ biến. - 2
Chạy hành động overview miễn phí
Gửi cùng tên miền đó đến
overview, hành động này không cần khóa. Nếu hành động đó trả vềoklà true, đường dẫn và tên miền đều ổn, và vấn đề nằm ở khóa hoặc số dư. - 3
Chạy hành động trả phí với khóa
Lặp lại lệnh gọi trả phí với khóa trong tiêu đề, như cài đặt GPT tùy chỉnh khuyến nghị. Mã 401 chỉ ra khóa, và mã 402 chỉ ra số dư.
- 4
So sánh hàng đầu tiên
Kiểm tra xem hàng đầu tiên được trả về có khớp với cùng lệnh gọi được thực hiện trong terminal hay không. Một sự không khớp có nghĩa là lớp bọc đã thay đổi điều gì đó trên đường đi.
- 5
Ghi lại kết quả
Giữ trạng thái, hành động, tên miền và giá trị
_creditslại với nhau. Người đọc nhật ký tiếp theo sẽ biết những gì đã xảy ra mà không cần hỏi.
Phân biệt kết quả trống thực sự với kết quả bị lỗi
Hai loại phản hồi trông giống nhau trong cửa sổ trò chuyện và có nghĩa rất khác nhau. Hãy phân biệt chúng trước. Thay đổi sai thứ gì đó sẽ tốn thời gian và đôi khi là tín dụng.
Không có hàng nào là một câu trả lời
Một tên miền có thể trả về ok là true và một danh sách trống. Đó là một phát hiện về chỉ mục. Không phải lỗi trong lệnh gọi. Nó có thể là một trang web mới, một sự không khớp về chính tả hoặc một liên kết chưa đạt đến lần làm mới hàng tháng.
Xử lý nó như một kết quả. Báo cáo nó trong một câu. Giữ một danh sách ngắn các tên miền trả về trống, với ngày của mỗi lệnh gọi. Nếu cùng một tên miền vẫn trống trong một tháng, chính tả là nghi phạm tiếp theo, và lần làm mới hàng tháng chỉ có thể giải thích được một phần.
Quá ít hàng là một cài đặt
Đôi khi phản hồi ngắn vì schema đã giới hạn số hàng, hoặc vì tập lệnh chỉ đọc trang một. Một lệnh gọi được tính phí một lần bất kể số lượng hàng, vì vậy một giá trị per lớn hơn trong yêu cầu không tốn thêm tín dụng. Hãy kiểm tra giới hạn trong schema của bạn trước. Bắt đầu từ đó.
Yêu cầu trang hai một cách có chủ đích, và nói rõ điều đó trong lệnh nhắc, thay vì hy vọng trợ lý nhận ra rằng còn nhiều hơn nữa.
Câu trả lời nhanh
- Công cụ kiểm tra backlink có giống như công cụ theo dõi xếp hạng không?
- Không. Nó đọc các liên kết: tên miền giới thiệu, neo, các trang hàng đầu và xếp hạng 0-100. Vị trí từ khóa và các lần thu thập dữ liệu hàng ngày thuộc về Ahrefs hoặc Semrush, những sản phẩm đầy đủ hơn cho công việc đó. Hãy sử dụng từng công cụ ở nơi nó mạnh.
- Một lệnh gọi có thể trả về bao nhiêu hàng?
- Tối đa 1.000 hàng mỗi lệnh gọi, với
pagevàper(10 đến 5000) để phân trang, và phân trang sâu được giới hạn ở 50.000. Lệnh gọi được tính phí một lần bất kể số lượng hàng, vì vậy một giá trịperlớn hơn không tốn thêm chi phí. - Tại sao DR của tôi khác với Ahrefs?
- Xếp hạng của chúng tôi là round(100 log(ref_domains+1) / log(210^7)), một thang logarit trên các tên miền giới thiệu. DR của Ahrefs là một chỉ số riêng biệt với phương pháp riêng. Tương tự về tinh thần, nhưng không bao giờ là cùng một con số.