Um Worker convencional responde a uma solicitação, mas muitas aplicações também precisam de uma identidade estável que lembre estado, coordene clientes conectados e continue o trabalho após uma solicitação terminar. Cloudflare Agents SDK fornece esse modelo de aplicação sobre Workers e Durable Objects baseados em SQLite.
O curso constrói um pequeno sistema sintético de suporte, um limite por vez. Começa sem modelo de IA para tornar visíveis identidade nomeada, estado persistente e clientes sincronizados. Laboratórios posteriores adicionam conversa persistente, trabalho agendado, ferramentas escolhidas pelo modelo, aprovação explícita, uma interface MCP somente leitura e diagnóstico prático de roteamento. Cada conceito aparece junto da necessidade da aplicação que o motiva; experiência anterior com Agents SDK não é necessária. São 8 laboratórios guiados e 1 desafio independente de reparo de aprovação. Os laboratórios guiados apresentam cada habilidade antes do desafio.
O que você vai aprender
- Criar um Agent de suporte nomeado: encaminhar nomes estáveis, persistir estado de suporte e comprovar isolamento entre instâncias de Agent.
- Sincronizar um painel de suporte: conectar dois clientes no navegador e observar atualizações de estado controladas pelo servidor em tempo real.
- Transmitir uma conversa persistente: transmitir uma resposta limitada e restaurar histórico durável de conversa após reconexão.
- Agendar um acompanhamento de suporte: registrar, inspecionar, concluir e cancelar tarefas persistentes do Agent.
- Adicionar ferramentas de suporte validadas: conectar ferramentas escolhidas pelo modelo a registros sintéticos com esquemas e verificações de escopo no servidor.
- Exigir aprovação para alterações de registros: pausar um efeito colateral para uma decisão humana e tornar entregas repetidas seguras.
- Publicar uma ferramenta MCP somente leitura: expor uma consulta sintética estritamente validada por transporte MCP remoto.
- Diagnosticar uma sessão de Agent mal encaminhada: reparar o nome do Agent selecionado sem perder histórico nem enfraquecer isolamento.
- Atualização de suporte não aprovada: reparar de forma independente aprovação antes do efeito e comportamento exatamente uma vez em um Agent fornecido.
Para quem é este curso
Desenvolvedores familiarizados com Workers e Durable Objects que querem construir assistentes com estado e clientes coordenados.
Pré-requisitos: Conclua Cloudflare Durable Objects for Beginners e Connect LabEx to Your Cloudflare Account. Você deve reconhecer um pequeno Worker TypeScript e a ideia de um Durable Object por nome estável; o curso apresenta o próprio Agents SDK desde o início.
Ambiente de aprendizagem: Use sua própria conta dedicada de aprendizagem da Cloudflare. Cada unidade começa em uma nova VM, autoriza Wrangler separadamente, cria recursos descartáveis com nomes únicos e termina com exclusão e saída da conta. Os exercícios permanecem em recursos limitados do Workers Free; os laboratórios com modelos usam apenas poucas chamadas de inferência hospedadas pela Cloudflare.
Perguntas frequentes
Preciso de experiência anterior com Agents SDK ou IA?
Experiência anterior com Agents SDK não é necessária. Os dois primeiros laboratórios não usam modelo de IA, permitindo entender primeiro identidade nomeada, estado persistente e clientes sincronizados. Os laboratórios com modelos exigem os fundamentos de Workers AI.
O modelo pode alterar um registro diretamente?
Uma chamada de ferramenta proposta deve passar por verificações de esquema e escopo no servidor. O laboratório de aprovação pausa um efeito colateral para uma decisão humana e torna entregas repetidas seguras; o desafio verifica aprovação antes do efeito.
O que acontece quando um cliente reconecta?
Os laboratórios distinguem a identidade do Agent selecionado, a conversa persistente e o estado controlado pelo servidor de uma única conexão do navegador. Você também repara uma sessão mal encaminhada sem descartar histórico válido.
Como os recursos são limpos?
Exclua apenas os Workers descartáveis e namespaces de objetos do laboratório enquanto estiver autorizado, confirme a remoção e saia da conta. Cada VM autoriza sua própria conta de forma independente.
