Cloudflare, AI agent 오류 응답을 RFC 9457 Markdown·JSON으로 전환

무엇이 바뀌었나

Cloudflare는 March 11, 2026 X post에서, 이제 AI agents에게 무거운 HTML error page 대신 RFC 9457-compliant Markdown과 JSON error payload를 반환한다고 밝혔다. 같은 날 공개된 공식 blog Slashing agent token costs by 98% with RFC 9457-compliant error responses에 따르면, client가 Accept: text/markdown을 보내면 Markdown을, Accept: application/json 또는 Accept: application/problem+json을 보내면 structured JSON을 받는다.

적용 범위도 명확하다. Cloudflare는 우선 1xxx-class errors 전체에 대해 이 structured response를 live로 배포했다고 설명했다. 블로그는 이 contract가 향후 Cloudflare-generated 4xx와 5xx error로도 확대될 예정이라고 덧붙인다. 중요한 점은 site owner가 별도 설정을 하지 않아도 되고, browser는 계속 HTML을 받는 반면 agent는 명시적으로 Markdown이나 JSON을 요청할 수 있다는 구조다.

왜 이 변화가 중요한가

Cloudflare의 문제의식은 단순하다. 기존 HTML error page는 human을 위한 것이어서, agent 입장에서는 무엇이 일어났는지, retry가 가능한지, 얼마나 기다려야 하는지, owner action이 필요한지 판단하기 어렵다. 새 payload에는 error_code, error_category, retryable, retry_after, owner_action_required, ray_id 같은 field가 담기기 때문에, scraping이 아니라 control flow로 바로 연결할 수 있다.

수치도 크다. Cloudflare는 1015 rate-limit error 기준으로 HTML response가 46,645 bytes / 14,252 tokens였던 반면, Markdown은 798 bytes / 221 tokens, JSON은 970 bytes / 256 tokens라고 제시했다. 즉 size와 token 사용량이 모두 약 98% 이상 감소한다는 주장이다. multi-step agent workflow에서 오류가 여러 번 발생할수록 이 차이는 model cost와 recovery speed에 직접 영향을 준다.

실무적으로 의미하는 것

이 업데이트는 AI agent infrastructure가 "HTML을 읽어 의미를 추론하는 웹"에서 "machine-readable policy contract를 바로 처리하는 웹"로 한 걸음 이동하고 있음을 보여준다. rate-limited crawler는 retry_after를 읽고 backoff를 적용할 수 있고, WAF block을 만난 MCP tool은 재시도를 멈추고 바로 escalation할 수 있다. Cloudflare가 말하듯 error page가 더 이상 장식이 아니라 execution instruction이 되는 것이다.

출처: Cloudflare X post · Cloudflare blog