Bỏ qua để đến nội dung chính

Khắc phục sự cố

💡TL;DR
Tái hiện trên một ghi chú thử với đúng nhà cung cấp, mô hình và cài đặt. Xem nhật ký và đường dẫn kết quả. Phân biệt lỗi xác thực, sinh nội dung, phân tích và ghi tệp; thử kết nối thành công không xác minh toàn bộ quy trình.

Tổng quan​

Ghi phiên bản Notemd/Obsidian, hệ điều hành, hành động, giao thức, mô hình và các bước tối thiểu. Không bắt đầu tác vụ khác khi việc hủy chưa kết thúc. Giữ kết quả hiện có và tệp khôi phục đến khi biết tác vụ nào đã tạo chúng.

Công cụ chẩn đoán​

Thử kết nối​

Dùng Kiểm tra kết nối trong cài đặt nhà cung cấp. Một số hồ sơ chỉ thử điểm cuối danh sách mô hình trước và có thể thành công mà không gửi yêu cầu hội thoại; số khác gửi yêu cầu nhỏ. Sau đó chạy tác vụ thật nhỏ để xác minh mô hình đã chọn và hợp đồng đầu ra.

Tiến độ và chẩn đoán nhà phát triển​

Màn hình tiến độ báo trạng thái, lỗi và đích. Hoạt động API giúp phân biệt yêu cầu đang chờ với lần thử đã xong hoặc lỗi. Chỉ bật debug API khi cần. Chẩn đoán nhà cung cấp cho nhà phát triển dùng yêu cầu dài hơn, có thể tốn hạn mức; dùng khi phép thử ngắn thành công nhưng tác vụ thật thất bại.

Nội dung chẩn đoán có thể chứa ghi chú, phản hồi một phần, điểm cuối hoặc thông tin xác thực. Kiểm tra và loại bỏ bí mật cục bộ trước khi chia sẻ. Bản xuất hồ sơ đã lọc bí mật vẫn cần xem lại siêu dữ liệu.

Lỗi thường gặp​

Khóa API sai hoặc thiếu​

Với 401, xác nhận khóa thuộc đúng nhà cung cấp/điểm cuối và không có khoảng trắng thừa. Với 403, xem quyền tài khoản, giới hạn dự án, quyền dùng mô hình và thanh toán. Thử lại liên tục không sửa được thông tin xác thực sai.

Mạng hoặc kết nối​

Kiểm tra máy chủ, cổng, giao thức và tuyến mạng từ thiết bị chạy Obsidian. Ollama/LM Studio cần máy chủ hoạt động và mô hình sẵn có. localhost là chính thiết bị đó, không phải máy khác. Chọn đúng hồ sơ; chương trình tự chọn đường dự phòng, không có công tắc chuyển giao vận chung cho người dùng.

Giới hạn tốc độ 429​

Giảm đồng thời, kiểm tra hạn mức yêu cầu/token và tính cả ứng dụng khác dùng cùng khóa. Thử lại giúp một số lỗi tạm thời, không bảo đảm vượt qua mọi giới hạn tài khoản.

Không tìm thấy mô hình​

Dùng Fetch models khi có hoặc nhập mô hình/deployment tài khoản được phép dùng. Kiểm tra phiên bản API và vùng. Giá trị đặt sẵn có thể mang tính lịch sử, không chứng minh mô hình còn được cung cấp. Azure OpenAI cần tên deployment; Ark có thể cần endpoint ID.

Không có liên kết hoặc khái niệm​

Xem tệp kết quả thực tế, chất lượng nguồn, định dạng mô hình trả về và thư mục khái niệm không trống đã bật. Trích xuất độc lập mặc định chỉ có tiêu đề, không có liên kết ngược. So với lời nhắc tích hợp nếu lời nhắc riêng bỏ mất dấu bắt buộc.

Thiếu kết quả hoặc sai thư mục​

Đọc đích tác vụ báo. Thêm liên kết thường tạo _processed.md cạnh nguồn; dịch tạo _<language>.md; sinh theo tiêu đề báo complete. Nếu không tạo được thư mục dịch, kết quả có thể về thư mục nguồn. Kiểm tra xung đột và quyền tệp trước khi chạy lại.

Hủy rồi vẫn còn tệp​

Hủy dừng việc tiếp theo ở nơi hỗ trợ; lần ghi hoàn thành được giữ, không tự hoàn tác. Yêu cầu từ xa hoặc lần ghi đã được chấp nhận có thể xong sau đó. Kiểm tra kết quả từng tệp và đường khôi phục/xung đột trước khi xóa hay chạy lại cả thư mục.

Sơ đồ hoặc xuất bằng công cụ gốc thất bại​

Các loại được tạo tuần tự. Một loại lỗi không chặn các loại khác; hủy sẽ dừng loại đang chờ và giữ tệp đã hoàn tất. Thử xuất lại từ xem trước hoặc lịch sử mà không gửi yêu cầu mới đến mô hình. Lỗi tạo cần tạo lại loại đó. Bản ghi v1/v2 vẫn đọc được.

HTML sơ đồ chứa hình có thể thu phóng; HTML tóm tắt có cấu trúc chứa văn bản, cấu trúc và trích dẫn. HTML/SVG có thể chỉnh sửa là tên bộ kết xuất, không phải trình sửa trên web. Dùng nguồn gốc để chỉnh sửa. Xuất bản trình bày, gồm PPTX và MP4, có cài đặt và thư viện phụ thuộc riêng. Hướng dẫn sơ đồ.

Báo lỗi​

  1. Tái hiện bằng ghi chú tổng hợp nhỏ và thư mục riêng.
  2. Ghi phiên bản, hành động, mô hình, cài đặt cần thiết, kết quả mong đợi và thực tế.
  3. Đính kèm tiến độ/lỗi đã loại bỏ bí mật và sản phẩm nhỏ nhất chứng minh vấn đề; bỏ nội dung riêng tư và siêu dữ liệu điểm cuối không cần thiết.
  4. Nêu có tái hiện với một tệp và lời nhắc mặc định không.
  5. Mở GitHub Issues.

Ảnh chụp đơn lẻ hiếm khi chứng minh lỗi định dạng hoặc hủy. Nếu có thể, kèm cặp nguồn/kết quả hoặc chuỗi bước tối thiểu.

Tiếp theo​