第一次安全读取
logbrew status --json先检查本地状态。确认认证和连通性正常后,再读取日志、问题、操作、链路、版本和项目。
智能体任务路线
当 AI 助手帮助开发者接入 LogBrew 或读取私有信号时,按这个顺序进行。
- 第 1 步
读取公开路线图
修改应用代码前,先加载公开路由索引,让 AI 助手基于最新的 LogBrew 上下文开始工作。
需要更深入的公开上下文时,使用链接中的 Markdown 镜像。curl -L https://logbrew.co/llms.txt已复制。粘贴到终端或 AI 助手中,然后继续下一步。 - 第 2 步
选择 SDK 卡片
安装任何东西前,先阅读 SDK 选择页,然后在“添加项目”中使用“复制安装提示词”,让 AI 助手按所选平台操作。
请已登录的用户打开“添加项目”并复制安装提示词,不要在聊天中粘贴接入凭据。curl -L https://logbrew.co/en/docs.md已复制。粘贴到终端或 AI 助手中,然后继续下一步。 - 第 3 步
检查本地状态
读取私有项目、日志、问题、操作、链路或版本前,先确认 API 连通性和认证来源。
按照不含令牌的 next 字段操作,不要猜测。logbrew status --json已复制。粘贴到终端或 AI 助手中,然后继续下一步。 - 第 4 步
验证第一个信号
接入流程发送一个安全的 SDK 信号后,读取一条限定范围的结果,并且不要把令牌、Cookie 和项目数据放进提示词。
认证就绪后,再读取问题、操作、链路、版本和项目。logbrew logs info --json已复制。粘贴到终端或 AI 助手中,然后继续下一步。
在智能体修改你的应用或接入命令之前,先给它公开的 LogBrew 地图。
curl -L https://logbrew.co/llms.txt已复制。粘贴到终端或 AI 助手中,然后继续下一步。阅读 https://logbrew.co/llms.txt,然后在 https://logbrew.co/en/docs#docs-sdk-choice-title 选择匹配的 SDK 卡片。npm install @logbrew/sdk @logbrew/node 只用于服务端 Node.js 服务;Next.js、React、iOS、Android 或 React Native 请使用所选卡片和“添加项目”中的提示词。请已登录的用户打开“添加项目”,并且只把凭据放在对应应用的环境中。服务端 Node.js 的环境变量是 LOGBREW_SERVER_API_KEY。仅对 Node 服务运行 node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs,然后用 logbrew logs info --json 验证。不要在聊天或提交中索要凭据。已复制。粘贴到终端或 AI 助手中,然后继续下一步。智能体应通过稳定的本地化页面、Markdown 镜像、llms.txt、robots.txt 和 sitemap.xml 获取公开的 LogBrew 上下文。
- 需要最安全的纯文本输入时,使用 /en/agents.md。
- 需要命令和 API 路由上下文时,使用 /en/docs.md。
- 使用 /llms.txt 查找可供智能体读取的公开资源。
CLI 应告诉智能体本地认证、API 连通性和恢复步骤是否就绪,且不暴露任何令牌内容。
- 读取项目前,运行 logbrew status --json。
- 按照 JSON 和人类可读输出中的下一步操作,不要猜测。
- 不要把令牌内容放进提示词、日志、截图和公开页面。
智能体应使用与人相同的资源词汇来读取日志、问题、操作、链路、版本和项目。
- 按版本、环境、项目、链路、严重程度、状态、名称和用户筛选。
- 已知标识符时,使用问题和链路的详情路由。
- 公开上下文用 Markdown 镜像,私有项目数据用需认证的 API。
产品指导使用公开文档。私有项目数据使用需认证的读取方式。
- 没有有效的用户会话时,不要抓取控制台数据。
- 不要公开私有项目名称、令牌、链路或部署细节。
- 一般学习使用公开页面,限定范围的用户数据使用需认证的路由。