Protocolo web agente · AWP 1.0

Convertir un sitio web en un sistema agente.

AWP ofrece a un sitio web dos interfaces de primera clase: una interfaz humana para personas y una interfaz de agente estructurada para agentes de IA. Detrás de ambos, el sitio web puede comprender la intención, coordinar agentes especializados, utilizar herramientas, recordar el contexto, actuar dentro de la política y continuar el trabajo aprobado más allá de la visita original.

DescubrimientoInterfaces dualesCapacidades escritasConfianza y consentimientoA2AEventosSalud

La idea en un minuto.

Su sitio web puede servir tanto a personas como a agentes.

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.

Un sitio web · dos interfaces · un sistema de agente

visitante humano

Una interfaz humana

Un sitio web claro, conversación, formularios, contenido adaptable y aprobaciones diseñadas para una persona.

Aceptar: texto/html

Límite AWP

El sitio web se convierte en un sistema agente.

orquestadorentiende la intención y dirige el trabajo
Agentes especialistassoporte, ventas, contenido, operaciones
Herramientas y memoriadatos comerciales, sesiones, RAG, artefactos
Límite de políticaconfianza, consentimiento, aprobación, auditoría

agente de IA

Una interfaz de agente

Descubrimiento estructurado, capacidades escritas, recursos legibles por máquina, llamadas A2A y eventos asincrónicos.

Aceptar: aplicación/ld+json

Contexto compartido

Ambas interfaces leen los mismos hechos comerciales, políticas, productos y estados de sesión publicados.

Autonomía limitada

La confianza, el consentimiento, la política del propietario y la aprobación determinan lo que cada solicitante puede hacer.

Más allá de la petición

Los eventos, horarios y canales aprobados permiten que el trabajo continúe después de que se cierra la pestaña del navegador.

que cambia

Un sitio web agente puede comprender, actuar, continuar y seguir siendo responsable.

Publicar contenido legible por máquina es el comienzo. AWP se vuelve poderoso cuando el sitio web puede convertir una solicitud en un trabajo gobernado, mantener el contexto de ese trabajo y comunicar el resultado a través de la interfaz o canal adecuado.

entender

Sepa quién pregunta y qué necesita.

AWP distingue a una persona de un agente, transporta el contexto comercial y de sesión y proporciona al tiempo de ejecución la estructura suficiente para enrutar bien la solicitud.

Por ejemplo: Un comprador ve una guía de entrega; su agente de compras lee el precio, la disponibilidad y las capacidades de compra.

actuar

Convierta las capacidades publicadas en trabajo útil.

Las entradas, salidas, requisitos de confianza y efectos secundarios declarados permiten a un agente utilizar el sitio web sin realizar ingeniería inversa en los formularios ni adivinar qué punto final es seguro.

Por ejemplo: Busque un pedido, solicite una cotización, reserve inventario o llame a un agente especializado a través de un contrato escrito.

Continuar

Mantenga vivo el trabajo una vez finalizada la solicitud.

Las sesiones, los flujos de trabajo duraderos, los cronogramas y las suscripciones a eventos permiten que un sitio web continúe con una tarea e informe el progreso posterior a un destino aprobado.

Por ejemplo: Notifique a un agente cuando se liquide un pago, cambie una entrega o esté listo un informe solicitado.

Mantente responsable

Dar a la autonomía un límite operativo visible.

Los niveles de confianza, el consentimiento, los límites de tarifas, la política del propietario, las aprobaciones, el estado y la evidencia de auditoría determinan lo que puede suceder y quién sigue siendo responsable.

Por ejemplo: Los agentes anónimos pueden leer; podrán actuar socios conocidos; Los pasos consiguientes pueden esperar una aprobación explícita.

De la visita al trabajo en curso

Sitios web proactivos que funcionan con su permiso.

Un sitio web convencional espera a que se cargue otra página. Un sistema AWP puede continuar una tarea duradera, reaccionar ante un evento comercial o llegar a un canal aprobado más adelante. El consentimiento, el propósito, el momento, la política del propietario y un rastro de auditoría viajan con esa acción.

01

Descubrir

El agente encuentra /.well-known/awp.json.

02

entender

Lee el manifiesto, los esquemas, las reglas de confianza y los límites.

03

Solicitud

Llama a una capacidad declarada o envía un mensaje A2A escrito.

04

Autorizar

AWP verifica la identidad, la confianza, el consentimiento, la política y los límites de tarifas.

05

actuar

Los agentes de ADK-Rust utilizan herramientas y flujos de trabajo para completar el trabajo.

06

Continuar

Los eventos firmados o los canales aprobados llevan actualizaciones posteriores.

reactivo

Una persona o agente pide algo y recibe una respuesta ahora.

Autónomo

El tiempo de ejecución coordina agentes, herramientas y flujos de trabajo dentro de los permisos declarados y las reglas de finalización.

Proactivo

Un cronograma o evento reanuda el trabajo y envía una actualización a través de un canal consentido.

Arquitectura del sistema AWP

Las personas y los agentes de IA obtienen la experiencia adecuada. Su sitio web se encarga del trabajo.

La arquitectura completa conecta los canales entrantes a la puerta de enlace AWP, separa las interfaces humana y de agente y luego reúne ambas en el mismo orquestador ADK-Rust, agentes especializados, herramientas, memoria, contexto empresarial, pagos y eventos. Un plano de control aplica confianza, consentimiento, aprobación, límites de tarifas, estado y auditoría en todo el sistema.

Arquitectura de referencia AWP

Solicitud entrante → trabajo gobernado → respuesta o seguimiento aprobado

01

Canales

Donde una persona, agente, horario o evento comercial ingresa al sistema.

Navegador del usuario
Agente de IA externo
WhatsApp y SMS
Correo electrónico y Slack
Evento programado
normalizar solicitud · recuperar sesión · identificar al solicitante
02

Puerta de enlace AWP

Un límite independiente del canal para la comunicación entrante y saliente.

Adaptadores de canal
Detección de solicitantes
Continuidad de la sesión
Entrega saliente
elija la interfaz que coincida con el solicitante
03A

Interfaz humana

Una experiencia de sitio web diseñada para una persona.

HTML y interfaz de usuario adaptable
Conversación
Formularios y aprobaciones
Comercio integrado
03B

Interfaz del agente

Una interfaz estable y escrita diseñada para otro agente.

documento de descubrimiento
Manifiesto JSON-LD
Llamadas de capacidad A2A
Recursos y eventos
ambas interfaces invocan el mismo tiempo de ejecución gobernado
04

Tiempo de ejecución del agente ADK-Rust

El sistema de ejecución que comprende la intención, enruta el trabajo, transmite el progreso y preserva el estado.

orquestador

Clasificar intención · elegir flujo de trabajo · especialistas en rutas · combinar resultados

Agente visitante
Agente de soporte
agente de ventas
Agente de contenido
agente de operaciones
05

Capacidades compartidas

Los servicios que todo agente puede utilizar mediante contratos explícitos.

Contexto empresarial
Sesiones y memoria
Herramientas y MCP
RAG y artefactos
Pagos
Entrega de eventos
06

Interfaz de propietario

La superficie de control humano del sistema operativo.

resumen de la mañana
Cola de propuestas
Panel de consentimiento
Contexto empresarial

Plano de control

Aplicado en cada capa

Identidad y confianzaConsentimientoPolítica de propietarioAprobacionesLímites de tarifasAuditoría y salud

Responde ahora

Devuelve HTML, JSON-LD, un resultado de A2A, eventos de progreso o una solicitud de aprobación.

continuar la tarea

Un flujo de trabajo duradero espera la liquidación, la entrega, la revisión u otro evento del sistema.

Comunicarse más tarde

Con consentimiento y política, envíe un evento o mensaje firmado a través de un canal aprobado.

Arquitectura de protocolo

Cinco capas convierten una página web en un sistema de agente operativo.

AWP se puede adoptar progresivamente. Un sitio puede comenzar con descubrimiento y una interfaz legible por máquina, luego agregar llamadas de agentes, eventos, canales, pagos, memoria y orquestación según los necesite el producto.

01

AWP Gateway

Bring every channel into one request model.

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.

02

AWP UI

Serve the right interface from the same resource.

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.

03

A2A communication

Let external agents call the website as an agent.

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.

04

AWP Payments

Carry commerce through an owner-controlled lifecycle.

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.

05

AWP Runtime

Coordinate the website's agents, tools, memory, and controls.

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.

Los eventos cruzan cada capa

Las suscripciones a eventos AWP conllevan cambios como finalización de tareas, liquidación de pagos, estado de entrega, actividad de revisión y transiciones de estado. ADK-Rust firma cargas útiles de webhook con HMAC-SHA256 y espera que los suscriptores manejen la entrega al menos una vez de manera idempotente.

Confianza antes que acción

Cada capacidad tiene una audiencia, un límite y una evidencia.

AWP trata la confianza como parte de la solicitud en lugar de una suposición oculta dentro del código de la aplicación. El tiempo de ejecución puede combinar la identidad del solicitante, registros de consentimiento, política de capacidad, límites de tarifas, aprobación del propietario y eventos firmados antes de que el trabajo cruce un límite significativo.

01

Anónimo

Descubrimiento público y capacidades de lectura publicadas explícitamente.

No credential
02

conocido

Capacidades autenticadas con alcance para una persona que llama o una sesión reconocida.

Bearer token or API key
03

Socio

Acciones de empresa a empresa aprobadas con una lista de permitidos y una política más sólida.

Verified partner identity
04

Interno

Comunicación agente-malla y trabajo operativo autorizado por el propietario.

Inside the trusted runtime

El dueño mantiene el control.

La política empresarial define lo que puede suceder automáticamente, lo que necesita consentimiento y lo que debe esperar aprobación. Los resúmenes operativos, las colas de propuestas, las señales de estado y los registros de auditoría redactados brindan al propietario una interfaz práctica para supervisar el sistema.

El consentimiento se puede capturar, verificar y revocar según el propósito.

Los límites de tarifas aumentan con la relación de confianza.

Las acciones consecuentes pueden detenerse en un estado de aprobación.

Los servicios degradados mantienen disponible una ruta útil que no es LLM.

prueba en vivo

Este sitio web es un agente de IA con el que puedes hablar ahora.

Pregúntele a un agente real del modelo de lenguaje ADK-Rust sobre AWP, cómo podría ayudar a su sitio web o qué puede hacer la implementación actual. La respuesta se genera a partir de su pregunta y se transmite en vivo; la conversación no está escrita.

Ask this website about AWP

Answers come from a live ADK-Rust agent.

Ready for your question
Or try:

Answer

Ask a question above. The answer will appear here as the agent writes it.

Inspeccionar la interfaz detrás de la conversación.

Vea cómo los agentes de IA descubren y llaman a este sitio web.

La guía del modelo de lenguaje explica AWP en forma conversacional. Estas solicitudes en vivo muestran la interfaz subyacente del sitio web: cómo otro agente de IA encuentra el sitio, comprende lo que ofrece, lee la información aprobada, llama a la Guía del sitio web y verifica el estado del servicio.

Live AWP interfaceThis website · real responses · safe public surface

Request

GET /.well-known/awp.json

Accept

application/awp+json

Status

Example response

application/awp+json·preview·AWP-Version: 1.0
{
  "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"]
}

Límite publicado

Este sitio expone niveles de confianza anónimos y conocidos, capacidades de catálogo de solo lectura, validación estricta de versiones y mensajes, limitación de velocidad, estado y auditoría redactada. Su documento de descubrimiento marca explícitamente eventos, pagos y canales externos como deshabilitados. Esas capacidades existen en el modelo AWP más amplio y en las cajas compatibles con ADK-Rust, pero esta demostración pública no pretende habilitarlas.

Abierto por diseño

AWP le da al sitio web una función junto con otros protocolos de agentes.

AWP no necesita reemplazar los protocolos que ya utiliza un agente. Le brinda al sitio web un límite estable de descubrimiento, experiencia, confianza y ciclo de vida, luego lo compone con protocolos especializados detrás o a través de ese límite.

MCP

Proporcionar herramientas y recursos a los agentes del sitio web.

MCP conecta un agente con herramientas, datos, indicaciones y recursos externos. AWP describe y opera el sitio web como un sistema de cara al agente; sus agentes pueden utilizar MCP detrás de ese límite.

A2A

Delegar el trabajo entre los agentes desplegados.

A2A lleva una tarea de un agente a otro. AWP utiliza un punto final A2A como una forma en que un agente externo puede llamar a las capacidades declaradas del sitio web.

ACP / AP2 / UCP

Comercio completo a través de protocolos especializados.

Los protocolos comerciales se centran en productos, pago, mandatos y autorización de pago. AWP coloca esas capacidades dentro de la relación más amplia del sitio web, el modelo de confianza y el ciclo de vida del evento.

HTML + Schema.org

Mantenga la web pública útil para personas y máquinas.

HTML sigue siendo la superficie humana y JSON-LD describe los recursos públicos. AWP agrega descubrimiento, capacidades invocables, confianza, comunicación con agentes, eventos y estado operativo.

Implementación de referencia ADK-Rust

Agregue una superficie AWP escrita a una aplicación Axum.

La caja tipo awp suministra contratos de cables ligeros de dependencia. La caja adk-awp agrega carga de contexto empresarial, descubrimiento y generación de manifiestos, rutas Axum, negociación de versiones, detección de solicitantes, asignación de confianza, limitación de tasa por confianza, servicios de consentimiento, suscripciones a eventos firmados y monitoreo del estado.

business.toml · declarar el sitio
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"
main.rs · montar el protocolo
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);

Comience con el descubrimiento

Publique el documento conocido y un manifiesto de capacidad antes de agregar acciones.

Agregar el límite del producto

Conecte capacidades con agentes, flujos de trabajo, herramientas, estados y autorizaciones reales.

Operar la relación

Agregue consentimiento, eventos, estado, telemetría, aprobación del propietario y canales según sea necesario.

Construido para ambos usuarios de la web.

Mejore el sitio web que la gente conoce con AI Agents. Ofrezca a los agentes de IA una interfaz en la que puedan confiar.

Comience con un documento de descubrimiento veraz y una capacidad de lectura útil. Conéctelo al mismo contexto empresarial que la página humana, luego agregue acciones, flujos de trabajo, consentimiento, eventos, canales y controles de propietario a medida que el sitio web se convierta en un sistema de agentes proactivo.