요약 (TL;DR) — 모든 Alibaba Cloud 제품 문서, API 레퍼런스(API references) 및 베스트 프랙티스(best-practice) 가이드가 이제 llms.txt로 인덱싱되었습니다. Qwen, GPT, Claude, DeepSeek, Kimi 또는 Doubao를 사용하든 관계없이, 단 하나의 URL만 있으면 전체 Alibaba Cloud 지식 베이스를 귀하의 모델이나 코딩 에이전트(coding agent)에 연결하기에 충분합니다.

1. llms.txt를 찾는 방법

Alibaba Cloud 문서는 두 개의 독립된 사이트에 존재하며, 함께 6개 언어 버전의 llms.txt를 제공합니다:

국제 사이트 (alibabacloud.com)

중국 사이트 (help.aliyun.com)

루트 인덱스 (Root indexes)

다국어 항목은 다음 위치에 통합되어 있습니다:

• 국제 루트: https://www.alibabacloud.com/help/llms.txt
• 중국 루트: https://help.aliyun.com/llms.txt

2. llms.txt의 모습

모든 파일은 llmstxt.org 규약을 따릅니다. 이는 AI에게 _사이트에 무엇이 포함되어 있는지, 각 페이지가 무엇에 관한 것인지, 그리고 가져올 가치가 있는지_를 알려주는 작은 마크다운(Markdown) 문서입니다:

# 제품 이름
> 한 줄 제품 요약 (AI가 한눈에 관련성을 결정할 수 있도록 함)

...

Alibaba Cloud는 **2단계 인덱스(two-level index)**를 사용합니다:

1단계 — 루트 인덱스 (Root index) (alibabacloud.com/help/en/llms.txt): 모든 제품을 나열하며, 각 항목은 해당 제품 고유의 llms.txt를 가리킵니다.

# Alibaba Cloud Documentation
> Alibaba Cloud는 세계 최고의 클라우드 컴퓨팅 및 AI 기업 중 하나입니다...

...

2단계 — 제품 인덱스 (Product index) (예: alibabacloud.com/help/en/oss/llms.txt): 해당 제품에 대한 모든 문서 페이지를 나열합니다.

Object Storage Service (OSS)

OSS는 온디맨드(on demand)로 모든 유형의 데이터를 저장하고 액세스할 수 있는 IaaS 스토리지 서비스입니다...

...

두 계층은 서로 다르게 연결됩니다:

• Root(루트) 링크는 제품별 llms.txt 파일을 가리킵니다 (예: /en/oss/llms.txt).
• Product(제품) 링크는 실제 문서 페이지를 가리킵니다 (예: /en/oss/user-guide/xxx.md).

에이전트는 루트 인덱스(root index)를 읽어 제품을 찾고, 제품 인덱스를 읽어 페이지를 찾은 다음, 그제서야 Markdown 본문을 가져옵니다 — 세 번의 홉(hop)을 통해 온디맨드로 로드하며, 토큰 낭비가 없습니다.

3. AI 모델이 llms.txt를 소비하는 방식

사용자 질문
  "ECS에 GPU 인스턴스를 어떻게 배포하나요?"
      │
...

이를 통해 모델은 수만 개의 페이지를 추측하는 대신 올바른 문서로 바로 이동할 수 있습니다.

4. 사용 예시

예시 1 — AI 채팅 제품 내에서 직접 사용하기

웹 페치(web-fetch) 도구가 내장된 채팅 제품(Qoder, Kimi, ChatGPT, Claude, Perplexity, Doubao 등)은 자연어 지침만으로 llms.txt를 소비할 수 있습니다. 코드가 필요하지 않습니다.

모델에게 다음과 같이 요청하세요:

https://www.alibabacloud.com/help/en/llms.txt 를 읽고,
Function Compute 제품을 찾아서,
Python으로 HTTP 트리거 함수를 작성하는 방법을 알려줘.

모델이 실제로 수행하는 작업:

1. Fetch(https://www.alibabacloud.com/help/en/llms.txt)                       ← 루트 인덱스
   → Function Compute 항목을 찾아 제품별 llms.txt URL을 가져옴

...

모델은 "루트 → 제품 → 페이지"로 이어지는 홉 체인(hop chain)을 자동으로 수행하며, 실제 문서를 바탕으로 답변을 근거화(grounding)하고 출처 URL을 인용합니다.

팁 — 인용된 URL은 기본적으로 .md 형식입니다 (AI 친화적). 사람이 읽기 쉬운 HTML 페이지를 얻으려면 .md를 제거하세요:

• AI가 반환하는 값: https://www.alibabacloud.com/help/en/functioncompute/fc/user-guide/http-trigger-invoking-function.md
• 브라우저에서 열기: https://www.alibabacloud.com/help/en/functioncompute/fc/user-guide/http-trigger-invoking-function

시스템 프롬프트 (System Prompt)의 지식 소스로 연결하기 (커스텀 GPTs, Kimi 에이전트, Qoder 페르소나 등에 적용 가능):

당신은 Alibaba Cloud 아키텍트 어시스턴트입니다.
모든 Alibaba Cloud 제품 문서의 인덱스는 다음 위치에 있습니다.

...

예시 2 — Qoder CLI (Tongyi Lingma CLI)에서 llms.txt 사용하기

Tongyi Lingma는 Alibaba Cloud의 AI 코딩 어시스턴트입니다. 이 서비스의 CLI 모드(qodercli)에는 WebFetch 도구가 내장되어 있어, 프로젝트 레벨의 AGENTS.md 파일을 추가함으로써 llms.txt를 탐색하도록 학습시킬 수 있습니다.

설정. 프로젝트 루트에 AGENTS.md를 생성합니다:

# Alibaba Cloud 문서 조회 규칙

Alibaba Cloud 제품 문서가 필요할 때마다 다음 단계를 따르십시오:
...

결과 (검증됨):

$ qodercli

> OSS에서 CORS를 어떻게 구성하나요? AGENTS.md를 따르세요,
...

Lingma는 자동으로 다음을 수행합니다:

1. https://www.alibabacloud.com/help/en/llms.txt를 가져와(Fetch) → OSS 항목을 찾습니다.
2. https://www.alibabacloud.com/help/en/oss/llms.txt를 가져와(Fetch) → CORS 페이지를 찾습니다.
3. 실제 페이지를 기반으로 답변을 생성(Grounding)하고 https://www.alibabacloud.com/help/en/oss/user-guide/configure-cross-origin-resource-sharing.md를 인용합니다.

작동 원리 — Qoder CLI는 세 단계의 AGENTS.md(사용자 레벨 ~/.qoder/AGENTS.md, 프로젝트 레벨, 워크스페이스 로컬)를 컨텍스트(Context)로 로드합니다. WebFetch와 결합하여, 모델은 규칙에 따라 스스로 llms.txt를 탐색합니다. 동일한 패턴은 Claude Code (CLAUDE.md) 및 프로젝트 레벨의 시스템 프롬프트를 지원하는 다른 모든 에이전트형(Agentic) CLI에서도 작동합니다.

5. 제품 커버리지

llms.txt는 300개 이상의 Alibaba Cloud 제품을 다룹니다. 주요 카테고리는 다음과 같습니다:

6. FAQ

Q: llms.txt는 기존의 문서 검색과 어떻게 다른가요?
검색 엔진은 사용자가 적절한 키워드를 직접 구성해야 하며, 모델은 수만 개의 페이지를 스스로 탐색하는 데 어려움을 겪습니다. llms.txt는 모델에게 **설명이 포함된 구조화된 목차 (structured table of contents)**를 제공하여, 개발자가 API 인덱스를 읽는 방식과 유사하게 브라우징할 수 있게 합니다. 이를 통해 토큰 비용 (token cost)을 절감하고 환각률 (hallucination rate)을 낮출 수 있습니다.

Q: llms.txt는 얼마나 자주 업데이트되나요?
Alibaba Cloud의 llms.txt는 문서 자체와 함께 갱신됩니다. 제품 페이지가 게시되거나 업데이트될 때마다, 해당 llms.txt 항목과 .md 파일도 그에 따라 업데이트됩니다.

Q: 저는 개발자입니다. 이것을 제 AI 앱에 어떻게 연결하나요?
앱의 시스템 프롬프트 (System Prompt)에 llms.txt URL을 추가하고, 모델에게 이를 Alibaba Cloud의 정식 지식 소스 (canonical knowledge source)로 사용하도록 지시하세요. 모델은 llms.txt를 스스로 찾아내지 못하므로, 반드시 URL을 명시적으로 참조해야 합니다.

Q: 중국 사이트와 글로벌 사이트의 차이점은 무엇인가요?
두 사이트는 서로 다른 제품 카탈로그를 다루며, 경우에 따라 제품별로 기능이 다를 수 있습니다. llms.txt 인덱스는 독립적으로 유지 관리되므로 언어와 콘텐츠가 서로 교차되지 않습니다. 귀하의 배포 지역 (deployment region)에 맞는 사이트를 선택하십시오.