에이전트 탐색 파일을 읽을 수 없습니다
짧은 답변
에이전트가 /.well-known/ 아래에서 찾는 파일이 응답하지만 읽을 수 없습니다. 대상은 agent-card.json(A2A 에이전트 카드), mcp.json(MCP 서버 디스크립터), api-catalog(RFC 9727), 쇼핑몰이라면 ucp입니다. 유효한 JSON이 아니거나, 에이전트 카드의 name이나 API 카탈로그의 linkset 같은 필수 필드가 없습니다.
의미
에이전트가 찾는 /.well-known/ 아래 파일(에이전트 카드, MCP 디스크립터, API 카탈로그 또는 UCP 프로필)이 응답하지만, 유효한 JSON이 아니거나 필요한 필드가 없습니다. 이 파일을 찾은 에이전트는 거기서 멈춥니다. 파일을 고치거나 삭제하세요.
AI 검색에서 중요한 이유
이 파일들은 사이트가 무엇을 제공하는지 에이전트에 알려 줍니다. 대화할 수 있는 에이전트, MCP 서버, API, 구매 방법 같은 것입니다. 파일을 찾았지만 파싱하지 못한 에이전트는 추측하지 않고 포기합니다.
대부분의 사이트에는 이 파일이 하나도 필요 없으므로, 파일이 없는 것은 보고하지 않습니다. 파일은 있는데 깨져 있다면 보통 테스트, 템플릿, 플러그인으로 만들어 두고 잊어버린 경우입니다.
수정 방법
- 근거에 있는 각 파일을 열어 JSON 검증기로 확인합니다.
- 해당 파일의 사양에 따라 문법을 고치고 필수 필드를 추가합니다.
Content-Type: application/json(API 카탈로그는application/linkset+json)으로 제공합니다.- 사이트가 파일에 적힌 기능을 제공하지 않는다면 파일을 삭제합니다. 페이지 리포트에서 "다시 점검"을 실행해 결과를 확인합니다.
예시
{
"name": "Example support agent",
"description": "Answers questions about orders",
"url": "https://example.com/a2a",
"version": "1.0.0",
"skills": []
} 수정 확인 방법
변경한 뒤 리포트에서 "다시 점검"을 누르세요. 무엇이 수정되었고 점수가 어떻게 바뀌었는지 보여 줍니다.