Sabendo Quando Parar: A Lição do WebMCP que Meus Painéis Laterais Precisavam
Por quase um mês, meus repositórios de educação desaceleraram.
Não porque eu havia perdido o interesse. O oposto era verdade. Eu havia construído tanto que poderia continuar adicionando recursos sem saber se estava melhorando a experiência.
AlgoQuest tinha Livros Hero. O Criador de Algoritmos poderia forjar artefatos. Qbit poderia acompanhar uma missão. Scholarium estava se tornando o ponto de encontro da suíte.
Mas uma criança não chegaria com cinco anos de contexto do SecuredMe já em mente. Ela abriria uma missão, entraria em uma oficina, pediria ajuda a um agente, fecharia o laptop e retornaria mais tarde.
Naquele exato momento, quem se lembra do que escolheu? Qual ferramenta possui a progressão? Como a criança distingue uma sugestão de uma decisão?
O Git registra commits. Ele não registra o momento em que um arquiteto olha para seu próprio sistema e admite: posso estar muito próximo para ver o que está faltando.
Então eu parei de construir dentro da suíte tempo suficiente para aprender em outro lugar.
WebMCP tornou o botão honesto
O hackathon WebMCP se tornou meu primeiro laboratório.
Eu fui lá pensando em painéis laterais. Voltei pensando em autoridade.
Um painel lateral é a sala visível ao lado do trabalho. O WebMCP faz a pergunta mais difícil: que ferramenta nomeada existe por trás do botão, o que ela aceita, o que retorna e onde seu poder termina.
Para um humano, um botão rotulado "Continuar" pode parecer óbvio. Para um agente, é incompleto.
Continuar qual missão? De qual revisão? A ação é leitura, preparação ou execução? Quem a aprova?
Isso mudou meu vocabulário de design. Parei de perguntar apenas: "O acompanhante pode chamar a função?" e comecei a perguntar: "O sistema pode explicar a autoridade, a evidência, a mudança e o caminho de retorno?"
O WebMCP ainda é experimental, mas a lição já é prática: uma interface agente começa com promessas claras em torno de cada ação.
Thanks2Go tornou o limite real
O DEV Weekend Challenge se tornou meu segundo laboratório.
Com o Thanks2Go, eu queria algo pequeno: um gesto voluntário de gratidão de dois dólares. Não uma plataforma de pagamento. Apenas uma maneira de dizer: sua ajuda foi importante.
O mecanismo precisava permanecer menor que o gesto.
A intenção não é aprovação. A aprovação não é aceitação do provedor. Uma assinatura criptográfica não é um pagamento confirmado.
Então o Thanks2Go usou estados visíveis. O agente poderia inspecionar e se preparar. A travessia irreversível permaneceu um ato humano visível.
Então outra pessoa consentidora usou o caminho do PayPal ao vivo. Dois dólares foram enviados. A transação foi concluída. Eu recebi 1,64 USD após taxas.
Isso foi pequeno. Também foi completo.
Não validou todos os caminhos de falha. Não transformou o Thanks2Go em um produto financeiro. Provou exatamente um caminho de sucesso ao vivo.
Essa disciplina voltou comigo para os Livros Hero.
Uma sugestão de especialista não é a decisão da criança. Um artefato retornado não é evidência admitida. Um pedido repetido não deve avançar a mesma missão duas vezes.
O acompanhante não é um menu de ferramentas
Antes dessa pausa, eu pensava no acompanhante principalmente como acesso rápido a ferramentas.
Essa definição não funciona mais.
Para um Livro Hero, o painel deve se tornar um diário vivo: herói, mundo, missão, passo, talentos, inventário, decisões, dados, evidências, tokens e especialista ativo.
Isso não é decoração. É onde uma criança recupera a continuidade de uma aventura.
Essa continuidade não pode depender de um painel permanecer aberto. Os trabalhadores de serviço Manifest V3 são efêmeros. Uma variável de memória pode desaparecer. Um laptop pode fechar no momento errado.
Então eu defini HeroBookPanelState.v1 como explícito, versionado e ciente de revisões. O cockpit pode reabrir a experiência, mas não possui a progressão. AlgoQuest permanece canônico.
O Criador de Algoritmos é a forja. Qbit carrega a continuidade. Codex ou Gemini podem ajudar como especialistas.
AlgoQuest mantém a história.
O especialista retorna uma proposta ou recibo. AlgoQuest decide o que entra na missão.
A pausa se tornou a arquitetura
Eu também aprendi a não terceirizar a prova a uma nota.
a avaliação do webmcp.com me ajudou. Ela encontrou fraquezas e deu direção. Mas uma pontuação de terceiros mede sua própria metodologia.
Então eu construí um Portão de Evidências local no Scholarium. Ele verifica nomes, esquemas, modos, manipuladores, permissões, recusas, recibos e jornadas de agentes.
Isso prova o que seu próprio código pode inspecionar.
Apenas isso.
Para saber se o cockpit ajuda uma criança a encontrar seu caminho, eu ainda preciso de uma avaliação real com crianças, pais, educadores e usuários de acessibilidade.
Os acompanhantes não estão terminados. O Criador ainda precisa parecer uma forja. AlgoQuest precisa do ritmo de um livro de jogo. Qbit precisa de presença.
Mas o trabalho não é mais vago.
O motor pode ler sem mudar, preparar sem reivindicar execução, esperar aprovação, rejeitar uma revisão obsoleta, emitir um recibo e retornar a autoridade.
Esses comportamentos são menos espetaculares do que um avatar ou uma cena 3D. Eles são sobre o que as superfícies futuras podem descansar.
Gastamos um esforço enorme ensinando a IA quando parar. Antes do pagamento, publicação ou mutação canônica, pedimos confirmação.
O arquiteto humano precisa da mesma disciplina.
Ninguém retorna HUMAN_ARCHITECT_APPROVAL_REQUIRED para mim.
Eu preciso reconhecer o sinal.
Eu não quero o maior número possível de ferramentas agentes. Eu quero uma criança se movendo de AlgoQuest para o Criador e depois para um especialista para recuperar seu herói, missão, decisões, criações e evidências adquiridas.
Eventualmente, eu quero que o acompanhante ajude a criança a precisar menos do acompanhante.
Saber como avançar é uma habilidade.
Saber onde parar é outra.
Explore
- Proposta WebMCP: https://github.com/webmachinelearning/webmcp
- Documentação do Chrome WebMCP: https://developer.chrome.com/docs/ai/webmcp
- Idempotência do PayPal: https://developer.paypal.com/reference/guidelines/idempotency/
Empresas brasileiras podem se beneficiar ao adotar práticas de design de interface que priorizam a clareza e a continuidade nas interações com agentes de IA. A implementação de WebMCP pode melhorar a experiência do usuário e a eficácia das ferramentas digitais. A reflexão sobre quando parar de adicionar funcionalidades pode levar a um produto mais coeso e útil.
