LogBrew cho agent

Trang này giải thích cách agent nên đọc LogBrew mà không cần trạng thái trình duyệt, ngữ cảnh ẩn hay quyền truy cập bảng điều khiển riêng tư.

Đọc Markdown
Lần đọc an toàn đầu tiên
logbrew status --json

Bắt đầu với status cục bộ, rồi chỉ đọc log, vấn đề, hành động, trace, bản phát hành và dự án sau khi xác thực và kết nối đã rõ ràng.

Bản đồ tác vụ cho agent

Làm theo thứ tự này khi trợ lý AI giúp lập trình viên thiết lập LogBrew hoặc đọc tín hiệu riêng tư.

  1. Bước 1

    Đọc bản đồ công khai

    Tải chỉ mục route công khai trước khi sửa mã ứng dụng, để trợ lý bắt đầu từ ngữ cảnh LogBrew hiện tại.

    curl -L https://logbrew.co/llms.txt
    Dùng các bản sao Markdown được liên kết để có ngữ cảnh công khai sâu hơn.
  2. Bước 2

    Chọn thẻ SDK

    Đọc phần chọn SDK trước khi cài bất cứ thứ gì, rồi dùng Sao chép prompt cài đặt trong trang Thêm dự án để trợ lý làm theo đúng nền tảng đã chọn.

    curl -L https://logbrew.co/en/docs.md
    Đề nghị người dùng đã đăng nhập mở trang Thêm dự án, sao chép prompt cài đặt và không đưa thông tin xác thực gửi dữ liệu vào chat.
  3. Bước 3

    Kiểm tra status cục bộ

    Xác nhận kết nối tới API và nguồn xác thực trước khi đọc dự án, log, vấn đề, hành động, trace hoặc bản phát hành riêng tư.

    logbrew status --json
    Làm theo trường next an toàn với token thay vì đoán.
  4. Bước 4

    Kiểm tra tín hiệu đầu tiên

    Sau khi bước thiết lập gửi một tín hiệu SDK an toàn, đọc một kết quả trong phạm vi và không đưa token, cookie hay dữ liệu dự án vào prompt.

    logbrew logs info --json
    Chỉ đọc vấn đề, hành động, trace, bản phát hành và dự án sau khi xác thực đã sẵn sàng.

Đưa cho agent bản đồ LogBrew công khai trước khi nó sửa ứng dụng hoặc lệnh thiết lập của bạn.

curl -L https://logbrew.co/llms.txt
Đọc https://logbrew.co/llms.txt, rồi chọn thẻ SDK phù hợp tại https://logbrew.co/en/docs#docs-sdk-choice-title. Chỉ dùng npm install @logbrew/sdk @logbrew/node cho dịch vụ Node.js phía server; với Next.js, React, iOS, Android hoặc React Native, hãy dùng thẻ đã chọn và prompt trong trang Thêm dự án. Đề nghị người dùng đã đăng nhập mở trang Thêm dự án và chỉ đặt thông tin xác thực vào môi trường của đúng ứng dụng đó. Với Node.js phía server, biến môi trường là LOGBREW_SERVER_API_KEY. Chỉ chạy node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs cho dịch vụ Node, rồi kiểm tra bằng logbrew logs info --json. Không yêu cầu thông tin xác thực qua chat hoặc trong commit.

Agent nên tìm ngữ cảnh LogBrew công khai qua các trang bản địa hóa ổn định, bản sao Markdown, llms.txt, robots.txt và sitemap.xml.

  • Dùng /en/agents.md khi văn bản thuần là đầu vào an toàn nhất.
  • Dùng /en/docs.md để có ngữ cảnh về lệnh và route API.
  • Dùng /llms.txt để tìm các tài nguyên công khai mà agent đọc được.

CLI cần cho agent biết xác thực cục bộ, kết nối tới API và các bước khôi phục đã sẵn sàng chưa mà không làm lộ token.

  • Chạy logbrew status --json trước khi đọc dự án.
  • Làm theo các bước tiếp theo từ đầu ra JSON và đầu ra dễ đọc thay vì đoán.
  • Không đưa token vào prompt, log, ảnh chụp màn hình và trang công khai.

Agent nên đọc log, vấn đề, hành động, trace, bản phát hành và dự án bằng cùng bộ thuật ngữ tài nguyên mà con người dùng.

  • Dùng bộ lọc theo bản phát hành, môi trường, dự án, trace, mức độ, trạng thái, tên và người dùng.
  • Dùng route chi tiết vấn đề và trace khi đã biết mã định danh.
  • Dùng bản sao Markdown cho ngữ cảnh công khai và API có xác thực cho dữ liệu dự án riêng tư.

Dùng tài liệu công khai cho hướng dẫn sản phẩm. Dùng lần đọc có xác thực cho dữ liệu dự án riêng tư.

  • Không thu thập dữ liệu bảng điều khiển khi không có phiên người dùng hợp lệ.
  • Không công khai tên dự án riêng tư, token, trace hay thông tin triển khai.
  • Dùng trang công khai để tìm hiểu chung và route có xác thực cho dữ liệu người dùng trong phạm vi.