# 에이전트를 위한 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_modules/@logbrew/node/examples/first-useful-telemetry.mjs는 Node 서비스에서만 실행한 다음 logbrew logs info --json으로 확인하세요. 채팅이나 커밋으로 자격 증명을 요청하지 마세요.
```

# 에이전트 작업 순서
어시스턴트가 개발자의 LogBrew 설정을 돕거나 비공개 시그널을 읽을 때 이 순서를 따르세요.

## 1단계: 공개 맵 읽기
앱 코드를 바꾸기 전에 공개 경로 색인을 불러와, 어시스턴트가 최신 LogBrew 맥락에서 시작하게 하세요.

```bash
curl -L https://logbrew.co/llms.txt
```

Next: 더 자세한 공개 맥락은 연결된 Markdown 미러를 사용하세요.

## 2단계: SDK 카드 선택
무엇이든 설치하기 전에 SDK 선택 안내를 읽고, 프로젝트 추가 화면의 설치 프롬프트 복사를 사용해 어시스턴트가 선택한 플랫폼을 따르게 하세요.

```bash
curl -L https://logbrew.co/en/docs.md
```

Next: 로그인한 사용자에게 프로젝트 추가를 열고 설치 프롬프트를 복사해 달라고 요청하고, 수집 자격 증명은 채팅에 넣지 마세요.

## 3단계: 로컬 상태 확인
비공개 프로젝트, 로그, 이슈, 액션, 트레이스, 릴리스를 읽기 전에 API 연결 가능 여부와 인증 출처를 확인하세요.

```bash
logbrew status --json
```

Next: 추측하지 말고 토큰이 노출되지 않는 next 필드를 따르세요.

## 4단계: 첫 시그널 확인
설정에서 안전한 SDK 시그널을 보낸 후, 범위가 지정된 결과 하나를 읽고 토큰, 쿠키, 프로젝트 데이터는 프롬프트에 넣지 마세요.

```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/ko/agents
- Agents Markdown: https://logbrew.co/ko/agents.md
- Docs Markdown: https://logbrew.co/ko/docs.md
- Home Markdown: https://logbrew.co/ko/page.md
- llms.txt: https://logbrew.co/llms.txt
- Sitemap: https://logbrew.co/sitemap.xml