AI 에이전트 통합
이 문서는 사람뿐 아니라 AI 에이전트, LLM 기반 도구, 개발자 어시스턴트도 읽을 수 있도록 만들어졌습니다. 이를 가능하게 하는 리소스는 세 가지입니다:
- 모든 페이지의 일반 Markdown 버전.
- 사이트 전체를 매핑하는 언어별
llms.txt인덱스. - 한 번의 클릭으로 페이지를 어시스턴트에 보내는, 각 페이지 상단의 작업 바.
각 페이지의 Markdown 버전
브라우저 또는 HTTP 클라이언트에서 페이지 URL 끝에 .md를 추가하세요:
| 페이지 URL | Markdown URL |
|---|---|
/developers/api-reference/post-processes | /developers/api-reference/post-processes.md |
/products/sign-up/multi-accounts | /products/sign-up/multi-accounts.md |
/capabilities/liveness | /capabilities/liveness.md |
/pt-BR/capabilities/liveness | /pt-BR/capabilities/liveness.md |
응답은 내비게이션, 사이드바, HTML 래퍼가 없는 페이지의 Markdown 콘텐츠입니다. 각 언어에는 페이지와 같은 언어 접두사 아래에 자체 Markdown 버전이 있습니다.
llms.txt 인덱스
각 언어에는 llms.txt 형식의 llms.txt 파일이 있습니다:
| 언어 | 인덱스 URL |
|---|---|
| 영어 | /llms.txt |
| 포르투갈어(브라질) | /pt-BR/llms.txt |
| 스페인어 | /es/llms.txt |
다른 모든 언어도 같은 패턴을 따릅니다: 해당 언어 페이지의 언어 접두사 뒤에 /llms.txt가 붙습니다.
이 파일은 사이트의 내비게이션을 그대로 반영합니다:
- 상단 내비게이션 바의 탭마다 하나의 섹션. 그 뒤에 Dual API 탭이 이어지며, 각 탭 이름 뒤에
(Dual API)가 붙습니다. - 각 탭의 사이드바를 사이트와 같은 순서의 중첩 목록으로 표시.
- 각 페이지의 Markdown 버전 링크와, 페이지에 설명이 있으면 그 설명.
에이전트는 독자 언어의 llms.txt부터 읽어 문서의 구성을 파악할 수 있습니다. 그런 다음 필요한 Markdown 페이지만 엽니다.
페이지 작업
홈 페이지를 제외한 모든 문서 페이지의 제목 아래에는 작업 바가 있습니다:
- 페이지 복사 — 페이지의 Markdown을 클립보드에 복사합니다.
- Markdown — 페이지의 Markdown 버전을 새 탭에서 엽니다.
- 다음에서 열기 — ChatGPT, Claude, Gemini, Perplexity, Grok, Copilot 중 하나의 AI 어시스턴트에서 페이지를 엽니다. 어시스턴트는 페이지의 Markdown URL이 담긴 프롬프트를 받습니다. Gemini와 Copilot의 경우 프롬프트가 클립보드에 복사되며, 사용자가 채팅에 붙여 넣습니다.
- Markdown URL 복사 — Markdown 버전의 절대 URL을 복사하여 Cursor, Codex, Claude Code 같은 코딩 에이전트에 붙여 넣을 수 있게 합니다.
데스크톱에서는 페이지 복사, Markdown, ChatGPT, Claude가 바의 버튼이고, 나머지 작업은 더보기에 있습니다. 모바일에서는 나머지 작업이 페이지 복사 옆 화살표로 여는 메뉴에 있습니다.
자동 검색
모든 페이지의 HTML은 <head>에 두 리소스를 선언하므로, 어떤 페이지를 방문한 에이전트든 별도의 안내 없이 이를 찾을 수 있습니다:
<link rel="alternate" type="text/markdown" href="/capabilities/liveness.md">
<link rel="llms-txt" href="/llms.txt">
rel="alternate"는 현재 페이지의 Markdown 버전을 가리킵니다.rel="llms-txt"는 페이지 언어의llms.txt를 가리킵니다.
사용 사례
- AI 코딩 어시스턴트 — 어시스턴트에
llms.txt또는.mdURL을 제공하여 엔드포인트, 기능 또는 사용 사례에 대한 정확한 최신 컨텍스트로 작업하게 하세요. - LLM 프롬프트 — 페이지를 Markdown으로 가져와 요약, 번역 또는 코드 생성을 위한 프롬프트에 포함하세요.
- RAG 파이프라인 —
llms.txt를 소스 목록으로,.mdURL을 검색 증강 생성 시스템의 수집 소스로 사용하세요. - 자동화 스크립트 — HTML 스크래퍼 없이 문서 콘텐츠를 파싱합니다.
예시
영어 문서의 인덱스를 가져옵니다:
curl https://developer.unico.io/llms.txt
인증 페이지의 Markdown 버전을 가져옵니다:
curl https://developer.unico.io/dual-api/developers/api-reference/authentication.md
두 응답 모두 일반 텍스트이며, 어떤 LLM이나 처리 파이프라인에도 바로 입력할 수 있습니다.