Arquivado: 06b SRE com IA usando LibreChat hospedado

Material do facilitador correspondente a 06b SRE com IA usando LibreChat hospedado.

Cronograma histórico

Este módulo antes levava cerca de 15 minutos, imediatamente antes do módulo 07. O módulo 06 já abrange o fluxo de trabalho com o ClickStack MCP remoto.

Preparação histórica na nuvem

Os participantes não devem implantar o LibreChat nem o MongoDB localmente.

1. Antes do evento, implante uma instância HTTPS do LibreChat usando o guia de instalação da Railway com um clique, ou use uma instância hospedada aprovada pela organização.
2. Crie contas para os participantes ou configure seu provedor de identidade. Nunca compartilhe uma senha padrão do workshop.
3. Configure um provedor e um modelo de LLM compatíveis com ferramentas, armazene a chave de API somente na implantação hospedada e defina um limite de gastos para o workshop.
4. Adicione e compartilhe estas definições de MCP remoto:
   • clickstack → https://mcp.clickhouse.cloud/clickstack usando CLICKSTACK_SERVICE_ID e OAuth individuais por usuário.
   • github → https://api.githubcopilot.com/mcp/ usando um PAT refinado por usuário, cabeçalhos somente leitura e o conjunto de ferramentas do repositório.
5. Monte ou copie app/librechat/librechat.yaml caso a implantação hospedada seja gerenciada como código. Esse arquivo não contém nenhum token compartilhado de participante.
6. Crie o agente de SRE a partir de app/librechat/sre-agent-definition.md e compartilhe-o com os participantes como Viewer, ou deixe que eles o criem durante o exercício.
7. Teste usando a conta de um participante sem privilégios administrativos: execute uma consulta do ClickStack MCP e uma leitura do código-fonte no GitHub com o modelo configurado. Os dois retornos de chamada devem apontar para o domínio HTTPS hospedado, não para localhost.

A documentação do LibreChat descreve o OAuth para MCP remoto, as credenciais por usuário e o compartilhamento de agentes no guia de MCP e no guia de Agents.

Roteiro de apresentação

• O módulo 06 usa um agente no editor; o 06b mostrava a mesma cadeia de evidências em uma interface de chat hospedada.
• O LibreChat é uma interface cliente. O ClickStack/HyperDX e a telemetria continuam gerenciados no ClickHouse Cloud; o GitHub continua sendo o serviço com a fonte oficial.
• Cada participante controla sua sessão OAuth do ClickHouse e seu PAT do GitHub.

Falhas comuns

• A URL hospedada não está disponível: pule este módulo arquivado e continue no módulo 06. Não improvise uma implantação local com Docker durante o workshop.
• O OAuth retorna para o host errado: corrija o DOMAIN_SERVER e o DOMAIN_CLIENT públicos do LibreChat para a URL HTTPS da implantação e reconecte.
• Serviço ClickStack incorreto: substitua o CLICKSTACK_SERVICE_ID do participante pelo UUID da conexão do ClickStack e reconecte.
• Erros nas ferramentas do GitHub: substitua o PAT do participante por um token refinado restrito a ClickHouse/ClickHouse_Demos, com Contents: read.
• Sem telemetria da falha no navegador: abra o aplicativo local após injetar a falha, para que o SDK do navegador a registre.

Etapas de redefinição

• Revogue as conexões MCP ou o PAT do participante no LibreChat hospedado.
• Remova as contas temporárias dos participantes após o evento, de acordo com sua política de acesso.
• Redefina o aplicativo local do workshop com as etapas de guardar alterações e trocar de branch do módulo 07.
• Mantenha a instância hospedada atualizada ou desmonte o projeto da Railway após o workshop.