Transformando Signal Forms em tools de agente de IA

O que você ganha de verdade#

Essa é a fatia mais demonstrável do WebMCP no Angular: em vez de escrever uma tool na mão com um JSON schema e um callback execute, você deixa um Signal Form que já existe virar a tool. Adicione o provideExperimentalWebMcpForms() de @angular/forms/signals aos seus providers, passe a opção experimentalWebMcpTool para o form(), e o Angular liga o resto.

A parte boa está no que o form já carrega. O Angular infere o JSON schema da tool a partir dos valores iniciais do modelo, e conecta a validação e o submit do form na chamada. Quando o agente preenche a tool, os validadores que você já escreveu rodam; o agente enxerga os erros de campo e consegue se corrigir, em vez de empurrar um payload meio-válido para o seu handler de submit. As mesmas regras de required que protegem uma pessoa digitando no form passam a proteger o agente que o chama.

Eu leio isso como o form virando um contrato que o agente precisa cumprir, e não uma superfície que ele fica cutucando. Você escreve o form uma vez, para pessoas, e o agente ganha a versão validada de graça.

// provideExperimentalWebMcpForms() precisa estar nos seus providers
readonly model = signal({ firstName: '', lastName: '' });

readonly userForm = form(this.model,
  (f) => {
    required(f.firstName, { message: 'First name is mandatory.' });
    required(f.lastName, { message: 'Last name is mandatory.' });
  },
  {
    experimentalWebMcpTool: { name: 'registerUser', description: 'Registers a new user.' },
    submission: { action: async (formValue) => { /* ... */ } },
  },
);

O que a inferência de schema precisa#

Essa conveniência tem um preço, e ele está no modelo. O Angular lê o formato do schema da tool a partir dos valores iniciais do modelo, então esses valores precisam ser concretos o bastante para dar para ler um tipo deles. Não existe um schema separado que você corrige na mão; o modelo é o schema.

Três restrições saem daí. A primeira: todo campo precisa de um valor inicial concreto ('', 0, false), nunca null ou undefined, porque não dá para inferir um tipo a partir de null. A segunda: arrays precisam de pelo menos um elemento para o formato do item ser conhecido. A terceira: validadores assíncronos não rodam durante o submit do agente, então aquilo que você só garante de forma assíncrona não vai barrar o agente.

Leia a tabela como o custo de pular um schema escrito na mão. Se um campo não consegue dar um valor inicial limpo, é nesse campo que você precisa pensar antes de expor o form.

Onde isso merece existir, e onde eu esperaria#

Eu usaria isso em forms internos e de admin que um agente conduz: um registro de back-office que um operador preencheria na mão, ou uma ação em lote atrás de uma flag, onde o form já tem uma boa validação e o raio de impacto é pequeno. Ali é genuinamente útil, e a validação guardando a chamada é a feature, não um detalhe de rodapé.

Eu esperaria em envios voltados ao usuário e em fluxos regulados. A metade dos forms está resolvida agora: Signal Forms são estáveis desde o Angular 22. A metade do agente não. O WebMCP é experimental, um draft de Community Group do W3C, e a doc avisa que as APIs podem mudar fora de major versions. O motivo mais profundo é que o Angular não valida que as entradas do agente batem com o schema inferido; você ainda valida dentro do submit para qualquer coisa que importe. Então é uma camada experimental agora, não duas: eu adotaria Signal Forms sozinhos antes de confiar na camada de agente em cima num fluxo de receita.