# 面向智能体的 LogBrew 本页说明智能体应如何读取 LogBrew，无需依赖浏览器状态、隐藏上下文或私有控制台权限。 ## 第一次安全读取 ```bash logbrew status --json ``` ## AI 助手上下文 在智能体修改你的应用或接入命令之前，先给它公开的 LogBrew 地图。 安装提示词 ```text 阅读 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 助手帮助开发者接入 LogBrew 或读取私有信号时，按这个顺序进行。 ## 第 1 步: 读取公开路线图 修改应用代码前，先加载公开路由索引，让 AI 助手基于最新的 LogBrew 上下文开始工作。 ```bash curl -L https://logbrew.co/llms.txt ``` Next: 需要更深入的公开上下文时，使用链接中的 Markdown 镜像。 ## 第 2 步: 选择 SDK 卡片 安装任何东西前，先阅读 SDK 选择页，然后在“添加项目”中使用“复制安装提示词”，让 AI 助手按所选平台操作。 ```bash curl -L https://logbrew.co/en/docs.md ``` Next: 请已登录的用户打开“添加项目”并复制安装提示词，不要在聊天中粘贴接入凭据。 ## 第 3 步: 检查本地状态 读取私有项目、日志、问题、操作、链路或版本前，先确认 API 连通性和认证来源。 ```bash logbrew status --json ``` Next: 按照不含令牌的 next 字段操作，不要猜测。 ## 第 4 步: 验证第一个信号 接入流程发送一个安全的 SDK 信号后，读取一条限定范围的结果，并且不要把令牌、Cookie 和项目数据放进提示词。 ```bash logbrew logs info --json ``` Next: 认证就绪后，再读取问题、操作、链路、版本和项目。 ## 使用可预测的公开 URL 智能体应通过稳定的本地化页面、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。 ## 私有数据必须经过认证 产品指导使用公开文档。私有项目数据使用需认证的读取方式。 - 没有有效的用户会话时，不要抓取控制台数据。 - 不要公开私有项目名称、令牌、链路或部署细节。 - 一般学习使用公开页面，限定范围的用户数据使用需认证的路由。 ## Public agent links - Agents: https://logbrew.co/zh-Hans/agents - Agents Markdown: https://logbrew.co/zh-Hans/agents.md - Docs Markdown: https://logbrew.co/zh-Hans/docs.md - Home Markdown: https://logbrew.co/zh-Hans/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml