본문으로 건너뛰기

AI와 함께 작업하기

이제 Android Macro 문서를 LLM에 더 친화적인 방식으로 활용할 수 있습니다.

세 가지 다른 접근 방식을 제공합니다:

  1. .md를 추가하여 모든 문서 페이지를 일반 마크다운으로 열기
  2. /llms.txt에서 엄선된 문서 인덱스 불러오기

마크다운 미러​

이제 모든 문서 경로에 마크다운 미러가 있습니다.

예시:

  • HTML 페이지: https://androidmacro.com/docs/basic/how-to-use
  • 마크다운 페이지: https://androidmacro.com/docs/basic/how-to-use.md

이 기능은 다음과 같은 경우에 유용합니다:

  • 페이지를 LLM에 붙여넣고 싶을 때
  • 에이전트가 HTML을 파싱하는 대신 정리된 문서 버전을 불러오길 원할 때
  • 프롬프트 컨텍스트용으로 안정적인 텍스트를 원할 때

llms.txt​

사이트 루트에서 llms.txt 인덱스를 제공합니다:

https://androidmacro.com/llms.txt

이 파일은 LLM 사용을 위한 문서의 엄선된 맵입니다. 가장 중요한 페이지를 먼저 안내하고, 문서의 마크다운 버전으로 연결되는 링크를 제공합니다.

관련 파일:

  • https://androidmacro.com/llms-full.txt
  • https://androidmacro.com/llms-sitemap.txt

다음과 같이 활용하세요:

  • llms.txt는 엄선된 시작점으로 사용
  • llms-full.txt는 문서 전체를 하나의 큰 파일로 내보낼 때 사용
  • llms-sitemap.txt는 마크다운 URL의 기계 친화적 목록이 필요할 때 사용

이것이 도움이 되는 이유​

HTML 문서는 사람을 위해 설계되었습니다. LLM은 일반적으로 다음과 같은 경우에 더 나은 성과를 냅니다:

  • 전체 페이지 HTML 대신 마크다운
  • 모든 경로를 무작위로 크롤링하는 대신 엄선된 인덱스

그렇기 때문에 이 설정은 두 가지를 모두 사용합니다:

  • 원시 페이지 접근을 위한 .md 미러
  • llms.txt 스타일의 검색

현재 아키텍처​

마크다운 미러와 llms.txt 파일은 Docusaurus static 출력으로 생성되므로 문서 사이트와 함께 배포됩니다.

참고​

  • 카테고리 랜딩 페이지에도 마크다운 미러가 제공됩니다(예: https://androidmacro.com/docs/reference/storage.md).
  • 생성된 마크다운은 LLM 활용을 위해 설계되었으므로 일부 인터랙티브 임베드는 짧은 참고 사항으로 대체됩니다.
  • 마크다운 미러와 llms.txt가 동기화되도록 콘텐츠 변경 후 문서 사이트를 다시 빌드하세요.

관련 페이지​