Chuyển tới nội dung chính

Làm việc với AI

Tài liệu hướng dẫn của Android Macro hiện có thể được sử dụng theo cách thân thiện hơn với LLM.

Điều này mang đến cho bạn ba cách truy cập khác nhau:

  1. Mở bất kỳ trang tài liệu nào dưới dạng markdown thuần bằng cách thêm .md
  2. Tải chỉ mục tài liệu được tuyển chọn từ /llms.txt

Bản sao Markdown​

Mỗi tuyến tài liệu hiện đều có một bản sao markdown.

Ví dụ:

  • Trang HTML: https://androidmacro.com/docs/basic/how-to-use
  • Trang Markdown: https://androidmacro.com/docs/basic/how-to-use.md

Điều này hữu ích khi:

  • bạn muốn dán một trang vào một LLM
  • bạn muốn một tác nhân (agent) lấy phiên bản tài liệu sạch thay vì phân tích HTML
  • bạn muốn văn bản ổn định để làm ngữ cảnh cho prompt

llms.txt​

Gốc của trang web cung cấp một chỉ mục llms.txt:

https://androidmacro.com/llms.txt

Tệp này là một bản đồ tài liệu được tuyển chọn dành cho LLM. Nó hướng các mô hình và công cụ đến các trang quan trọng nhất trước, sau đó liên kết ra các phiên bản markdown của tài liệu.

Các tệp liên quan:

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

Sử dụng chúng như sau:

  • llms.txt làm điểm khởi đầu được tuyển chọn
  • llms-full.txt khi bạn muốn một bản xuất lớn gộp toàn bộ kho tài liệu
  • llms-sitemap.txt khi bạn muốn một danh sách thân thiện với máy của các URL markdown

Tại sao điều này giúp ích​

Tài liệu HTML được thiết kế cho con người. Các LLM thường hoạt động tốt hơn với:

  • markdown thay vì HTML của toàn bộ trang
  • một chỉ mục được tuyển chọn thay vì thu thập dữ liệu mù từng tuyến

Đó là lý do thiết lập này sử dụng cả hai:

  • bản sao .md để truy cập trang thô
  • khám phát kiểu llms.txt

Kiến trúc hiện tại​

Các bản sao markdown và tệp llms.txt được tạo ra trong đầu ra static của Docusaurus, vì vậy chúng được triển khai cùng với trang tài liệu.

Lưu ý​

  • Các trang đích danh mục cũng có bản sao markdown, chẳng hạn như https://androidmacro.com/docs/reference/storage.md
  • Markdown được tạo ra được thiết kế cho việc sử dụng của LLM, do đó một số phần nhúng tương tác được thay thế bằng ghi chú ngắn
  • Xây dựng lại trang tài liệu sau khi thay đổi nội dung để bản sao markdown và llms.txt luôn được đồng bộ

Trang liên quan​