LogBrew untuk agen

Halaman ini menjelaskan cara agen membaca LogBrew tanpa memerlukan status browser, konteks tersembunyi, atau akses dasbor privat.

Baca Markdown
Pembacaan aman pertama
logbrew status --json

Mulai dari status lokal, lalu baca log, masalah, aksi, trace, rilis, dan proyek hanya setelah autentikasi dan koneksi ke API sudah jelas.

Peta tugas agen

Gunakan urutan ini saat asisten membantu developer menyiapkan LogBrew atau membaca sinyal privat.

  1. Langkah 1

    Baca peta publik

    Muat indeks rute publik sebelum mengubah kode aplikasi, agar asisten mulai dari konteks LogBrew terbaru.

    curl -L https://logbrew.co/llms.txt
    Gunakan salinan Markdown yang ditautkan untuk konteks publik yang lebih dalam.
  2. Langkah 2

    Pilih kartu SDK

    Baca pemilih SDK sebelum memasang apa pun, lalu gunakan “Salin prompt instalasi” di “Tambah proyek” agar asisten mengikuti platform yang dipilih.

    curl -L https://logbrew.co/en/docs.md
    Minta pengguna yang sudah masuk untuk membuka “Tambah proyek”, menyalin prompt instalasi, dan tidak menempelkan kredensial ingest ke chat.
  3. Langkah 3

    Periksa status lokal

    Pastikan API dapat dijangkau dan sumber autentikasi jelas sebelum membaca proyek, log, masalah, aksi, trace, atau rilis privat.

    logbrew status --json
    Ikuti field next yang aman untuk token, jangan menebak.
  4. Langkah 4

    Verifikasi sinyal pertama

    Setelah penyiapan mengirim sinyal SDK yang aman, baca satu hasil dengan cakupan terbatas dan jangan masukkan token, cookie, atau data proyek ke prompt.

    logbrew logs info --json
    Baca masalah, aksi, trace, rilis, dan proyek hanya setelah autentikasi siap.

Berikan peta publik LogBrew kepada agen sebelum agen mengubah aplikasi atau perintah penyiapan Anda.

curl -L https://logbrew.co/llms.txt
Baca https://logbrew.co/llms.txt, lalu pilih kartu SDK yang sesuai di https://logbrew.co/en/docs#docs-sdk-choice-title. Gunakan npm install @logbrew/sdk @logbrew/node hanya untuk layanan Node.js sisi server; untuk Next.js, React, iOS, Android, atau React Native, gunakan kartu yang dipilih dan prompt dari “Tambah proyek”. Minta pengguna yang sudah masuk untuk membuka “Tambah proyek” dan menaruh kredensial hanya di lingkungan aplikasi yang sesuai. Untuk Node.js sisi server, variabel lingkungannya adalah LOGBREW_SERVER_API_KEY. Jalankan node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs hanya untuk layanan Node, lalu verifikasi dengan logbrew logs info --json. Jangan meminta kredensial di chat atau commit.

Agen sebaiknya menemukan konteks publik LogBrew lewat halaman berbahasa lokal yang stabil, salinan Markdown, llms.txt, robots.txt, dan sitemap.xml.

  • Gunakan /en/agents.md jika teks biasa adalah input yang paling aman.
  • Gunakan /en/docs.md untuk konteks perintah dan rute API.
  • Gunakan /llms.txt untuk menemukan sumber daya publik yang dapat dibaca agen.

CLI sebaiknya memberi tahu agen apakah autentikasi lokal, koneksi ke API, dan langkah pemulihan sudah siap tanpa menampilkan isi token.

  • Jalankan logbrew status --json sebelum membaca proyek.
  • Ikuti langkah berikutnya dari output JSON dan output untuk manusia, jangan menebak.
  • Jangan masukkan isi token ke prompt, log, tangkapan layar, atau halaman publik.

Agen sebaiknya membaca log, masalah, aksi, trace, rilis, dan proyek dengan kosakata resource yang sama dengan yang dipakai manusia.

  • Gunakan filter untuk rilis, lingkungan, proyek, trace, tingkat keparahan, status, nama, dan pengguna.
  • Gunakan rute detail masalah dan trace jika ID-nya sudah diketahui.
  • Gunakan salinan Markdown untuk konteks publik dan API yang diautentikasi untuk data proyek privat.

Gunakan dokumentasi publik untuk panduan produk. Gunakan pembacaan yang diautentikasi untuk data proyek privat.

  • Jangan mengambil data dasbor tanpa sesi pengguna yang valid.
  • Jangan memublikasikan nama proyek privat, token, trace, atau detail deployment.
  • Gunakan halaman publik untuk pembelajaran umum dan rute yang diautentikasi untuk data pengguna dengan cakupan terbatas.