Arquivado: 06b SRE com IA usando LibreChat hospedado
Referência arquivada do antigo módulo opcional de LibreChat hospedado.
Módulo arquivado
O módulo 06b não faz mais parte do workshop. Não provisione o LibreChat para o percurso atual do participante. Siga diretamente de 06 SRE com IA para 07 Testar, falhar e corrigir. O material abaixo permanece disponível apenas como referência histórica.
Ponto de partida histórico
Quando este módulo estava ativo, os participantes permaneciam em build-workshop-v1 e reservavam cerca de
15 minutos.
Pré-requisitos: módulo 05 concluído, uma URL HTTPS e uma conta do LibreChat fornecidas pelo instrutor
e um token refinado do GitHub, com acesso somente leitura a
ClickHouse/ClickHouse_Demos. Quem faz o workshop por conta própria pode implantar o LibreChat usando o
guia oficial de instalação na nuvem da Railway com um clique antes de
iniciar este módulo.
Somente hospedado na nuvem
Não execute LibreChat, MongoDB nem outro banco de dados no computador do workshop. O LibreChat
e sua persistência são executados na instância hospedada. Os retornos de chamada do OAuth devem usar a URL HTTPS
dessa instância, nunca localhost.
Por quê
No módulo 06, o agente estava no seu editor. Aqui, um agente de SRE nativo de chat investiga dois planos remotos ao mesmo tempo: a telemetria do ClickStack e o código-fonte público do workshop no GitHub.
Etapa 1 — Entre no LibreChat hospedado
Abra a URL HTTPS fornecida pelo instrutor e entre com a conta atribuída a você. Quem faz o workshop por conta própria usa a URL pública da Railway criada durante a implantação na nuvem.
O endereço da página deve começar com https://. Se apontar para localhost, pare e use
a URL hospedada.
Etapa 2 — Conecte os servidores MCP remotos
Abra MCP Settings. Seu instrutor talvez já tenha compartilhado estas definições de servidor; caso contrário, adicione-as na interface:
| Nome | Tipo | URL | Autenticação |
|---|---|---|---|
clickstack | Streamable HTTP | https://mcp.clickhouse.cloud/clickstack | Browser OAuth |
github | Streamable HTTP | https://api.githubcopilot.com/mcp/ | Seu PAT somente leitura |
Para clickstack, primeiro copie o UUID de ClickStack Team Settings → Data →
Connections → Default → Service ID para o campo individual por usuário
CLICKSTACK_SERVICE_ID do LibreChat. Depois, escolha Connect e conclua o OAuth do ClickHouse Cloud.
O retorno de chamada volta para a URL HTTPS do LibreChat hospedado.
Para github, informe seu PAT refinado somente na caixa de diálogo de credenciais individuais por usuário
do LibreChat. Restrinja-o a ClickHouse/ClickHouse_Demos com Contents: read. Ative o
conjunto de ferramentas somente leitura/do repositório caso o formulário do servidor ofereça esses controles.
Os dois servidores devem mostrar Connected antes de você prosseguir.
Etapa 3 — Crie o agente de SRE
Abra Agent Builder e crie um agente:
- Dê a ele o nome
NYC Taxi Ops SRE. - Cole o bloco Instructions de
workshops/build_workshop/app/librechat/sre-agent-definition.md. - Selecione o modelo robusto e compatível com ferramentas fornecido pela instância hospedada.
- Adicione as ferramentas MCP
clickstackegithub. - Salve o agente e pergunte
What can you investigate?
A resposta deve mencionar a telemetria do ClickStack e o código-fonte em
ClickHouse/ClickHouse_Demos/workshops/build_workshop/app.
Etapa 4 — Provoque uma falha e investigue
Injete a falha do mapa e recrie apenas o aplicativo local do workshop:
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 --buildAbra o aplicativo para que o SDK do navegador registre a falha. No LibreChat hospedado, pergunte:
Users report UI errors. Use ClickStack telemetry and the GitHub source to find the root cause. Is this a code bug?O agente deve relacionar o erro em nyc-taxi-frontend a
frontend/src/ui/ZoneMap.tsx e mostrar as evidências usadas.
Verificação de conclusão
- O LibreChat é acessado por uma URL de nuvem HTTPS fornecida pelo instrutor ou criada por você.
- O agente tem as ferramentas MCP remotas
clickstackegithubconectadas. - Seu diagnóstico cita tanto a telemetria quanto um arquivo de código-fonte no branch de falha selecionado.
O workshop atual continua em 07 Testar, falhar e corrigir.