에이전트를 위한 콘텐츠 최적화

Source: Hacker News

Overview

LLMs.txt만큼 쓸모없는 아이디어와 마찬가지입니다.
AI는 인간만큼 똑똑하기 때문에 이미 존재하는 — API를 사용할 수 있기 때문에 AI가 필요로 하지 않는 어리석은 추상화들에 불과합니다.

LLMs.txt는 실제로 쓸모가 없지만, 이 진술에서 유일하게 옳은 부분입니다. 저는 또다시 분노를 유발하는 글에 끌려와 소셜 미디어에서 나오는 무분별한 의견들을 다루고 있습니다. 이번 주제는 콘텐츠 최적화에 관한 것입니다.

짧고 핵심: 사람을 위해 최적화하듯이 에이전트를 위해서도 콘텐츠를 최적화해야 합니다. 어떻게 할지는 계속 진화하는 주제이지만, 우리가 흔히 보는 몇 가지 공통점이 있습니다:

• 콘텐츠 순서
• 콘텐츠 크기
• 노드 깊이

프론티어 모델과 그 위에 구축된 에이전트들은 모두 비슷한 제약과 최적화를 가지고 비슷하게 동작합니다. 예를 들어, 컨텍스트 부피를 줄이기 위해 파일의 일부만 읽는(첫 N 줄, 바이트, 혹은 문자) 것이 알려진 동작 중 하나입니다. 또한, 정보가 어딘가에 존재한다는 것을 알려줄 때와 스스로 찾아야 할 때의 행동 양식도 크게 다릅니다. 이러한 두 가지 고민이 바로 LLMs.txt가 가치 있는 아이디어였던 이유이지만, 구현 방식이 잘못된 것이었습니다.

오늘날 구현 방식은 간단합니다: 콘텐츠 협상. 요청에 Accept: text/markdown 헤더가 포함되면, 해당 요청이 에이전트임을 자신 있게 추정할 수 있습니다. 이것이 바로 시작점이며, 이제는 여러분이 어떻게 최적화할지 결정하면 됩니다. 아래는 Sentry에서 우리가 이를 수행하는 몇 가지 예시입니다.

문서

우리는 명백한 이유로 에이전트를 위해 문서를 최적화하는 데 많은 시간을 투자했습니다. 주요 최적화는 대부분 간단합니다:

• 실제 마크다운 콘텐츠 제공 – 토큰화 비용을 크게 절감하고 정확성을 향상시킵니다
• 브라우저 환경에서만 의미가 있는 요소, 특히 네비게이션 및 JavaScript 관련 부분을 제거합니다
• 다양한 페이지를 최적화하여 링크 계층 구조에 더 집중합니다 – 예를 들어 우리의 인덱스는 대부분 사이트맵이며, 비마크다운과는 완전히 다릅니다

curl -H "Accept: text/markdown" https://docs.sentry.io/

---
title: "Sentry Documentation"
url: https://docs.sentry.io/
---

# Sentry Documentation

Sentry is a developer‑first application monitoring platform that helps you identify and fix issues in real‑time. It provides error tracking, performance monitoring, session replay, and more across all major platforms and frameworks.

주요 기능

• 오류 모니터링: 전체 스택 트레이스, 브레드크럼 및 컨텍스트와 함께 오류를 포착하고 진단합니다
• 추적: 서비스 간 요청을 추적하여 성능 병목 현상을 식별합니다
• 세션 재생: 실제 사용자 세션을 시청하여 오류 발생 원인을 파악합니다
• 프로파일링: 느린 함수를 식별하고 애플리케이션 성능을 최적화합니다
• 크론: 예약 작업을 모니터링하고 실패를 감지합니다
• 로그: 컨텍스트 내에서 애플리케이션 로그를 수집하고 분석합니다

…

In our case we actually use MDX to render these, so it involved a handful of parsing changes and overrides to allow certain key pages to render differently. The result: agents fetch pages that are much more actionable.

Sentry

헤드리스 봇이 웹사이트를 가져오고 있다면, 가장 쓸모없는 방법은 인증이 필요한 페이지를 제공하는 것입니다. 대신, 우리는 에이전트에게 애플리케이션 정보를 프로그램적으로 접근할 수 있는 방법(MCP, CLI, API 등)을 알려줍니다:

curl -H "Accept: text/markdown" https://sentry.io

# Sentry

You've hit the web UI. It's HTML meant for humans, not machines.
Here's what you actually want:

MCP 서버 (추천)

에이전트에게 Sentry에 대한 구조화된 접근을 제공하는 가장 빠른 방법입니다.
OAuth 인증, HTTP 스트리밍, HTML 파싱이 필요 없습니다.

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

문서: https://mcp.sentry.dev

CLI

터미널에서 이슈를 조회하고 오류를 분석합니다.

https://cli.sentry.dev

…

> **Source:** https://warden.sentry.dev/

## Warden

> 코드를 검토하는 에이전트. 로컬에서 혹은 모든 PR마다.

Warden은 **스킬**을 실행하여 변경 사항을 감시합니다. 스킬은 보안 취약점, API 설계 문제, 성능 문제 등 일관된 커버리지를 제공하고 싶은 항목을 정의하는 프롬프트입니다.

스킬은 [agentskills.io](https://agentskills.io) 사양을 따릅니다. 프롬프트가 포함된 마크다운 파일이며, AI에게 무엇을 찾아야 하는지 알려줍니다. 커뮤니티 스킬을 사용하거나 직접 작성하거나 두 가지를 조합할 수 있습니다.

- Docs: https://warden.sentry.dev  
- GitHub: https://github.com/getsentry/warden  
- npm: https://www.npmjs.com/package/@sentry/warden

### How It Works

Warden을 실행할 때마다 다음을 수행합니다:

1. 변경된 내용(파일, hunks, 전체 디렉터리)을 식별합니다.  
2. 구성된 트리거와 변경 사항을 매칭합니다.  
3. 매칭된 코드에 적절한 스킬을 실행합니다.  
4. 심각도, 위치, 선택적 수정 사항과 함께 결과를 보고합니다.  

Warden은 두 가지 상황에서 동작합니다:

- **로컬** – 푸시하기 전에 변경 사항을 검토하고 즉시 피드백을 받습니다.  
- **CI** – 풀 리퀘스트를 자동으로 검토하고 결과를 코멘트로 게시합니다.  

### Quick Start

...

## 그게 전부

간단하고 작동합니다. 당신은 그것을 해야 합니다. 또한 에이전트와 함께 패턴이 어떻게 변하고 있는지 주시하고, 행동이 진화함에 따라 최적화를 업데이트하십시오.