보관됨: 06b 호스팅 LibreChat으로 하는 AI SRE
이전의 선택 모듈이었던 호스팅 LibreChat 모듈에 대한 보관용 참고 자료입니다.
보관된 모듈
모듈 06b는 더 이상 워크숍의 일부가 아닙니다. 현재 학습자 경로에서는 LibreChat을 프로비저닝하지 마세요. 06 AI SRE에서 07 테스트, 실패, 수정으로 바로 이어가세요. 아래 내용은 역사적 참고 자료로만 남아 있습니다.
과거의 시작점
이 모듈이 활성 상태였을 때 학습자는 build-workshop-v1에 머물렀고 약 15분을 예상했습니다.
사전 조건: Module 05가 완료되어 있고, 강사가 HTTPS LibreChat URL과 계정을 제공했으며,
ClickHouse/ClickHouse_Demos에 읽기 전용으로 접근하는 세분화된 GitHub 토큰이 있어야 합니다.
자율 진행 학습자는 이 모듈을 시작하기 전에 공식
Railway 원클릭 클라우드 가이드로 LibreChat을 배포할
수 있습니다.
클라우드 호스팅만 사용
LibreChat, MongoDB, 또는 다른 데이터베이스를 워크숍 머신에서 실행하지 마세요. LibreChat과 그
영속성 계층은 호스팅 인스턴스에서 실행됩니다. OAuth 콜백은 반드시 그 인스턴스의 HTTPS URL을
사용해야 하며, localhost는 절대 안 됩니다.
왜
모듈 06은 에이전트를 에디터에 두었습니다. 여기서는 채팅 네이티브 SRE 에이전트가 두 개의 원격 영역을 동시에 조사합니다: ClickStack 텔레메트리와 GitHub의 공개 워크숍 소스입니다.
Step 1 — 호스팅 LibreChat에 로그인
강사가 제공한 HTTPS URL을 열고 배정된 계정으로 로그인하세요. 자율 진행 학습자는 클라우드 배포 중에 만든 공개 Railway URL을 사용합니다.
페이지 주소는 https://로 시작해야 합니다. localhost를 가리킨다면 멈추고 호스팅 URL을
사용하세요.
Step 2 — 원격 MCP 서버 연결
MCP Settings를 여세요. 강사가 이미 이 서버 정의를 공유했을 수도 있고, 그렇지 않다면 UI에서 추가하세요:
| 이름 | 유형 | URL | 인증 |
|---|---|---|---|
clickstack | Streamable HTTP | https://mcp.clickhouse.cloud/clickstack | 브라우저 OAuth |
github | Streamable HTTP | https://api.githubcopilot.com/mcp/ | 여러분의 읽기 전용 PAT |
clickstack의 경우, 먼저 ClickStack Team Settings → Data → Connections → Default →
Service ID의 UUID를 LibreChat의 사용자별 CLICKSTACK_SERVICE_ID 필드로 복사하세요. 그다음
Connect를 선택하고 ClickHouse Cloud OAuth를 완료하세요. 콜백은 호스팅 LibreChat HTTPS URL로
돌아옵니다.
github의 경우, 세분화된 PAT를 LibreChat의 사용자별 자격 증명 대화상자에만 입력하세요.
Contents: read 권한으로 ClickHouse/ClickHouse_Demos에 한정하세요. 서버 양식에 해당 컨트롤이
있다면 읽기 전용/리포지터리 툴셋을 활성화하세요.
계속하기 전에 두 서버 모두 Connected로 표시되어야 합니다.
Step 3 — SRE 에이전트 만들기
Agent Builder를 열고 에이전트를 만드세요:
- 이름을
NYC Taxi Ops SRE로 지정하세요. workshops/build_workshop/app/librechat/sre-agent-definition.md의 Instructions 블록을 붙여넣으세요.- 호스팅 인스턴스가 제공하는 도구 사용이 가능한 강력한 모델을 선택하세요.
clickstack과githubMCP 도구를 추가하세요.- 에이전트를 저장하고
What can you investigate?라고 물어보세요.
답변에는 ClickStack 텔레메트리와
ClickHouse/ClickHouse_Demos/workshops/build_workshop/app 소스가 언급되어야 합니다.
Step 4 — 무언가를 고장 낸 뒤 조사하기
지도 결함을 주입하고 로컬 워크숍 앱만 다시 빌드하세요:
cd "$(git rev-parse --show-toplevel)/workshops/build_workshop/app"
git checkout fault/01-map-not-loading
docker compose --env-file .env.workshop \
-f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build브라우저 SDK가 결함을 기록하도록 앱을 여세요. 호스팅 LibreChat에서 이렇게 물어보세요:
Users report UI errors. Use ClickStack telemetry and the GitHub source to find the root cause. Is this a code bug?에이전트는 nyc-taxi-frontend 오류를 frontend/src/ui/ZoneMap.tsx와 연결하고, 사용한 증거를
보여줘야 합니다.
완료 확인
- 강사가 제공하거나 자율 진행으로 만든 HTTPS 클라우드 URL로 LibreChat에 접근했습니다.
- 에이전트가 원격
clickstack과githubMCP 도구를 연결했습니다. - 진단이 텔레메트리와 선택한 결함 브랜치의 소스 파일을 모두 인용합니다.
활성 워크숍은 07 테스트, 실패, 수정에서 이어집니다.