AWP oferece a um site duas interfaces de primeira classe: uma interface humana para pessoas e uma interface de agente estruturada para agentes de IA. Por trás de ambos, o site pode compreender a intenção, coordenar agentes especializados, usar ferramentas, lembrar o contexto, agir dentro da política e continuar o trabalho aprovado além da visita original.
A ideia em um minuto
The web now has a second kind of customer: AI assistants acting for people. Thales reports that automated systems represented 53% of observed web traffic in 2025, Bain finds that roughly 60% of searches end without a visit to another website, and McKinsey estimates AI-assisted shopping could influence $900 billion to $1 trillion of US retail revenue by 2030. Most websites still speak only to people, so an AI assistant must read pages, click around, and guess what the business allows. That creates missed customers, incorrect answers, and lost opportunities.
AWP gives your website a second front door designed for AI assistants. People continue to see the website, explanations, conversations, and choices they already understand. An AI assistant receives a clear guide to what your business offers, which information is current, what it can help a customer do, what details it needs, and when it must ask for permission. The assistant can work with your business proactively.
ADK-Rust provides the engine that makes this practical. Start by letting AI assistants read approved information and complete one useful task. As your needs grow, the website can coordinate specialist AI helpers, remember ongoing work, complete bookings or purchases, send requested updates, and ask a person to approve sensitive actions. You keep control of your website, your business rules, your data, and the customer relationship.
Um site · duas interfaces · um sistema de agente
Visitante humano
Um site claro, conversas, formulários, conteúdo adaptável e aprovações projetadas para uma pessoa.
Aceitar: texto/htmlLimite AWP
agente de IA
Descoberta estruturada, recursos tipados, recursos legíveis por máquina, chamadas A2A e eventos assíncronos.
Aceitar: aplicação/ld+jsonAmbas as interfaces leem os mesmos fatos comerciais, políticas, produtos e estado de sessão publicados.
Confiança, consentimento, política do proprietário e aprovação determinam o que cada solicitante pode fazer.
Eventos, programações e canais aprovados permitem que o trabalho continue após o fechamento da guia do navegador.
O que muda
Publicar conteúdo legível por máquina é o começo. AWP torna-se poderoso quando o site pode transformar uma solicitação em trabalho governado, manter o contexto desse trabalho e comunicar o resultado por meio da interface ou canal correto.
Entenda
AWP distingue uma pessoa de um agente, carrega o contexto de sessão e de negócios e fornece ao tempo de execução estrutura suficiente para rotear bem a solicitação.
Por exemplo: Um comprador vê orientações de entrega; seu agente de compras lê preço, disponibilidade e recursos de compra.
Agir
Entradas, saídas, requisitos de confiança e efeitos colaterais declarados permitem que um agente use o site sem fazer engenharia reversa de formulários ou adivinhar qual endpoint é seguro.
Por exemplo: Consulte um pedido, solicite um orçamento, reserve estoque ou ligue para um agente especializado por meio de um contrato tipado.
Continuar
Sessões, fluxos de trabalho duráveis, programações e assinaturas de eventos permitem que um site continue uma tarefa e relate o progresso posterior para um destino aprovado.
Por exemplo: Notifique um agente quando um pagamento for liquidado, uma entrega for alterada ou um relatório solicitado estiver pronto.
Mantenha-se responsável
Níveis de confiança, consentimento, limites de taxas, política do proprietário, aprovações, integridade e evidências de auditoria determinam o que pode acontecer e quem permanece responsável.
Por exemplo: Agentes anônimos podem ler; parceiros conhecidos podem agir; etapas consequentes podem esperar por aprovação explícita.
Da visita ao trabalho em andamento
Um site convencional aguarda o carregamento de outra página. Um sistema AWP pode continuar uma tarefa durável, reagir a um evento de negócios ou alcançar um canal aprovado posteriormente. Consentimento, propósito, prazo, política do proprietário e uma trilha de auditoria acompanham essa ação.
O agente encontra /.well-known/awp.json.
Ele lê o manifesto, esquemas, regras de confiança e limites.
Ele chama uma capacidade declarada ou envia uma mensagem tipada A2A.
AWP verifica identidade, confiança, consentimento, política e limites de taxa.
Os agentes ADK-Rust usam ferramentas e fluxos de trabalho para concluir o trabalho.
Eventos assinados ou canais aprovados trazem atualizações posteriores.
Uma pessoa ou agente pede algo e recebe uma resposta agora.
O tempo de execução coordena agentes, ferramentas e fluxos de trabalho dentro de permissões declaradas e regras de conclusão.
Uma programação ou evento retoma o trabalho e envia uma atualização por meio de um canal consentido.
Arquitetura do sistema AWP
A arquitetura completa conecta canais de entrada ao gateway AWP, separa as interfaces humana e de agente e, em seguida, traz ambas para o mesmo orquestrador ADK-Rust, agentes especializados, ferramentas, memória, contexto de negócios, pagamentos e eventos. Um plano de controle aplica confiança, consentimento, aprovação, limites de taxa, integridade e auditoria em todo o sistema.
Arquitetura de referência AWP
Solicitação de entrada → trabalho governado → resposta ou acompanhamento aprovado
Onde uma pessoa, agente, agendamento ou evento de negócios entra no sistema.
Um limite independente de canal para comunicação de entrada e saída.
Uma experiência de site projetada para uma pessoa.
Uma interface estável e tipada projetada para outro agente.
O sistema de execução que entende a intenção, roteia o trabalho, transmite o progresso e preserva o estado.
Orquestrador
Classificar intenção · escolher fluxo de trabalho · rotear especialistas · combinar resultados
Os serviços que cada agente pode utilizar através de contratos explícitos.
A superfície de controle humano para o sistema operacional.
Plano de controle
Aplicado em todas as camadas
Retorne HTML, JSON-LD, um resultado A2A, eventos de progresso ou uma solicitação de aprovação.
Um fluxo de trabalho durável aguarda liquidação, entrega, revisão ou outro evento do sistema.
Com consentimento e política, envie um evento ou mensagem assinada por meio de um canal aprovado.
Arquitetura de protocolo
AWP é progressivamente adotável. Um site pode começar com descoberta e uma interface legível por máquina e, em seguida, adicionar chamadas de agente, eventos, canais, pagamentos, memória e orquestração conforme o produto precisar.
AWP Gateway
What it is
Normalizes browser, agent, messaging, email, and other channel traffic into a common request envelope while maintaining session continuity.
Why it matters
Business logic should not be rewritten for every place a person or agent starts a conversation.
How it works
Channel adapters identify the requester, recover the session, attach metadata, and forward one typed request to the runtime.
When to use it
Add it when the same business must work across the website, A2A clients, WhatsApp, Slack, email, or future channels.
AWP UI
What it is
Returns a human interface for browsers and a structured resource or capability manifest for agents.
Why it matters
People need explanation and interaction design. Agents need stable data, schemas, endpoints, and constraints.
How it works
Content negotiation and explicit AWP headers select HTML, JSON-LD, or an agent-oriented response without creating a separate shadow website.
When to use it
Start here when agents currently scrape pages or depend on brittle DOM interpretation.
A2A communication
What it is
Carries typed requests, responses, notifications, and errors between the website's agent system and other independently deployed agents.
Why it matters
A capability becomes much more useful when another agent can request work and receive a structured result.
How it works
AWP publishes an A2A endpoint, validates the message envelope and replay window, applies trust policy, then routes the task to an agent or workflow.
When to use it
Use it for delegated research, booking, support, procurement, quoting, and other multi-system tasks.
AWP Payments
What it is
Models payment intent, approval, execution, settlement, rejection, and cancellation as explicit states.
Why it matters
An agent should be able to transact without bypassing consent, spending policy, or human accountability.
How it works
Signed intents and policy thresholds decide which requests can proceed and which require owner confirmation before a payment provider is called.
When to use it
Add it when agents can buy, sell, reserve, subscribe, refund, or move money on behalf of someone.
AWP Runtime
What it is
Runs the orchestrator and specialist agents, manages shared context, streams events, invokes tools, and records the execution trail.
Why it matters
The two interfaces need one dependable system behind them or the human and agent experiences will drift apart.
How it works
ADK-Rust supplies typed agents, workflows, sessions, tools, RAG, artifacts, protocols, telemetry, and operating controls in one async runtime.
When to use it
Use the full runtime when the website must reason, coordinate, remember, act, and operate as a production agent system.
Os eventos atravessam todas as camadas
As assinaturas de eventos AWP trazem alterações como conclusão de tarefas, liquidação de pagamentos, status de entrega, atividade de revisão e transições de saúde. ADK-Rust assina cargas úteis de webhook com HMAC-SHA256 e espera que os assinantes lidem com a entrega pelo menos uma vez de forma idempotente.
Confie antes da ação
AWP trata a confiança como parte da solicitação, em vez de uma suposição oculta no código do aplicativo. O tempo de execução pode combinar identidade do solicitante, registros de consentimento, política de capacidade, limites de taxa, aprovação do proprietário e eventos assinados antes que o trabalho cruze um limite significativo.
Descoberta pública e recursos de leitura publicados explicitamente.
No credentialRecursos autenticados com escopo para um chamador ou sessão reconhecida.
Bearer token or API keyAções entre empresas aprovadas com uma lista de permissões e uma política mais forte.
Verified partner identityComunicação entre agente e malha e trabalho operacional autorizado pelo proprietário.
Inside the trusted runtimeA política empresarial define o que pode acontecer automaticamente, o que precisa de consentimento e o que deve aguardar aprovação. Resumos operacionais, filas de propostas, sinais de saúde e registros de auditoria editados fornecem ao proprietário uma interface prática para supervisionar o sistema.
O consentimento pode ser capturado, verificado e revogado por finalidade.
Os limites das taxas aumentam com a relação de confiança.
Ações consequentes podem parar em um estado de aprovação.
Os serviços degradados mantêm disponível um caminho útil não LLM.
Prova ao vivo
Pergunte a um verdadeiro agente de modelo de linguagem ADK-Rust sobre AWP, como ele poderia ajudar seu site ou o que a implementação atual pode fazer. A resposta é gerada a partir da sua pergunta e transmitida ao vivo – a conversa não é programada.
Answers come from a live ADK-Rust agent.
Ask a question above. The answer will appear here as the agent writes it.
Inspecione a interface por trás da conversa
O guia do modelo de linguagem explica AWP de forma coloquial. Essas solicitações ativas mostram a interface subjacente do site: como outro agente de IA encontra o site, entende o que ele oferece, lê as informações aprovadas, liga para o Guia do site e verifica a integridade do serviço.
Request
GET /.well-known/awp.json
Accept
application/awp+json
Status
Example response
{
"version": { "major": 1, "minor": 0 },
"siteName": "ADK-Rust",
"capabilityManifestUrl": "https://adk-rust.com/awp/manifest",
"a2aEndpointUrl": "https://adk-rust.com/awp/a2a",
"supportedTrustLevels": ["anonymous", "known"],
"disabledCapabilities": ["events", "payments", "external_channels"]
}/.well-known/awp.jsonPublica AWP versão 1.0 e os endpoints canônicos do site.
/awp/manifestDescreve entradas, saídas, confiança, limites, evidências e efeitos colaterais.
/en/frameworkRetorna HTML para um navegador e JSON-LD para uma solicitação explícita do agente.
/awp/catalogExpõe o catálogo revisado utilizado pelo site humano.
POST/awp/a2aExecuta buscas validadas no framework, na documentação e no catálogo. Tarefas completas de agentes remotos usam a interface A2A separada.
/awp/healthRelata a versão do protocolo, a integridade dos componentes e o comportamento degradado.
Limite publicado
Este site expõe níveis de confiança anônimos e conhecidos, recursos de catálogo somente leitura, versão estrita e validação de mensagens, limitação de taxa, integridade e auditoria redigida. Seu documento de descoberta marca explicitamente eventos, pagamentos e canais externos como desativados. Esses recursos existem no modelo AWP mais amplo e no suporte às caixas ADK-Rust, mas esta demonstração pública não pretende habilitá-los.
Aberto por design
AWP não precisa substituir os protocolos que um agente já usa. Ele fornece ao site uma descoberta estável, experiência, confiança e limite de ciclo de vida e, em seguida, compõe protocolos especializados atrás ou além desse limite.
MCP
MCP conecta um agente a ferramentas, dados, prompts e recursos externos. AWP descreve e opera o site como um sistema voltado para o agente; seus agentes podem usar MCP atrás desse limite.
A2A
A2A transporta uma tarefa de um agente para outro. AWP usa um endpoint A2A como uma forma de um agente externo chamar os recursos declarados do site.
ACP/AP2/UCP
Os protocolos de comércio concentram-se em produtos, checkout, mandatos e autorização de pagamento. AWP coloca esses recursos dentro do relacionamento mais amplo do site, do modelo de confiança e do ciclo de vida do evento.
HTML + Schema.org
HTML continua sendo a superfície humana e JSON-LD descreve recursos públicos. AWP adiciona descoberta, recursos de chamada, confiança, comunicação de agente, eventos e integridade operacional.
Implementação de referência ADK-Rust
A caixa do tipo awp fornece contratos de fio leve de dependência. A caixa adk-awp adiciona carregamento de contexto de negócios, descoberta e geração de manifesto, rotas Axum, negociação de versão, detecção de solicitante, atribuição de confiança, limitação de taxa por confiança, serviços de consentimento, assinaturas de eventos assinados e monitoramento de integridade.
site_name = "My Business"
site_description = "Human service with an AWP agent interface"
domain = "example.com"
[[capabilities]]
name = "get_quote"
description = "Create a quote from published pricing"
endpoint = "/awp/a2a"
method = "POST"
access_level = "known"use adk_awp::{AwpState, BusinessContextLoader, awp_routes};
let loader = BusinessContextLoader::from_file("business.toml".as_ref())?;
let state = AwpState::builder(loader.context_ref()).build();
let app = axum::Router::new()
.merge(awp_routes(state))
.merge(your_human_site);Publique o documento conhecido e um manifesto de capacidade antes de adicionar ações.
Conecte recursos a agentes, fluxos de trabalho, ferramentas, estado e autorização reais.
Adicione consentimento, eventos, integridade, telemetria, aprovação do proprietário e canais conforme necessário.
Crie para ambos os usuários da web
Comece com um documento de descoberta verdadeiro e um recurso de leitura útil. Conecte-o ao mesmo contexto de negócios da página humana e, em seguida, adicione ações, fluxos de trabalho, consentimento, eventos, canais e controles de proprietário à medida que o site se transforma em um sistema de agente proativo.