에이전트 탐색 파일을 읽을 수 없습니다

짧은 답변

에이전트가 /.well-known/ 아래에서 찾는 파일이 응답하지만 읽을 수 없습니다. 대상은 agent-card.json(A2A 에이전트 카드), mcp.json(MCP 서버 디스크립터), api-catalog(RFC 9727), 쇼핑몰이라면 ucp입니다. 유효한 JSON이 아니거나, 에이전트 카드의 name이나 API 카탈로그의 linkset 같은 필수 필드가 없습니다.

agent.discovery_invalid · 우선순위: P2

의미

에이전트가 찾는 /.well-known/ 아래 파일(에이전트 카드, MCP 디스크립터, API 카탈로그 또는 UCP 프로필)이 응답하지만, 유효한 JSON이 아니거나 필요한 필드가 없습니다. 이 파일을 찾은 에이전트는 거기서 멈춥니다. 파일을 고치거나 삭제하세요.

AI 검색에서 중요한 이유

이 파일들은 사이트가 무엇을 제공하는지 에이전트에 알려 줍니다. 대화할 수 있는 에이전트, MCP 서버, API, 구매 방법 같은 것입니다. 파일을 찾았지만 파싱하지 못한 에이전트는 추측하지 않고 포기합니다.

대부분의 사이트에는 이 파일이 하나도 필요 없으므로, 파일이 없는 것은 보고하지 않습니다. 파일은 있는데 깨져 있다면 보통 테스트, 템플릿, 플러그인으로 만들어 두고 잊어버린 경우입니다.

수정 방법

  1. 근거에 있는 각 파일을 열어 JSON 검증기로 확인합니다.
  2. 해당 파일의 사양에 따라 문법을 고치고 필수 필드를 추가합니다.
  3. Content-Type: application/json(API 카탈로그는 application/linkset+json)으로 제공합니다.
  4. 사이트가 파일에 적힌 기능을 제공하지 않는다면 파일을 삭제합니다. 페이지 리포트에서 "다시 점검"을 실행해 결과를 확인합니다.

예시

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

수정 확인 방법

변경한 뒤 리포트에서 "다시 점검"을 누르세요. 무엇이 수정되었고 점수가 어떻게 바뀌었는지 보여 줍니다.

내 페이지 점검 →

관련 가이드

모든 발견 사항과 점수 산정 방식