Como a WebMCP se encaixa nas jornadas dos usuários

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Publicado em: 18 de maio de 2026

Há muitos usos possíveis para o WebMCP. Neste documento, você vai aprender a implementar o WebMCP para oferecer suporte aos usuários e aos agentes deles. Você vai ler sobre esse processo do ponto de vista do usuário e do agente, com recomendações de ferramentas que podem ser fornecidas para oferecer suporte a uma jornada ideal do usuário (CUJ, na sigla em inglês).

Ajudar os usuários a fazer compras

Os desenvolvedores de lojas de varejo são ótimos candidatos para o WebMCP. Embora haja algumas circunstâncias em que um usuário provavelmente queira escolher um item, como encontrar a peça que falta na coleção, há outras circunstâncias em que a tarefa só precisa ser concluída. Pode ser a lista de compras semanal, o planejamento de uma festa ou a repetição de compras favoritas.

Nosso usuário para essas CUJs de compras é o Jesse. Ele não quer perder tempo pesquisando em categorias para encontrar exatamente o que procura. Em vez disso, ele confia no agente do navegador para atender às necessidades de compras, tornando mais rápido encontrar o que ele quer e finalizar a compra.

Oferecer suporte à jornada de compras

Jesse decidiu comprar suprimentos para a festa de 10 anos do filho. O tema da festa é espaço sideral, e Jesse já escreveu uma lista de compras. Alguns suprimentos podem precisar vir de supermercados especializados, outros de grandes lojas de departamento e alguns de fornecedores de festas especiais.

Jesse pergunta ao agente do navegador: "Encontre os melhores preços dos produtos na minha lista de compras em duas ou três lojas locais. Crie minha lista de desejos para que eu possa finalizar a compra. Avise se houver produtos que não podem ser encontrados".

Jesse fez algumas suposições ao fazer essa pergunta. Isso inclui que o agente não vai adicionar o mesmo item em vários carrinhos. Se duas lojas tiverem um item, o agente vai determinar qual tem o menor custo e adicioná-lo ao carrinho. Jesse também presume que as lojas locais estão perto dela em Springfield.

Se você é um desenvolvedor de uma empresa local, a Space Shoppe, com um grande volume de suprimentos para festas para recomendar às crianças, ou um desenvolvedor de uma grande rede de supermercados, você pode criar ferramentas para oferecer suporte ao agente de Jesse.

  • search_products() para que Jesse encontre possíveis itens em uma categoria que atendam à expectativa da lista de compras. Por exemplo, productType="wall-decorations" , category="planets" e age="child".
  • add_to_wishlist() para que Jesse revise todos os itens antes de adicioná-los ao carrinho.
  • Se Jesse pedir que todos os produtos custem menos do que um determinado valor, você poderá oferecer uma ferramenta para refinar a pesquisa, como refine_search(priceRange = "0-49.99").

Oferecer suporte a compras repetidas

Jesse adorou os palitos de queijo da Example Grocery Company, mas não se lembra da marca. Jesse pergunta ao agente: "Você pode refazer o pedido dos palitos de queijo que comprei no mês passado?"

Se você não oferece um serviço de assinatura, ainda pode ajudar os clientes a pedir o mesmo produto novamente com o agente. Como desenvolvedor da Example Grocery Company, talvez você queira oferecer as seguintes ferramentas:

  • get_order_history(startdate="",enddate="",) que retorna detalhes do produto com a data do pedido e o status da entrega.
  • add_to_wishlist(productId="XYZ", quantity = 1) para que Jesse revise todos os itens antes de adicioná-los ao carrinho.
  • delivery(method="pickup")

O agente responde a Jesse: "Encontrei seu pedido de Cheddar Peelers de 7 de março. Adicionei um pacote ao seu carrinho. Quer finalizar a compra? Jesse pode finalizar a compra rapidamente na Example Grocery Company para pedir apenas os Cheddar Peelers ou continuar navegando e comprando outros produtos.

Ajudar os usuários a preencher formulários

O preenchimento automático é um recurso de navegador incrivelmente útil que, quando implantado corretamente, pode reduzir a taxa de abandono de formulários em 75%. Embora incentivemos você a criar formulários com preenchimento automático, podemos melhorar ainda mais as taxas de conclusão com a ajuda do WebMCP.

O WebMCP oferece suporte aos agentes dos usuários que preenchem formulários longos de forma rápida e correta. Nas próximas seções, vamos orientar Charlie no preenchimento de vários formulários complexos.

Gerenciar trabalhos

Charlie trabalha na área de TI de um escritório de advocacia e contratou um prestador de serviços para criar um novo site para o escritório. O gerenciamento de despesas e planilhas de horas trabalhadas tem sido muito difícil, especialmente porque tem expectativas diferentes das planilhas de horas trabalhadas dos advogados.

Você trabalha para uma empresa de software de gerenciamento de trabalho e quer facilitar a entrada de planilhas de horas trabalhadas de todos os fornecedores e advogados com o contexto correto, para que a empresa fature o valor correto para o departamento certo. Você pode adicionar uma ferramenta WebMCP para oferecer suporte aos prestadores de serviços e advogados de Charlie usando um agente para inserir tarefas diárias de planilhas de horas trabalhadas.

<form toolname="add-to-timesheet"
  tooldescription="Report billing task and time to add to the timesheet."
  toolautosubmit>

  <fieldset>
    <label for="date">Date</label>
    <input name="date" type="datetime-local" toolparamdescription="Date of work.">

    <label for="task_category">Task category</label>
    <select id="task_category" name="task_category"
    toolparamdescription="Type of task completed per time block">
      <option value="admin">Admin</option>
      <option value="billing">Billing</option>
      <option value="client">Client meetings or communication</option>
      <option value="development">Development</option>
    </select>

    <label for="minutes_worked">Minutes working on the task</label>
    <input type="number" id="minutes_worked" name="minutes_worked" min="30" max="600"
      toolparamdescription="Minutes worked on this date and task, with a minimum of 30 and maximum of 600."
      placeholder="60">

    <label for="work_details">Details</label>
    <input name="work_details"
      toolparamdescription="Additional details of work completed, for managerial review.">

  </fieldset>
  <button type="submit">Update timesheet</button>
</form>

Comprar um carro

Charlie quer comprar um carro usado. Há alguns recursos que ele se importa muito, como o tipo de carro, o número de assentos e o combustível preferido. Outros recursos, como a cor do carro e comodidades como uma câmera de ré, são menos importantes. Charlie pergunta ao agente: "Você pode me ajudar a encontrar um carro familiar? Ele precisa ter 7 assentos, usar gasolina comum e ser um modelo dos últimos 10 anos".

Se o site já tiver um formulário com campos obrigatórios e opcionais, serão necessárias apenas duas etapas para transformar o formulário em uma ferramenta WebMCP.

HTML

<form toolname="search_cars"
  tooldescription="Search for cars based on various criteria such as type, seats, year, fuel, and features."
  toolautosubmit>

  <fieldset>
    <label for="car_type">Car Type</label>
    <select id="car_type" name="car_type" toolparamdescription="Type of car">
      <option value="">Any</option>
      <option value="family">Family Car</option>
      <option value="suv">SUV</option>
      <option value="sedan">Sedan</option>
    </select>

    <label for="seats">Min Seats</label>
    <input type="number" id="seats" name="seats" min="1" max="9"
      toolparamdescription="Minimum number of seats required"
      placeholder="7">

    <label for="min_year">Minimum Year</label>
    <input type="number" id="min_year" name="min_year" min="1900" max="2026"
      toolparamdescription="Find cars made after a specific year"
      placeholder="2016">
  </fieldset>

  <fieldset>
    <legend>Preferences</legend>

    <label for="fuel_type">Fuel Type</label>
    <select id="fuel_type" name="fuel_type" toolparamdescription="Preferred fuel type">
      <option value="">Unleaded regular</option>
      <option value="">Unleaded premium</option>
      <option value="diesel">Diesel</option>
      ...
    </select>

    <div>
      <input type="checkbox" id="has_ac" name="has_ac" value="true"
        toolparamdescription="Check if air conditioning is required">
      <label for="has_ac">Air Conditioning (AC)</label>
    </div>
  </fieldset>

  <button type="submit">Search Cars</button>
</form>

JavaScript

search_cars({car_type, seats, min_year, fuel_type, has_ac, ... })

Solicitação de garantia

Charlie quer registrar uma solicitação de garantia para a TV. Ele acessa a página principal do site em que pediu a TV. Imediatamente, ele declara a intenção a um agente:

"Acesse a página de suporte e registre uma solicitação de garantia para minha TV. A tela não liga. O número de série é XYZ-987. Use meus detalhes salvos para o restante".

O agente que usa as ferramentas WebMCP inicia o processo de solicitação e preenche todas as informações necessárias. Se o agente precisar de mais informações, ele poderá pedir ao usuário que as forneça ou preencha o formulário manualmente e o envie.

  • start_claim_process() para navegar até o formulário correto.
  • populate_product_details(serial_number, purchase_date) para inserir as informações específicas do produto e da data.
  • describe_issue(issue_description) para preencher o campo de texto longo com a descrição da falha do comando do usuário.
  • populate_contact_info(name, email, phone)

Ao fornecer ferramentas WebMCP nesse caso, estamos ajudando os usuários com agentes a navegar pelo site sem precisar entender onde encontrar um formulário de solicitação de garantia. Charlie conseguiu concluir a jornada do usuário sem precisar entender detalhadamente a estrutura do site.

Solicitação de serviços de eventos

Charlie e Jesse vão se casar em setembro e querem contratar um buffet. Há dezenas de buffets disponíveis na área deles, e eles querem garantir que cada solicitação tenha as informações necessárias e peça o mesmo tipo de serviço.

Charlie pergunta ao agente:

"Você pode enviar uma consulta para buffets com sede em Springfield para nosso casamento em 8 de setembro de 2026? Queremos um cardápio vegetariano para 100 convidados. Dois dos nossos convidados têm restrições alimentares e vão precisar de refeições especiais, incluindo uma refeição kosher e uma refeição sem glúten. Queremos incluir apenas cerveja e vinho".

Ajude o agente de Charlie a enviar uma consulta à sua empresa de buffet adicionando estas ferramentas:

  • start_event_request()
  • create_wedding_reception(guests=100,date="September 8, 2026")
  • add_dietary_restrictions(restrictions=["kosher","gluten-free"], guests = 2)
  • select_drink_package(package = "Light")
  • submit_event_request()

Ajudar os usuários a filtrar informações

Há muitos tipos de sites com grandes coleções de itens que têm filtros complexos. Pode haver centenas ou milhares de anúncios, cada um com uma combinação exclusiva de recursos que podem ser procurados por um usuário. Por exemplo, isso pode incluir sites de aluguel de imóveis, fontes de reserva de hotéis e sites de ingressos.

Nesta seção, vamos ajudar Dana a encontrar opções relevantes para as preferências específicas dela.

Encontrar anúncios de imóveis relevantes

Dana está se mudando para uma nova cidade com a família e precisa encontrar um apartamento. Todos os sites de imóveis listam informações diferentes. Alguns têm fotos, outros têm vários tipos diferentes de filtros, incluindo preço, quartos, banheiros e outros recursos. Alguns anúncios têm um local exato, enquanto outros podem listar apenas o bairro.

Dana pergunta ao agente:

Mostre apartamentos disponíveis para aluguel no Brooklyn que estejam a menos de 10 minutos a pé de uma estação de trem A e a menos de uma hora de Tribeca. O apartamento precisa ter pelo menos três quartos e uma lava-louças. Seria bom ter uma lavadora e secadora na unidade ou no prédio. Nosso orçamento é de US $4.500".

Você pode ajudar o agente de Dana a encontrar aluguéis adequados e relevantes adicionando uma filtragem amigável ao agente no site de anúncios:

search(
  max-price=4500,
  location="Brooklyn",
  features=["dishwasher"],
  rooms=3,
  optionalFeatures=["washer-dryer"]
)

Aplicar filtros

apply_filters(
  transit="train",
  max_time="1 hour",
  destination="Tribeca"
)

O agente usa essas funções para analisar os metadados da propriedade e garantir que os resultados atendam a todos os requisitos (incluindo 3 quartos e uma lava-louças). Em resposta, o agente retorna um mapa com marcadores que se vinculam a anúncios específicos, a distância total de Tribeca. Os alfinetes estão em uma cor diferente se tiverem o recurso opcional, uma lavadora e secadora, no anúncio.

Reservar viagem

Dana e a esposa dela, Rosario, estão planejando uma viagem para Berlim, na Alemanha. Dana quer encontrar opções de hotéis que atendam aos critérios delas, oferecendo uma estadia confortável a um custo acessível. Dana pergunta ao agente: "Encontre alguns hotéis em Berlim, na Alemanha, com menos de US $300 por noite, com piscina e café da manhã incluídos".

Você é um desenvolvedor de um serviço de reserva de viagens que busca encontrar ótimas ofertas de viagens:

Pesquisar

search_hotels(location = "Berlin", guests = 2)

Aplicar filtros

filter_search_results(max_price=300,amenities=["pool","restaurant"])

O agente de Dana retorna três hotéis que atendem aos critérios e pergunta: "Você quer que eu mostre mais opções? Ou há outros critérios a serem considerados?"

Envie feedback

Quais tipos de jornadas do usuário podem se beneficiar do WebMCP? Há outros recursos que podem ser adicionados às APIs para atender às suas expectativas? Se você testar essas APIs e tiver feedback, gostaríamos de recebê-lo.