Không đọc được một tệp khám phá dành cho tác tử

Trả lời ngắn

Một tệp mà tác tử tìm trong /.well-known/ có trả lời nhưng không đọc được: agent-card.json (agent card của A2A), mcp.json (mô tả máy chủ MCP), api-catalog (RFC 9727) hoặc, với cửa hàng, ucp. Tệp không phải JSON hợp lệ, hoặc thiếu một trường bắt buộc, như name của agent card hay linkset của danh mục API.

agent.discovery_invalid · Mức ưu tiên: P2

Ý nghĩa

Một tệp trong /.well-known/ mà tác tử tìm đến (agent card, mô tả MCP, danh mục API hoặc hồ sơ UCP) có trả lời, nhưng không phải JSON hợp lệ hoặc thiếu các trường cần thiết. Tác tử tìm thấy nó sẽ dừng lại ở đó. Hãy sửa tệp hoặc xóa nó.

Vì sao điều này quan trọng với tìm kiếm AI

Các tệp này cho tác tử biết site cung cấp gì: một tác tử để trò chuyện, một máy chủ MCP, một API, một cách để mua hàng. Tác tử tìm thấy một tệp nhưng không phân tích được sẽ bỏ cuộc thay vì đoán.

Phần lớn site không cần tệp nào trong số này, nên tệp thiếu không bao giờ bị báo. Tệp có mặt nhưng hỏng thường đến từ một bản thử, một template hoặc một plugin đã cài rồi bị quên.

Cách khắc phục

  1. Mở từng tệp trong bằng chứng và kiểm tra bằng một trình xác thực JSON.
  2. Sửa cú pháp và thêm các trường bắt buộc theo đặc tả của chính tệp đó.
  3. Phục vụ tệp với Content-Type: application/json (application/linkset+json cho danh mục API).
  4. Nếu site không cung cấp thứ mà tệp mô tả, hãy xóa tệp. Chạy "Kiểm tra lại" trên báo cáo trang để xác nhận kết quả.

Ví dụ

{
  "name": "Example support agent",
  "description": "Answers questions about orders",
  "url": "https://example.com/a2a",
  "version": "1.0.0",
  "skills": []
}

Cách xác nhận đã khắc phục

Sau khi thay đổi, nhấn "Kiểm tra lại" trên báo cáo: báo cáo liệt kê những gì đã khắc phục và điểm thay đổi ra sao.

Kiểm tra trang của tôi →

Hướng dẫn liên quan

Tất cả phát hiện và cách tính điểm