了解
了解谁在提出请求以及他们需要什么。
AWP 将人员与代理区分开来,携带会话和业务上下文,并为运行时提供足够的结构来很好地路由请求。
例如: 买家看到送货指南;他们的采购代理会读取价格、供货情况和购买能力。
AWP 为一个网站提供了两个一流的界面:用于人员的人机界面和用于 AI 智能体的结构化代理界面。在这两者的背后,网站可以理解意图、协调专家代理、使用工具、记住上下文、在政策范围内采取行动,并在原始访问之外继续批准的工作。
一分钟内的想法
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.
一个网站·两个界面·一套代理系统
人类访客
专为个人设计的清晰网站、对话、表单、自适应内容和审批。
接受:文本/htmlAWP边界
AI 智能体
结构化发现、类型化功能、机器可读资源、A2A 调用和异步事件。
接受:application/ld+json两个界面读取相同的已发布业务事实、策略、产品和会话状态。
信任、同意、所有者策略和批准决定每个请求者可以做什么。
事件、时间表和批准的频道让工作在浏览器选项卡关闭后继续进行。
有什么变化
发布机器可读的内容只是一个开始。当网站可以将请求转化为受管理的工作、保留该工作的上下文并通过正确的界面或渠道传达结果时,AWP 就会变得强大。
了解
AWP 将人员与代理区分开来,携带会话和业务上下文,并为运行时提供足够的结构来很好地路由请求。
例如: 买家看到送货指南;他们的采购代理会读取价格、供货情况和购买能力。
法案
声明的输入、输出、信任要求和副作用让代理可以使用网站,而无需进行逆向工程表单或猜测哪个端点是安全的。
例如: 查找订单、请求报价、预留库存或通过打印合同致电专业代理。
继续
会话、持久工作流程、日程安排和事件订阅让网站可以继续执行任务并将后续进度报告给批准的目的地。
例如: 当付款结算、交付更改或请求的报告准备就绪时通知代理。
保持责任感
信任级别、同意、速率限制、所有者政策、批准、健康状况和审计证据决定了可能发生的情况以及谁负责。
例如: 匿名代理可以阅读;已知的合作伙伴可能会采取行动;后续步骤可以等待明确批准。
从访问到正在进行的工作
传统网站等待另一个页面加载。 AWP 系统可以继续持久任务、对业务事件做出反应或稍后到达批准的通道。同意、目的、时间安排、所有者政策和审计跟踪随该操作一起进行。
代理找到/.wellknown/awp.json。
它读取清单、模式、信任规则和限制。
它调用声明的功能或发送类型化的 A2A 消息。
AWP 检查身份、信任、同意、策略和速率限制。
ADK-Rust 代理使用工具和工作流程来完成工作。
签名活动或批准的频道会进行后续更新。
某人或代理人提出请求并立即收到响应。
运行时在声明的权限和完成规则内协调代理、工具和工作流。
计划或事件恢复工作并通过同意的渠道发送更新。
AWP系统架构
完整的架构将入站通道连接到 AWP 网关,将人员和座席界面分开,然后将两者引入相同的 ADK-Rust 编排器、专家座席、工具、内存、业务环境、支付和事件。控制平面在整个系统中应用信任、同意、批准、速率限制、运行状况和审计。
AWP参考架构
入站请求 → 受监管的工作 → 响应或批准的后续行动
人员、代理、日程安排或业务事件进入系统的位置。
用于入站和出站通信的一种独立于通道的边界。
专为个人设计的网站体验。
为另一个代理设计的稳定的类型化界面。
理解意图、路由工作、流式传输进度并保留状态的执行系统。
协调者
分类意图·选择工作流程·路线专家·组合结果
每个代理都可以通过明确的合同使用这些服务。
操作系统的人类控制界面。
控制平面
应用于每一层
返回 HTML、JSON-LD、A2A 结果、进度事件或批准请求。
持久的工作流程等待结算、交付、审核或其他系统事件。
在同意并遵守政策的情况下,通过批准的渠道发送签名的事件或消息。
协议架构
AWP正在逐步采用。站点可以从发现和机器可读界面开始,然后根据产品需要添加代理调用、事件、渠道、支付、内存和编排。
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.
事件跨越每一层
AWP事件订阅携带任务完成、支付结算、交付状态、审核活动、健康状态转变等变化。 ADK-Rust 使用 HMAC-SHA256 签署 Webhook 有效负载,并期望订阅者能够幂等地处理至少一次传递。
先信任后行动
AWP 将信任视为请求的一部分,而不是隐藏在应用程序代码中的假设。在工作跨越有意义的边界之前,运行时可以结合请求者身份、同意记录、功能策略、速率限制、所有者批准和签名事件。
公开发现和明确发布的读取功能。
No credential经过身份验证的功能范围仅限于已识别的调用者或会话。
Bearer token or API key通过许可名单和更严格的政策批准企业对企业的行动。
Verified partner identity代理网状通信和所有者授权的操作工作。
Inside the trusted runtime业务策略定义什么可以自动发生、什么需要同意以及什么必须等待批准。操作摘要、提案队列、运行状况信号和经过编辑的审计记录为所有者提供了一个用于监督系统的实用界面。
可以根据目的获取、检查和撤销同意。
速率限制随着信任关系的增加而增加。
后续操作可以停止在批准状态。
降级服务会保留有用的非 LLM 路径可用。
现场证明
向真正的 ADK-Rust 语言模型代理询问 AWP、它如何帮助您的网站,或者当前的实现可以做什么。答案是根据您的问题生成的,并进行现场直播——对话不是有脚本的。
Answers come from a live ADK-Rust agent.
Ask a question above. The answer will appear here as the agent writes it.
检查对话背后的界面
语言模型指南以对话方式解释 AWP。这些实时请求显示了底层网站界面:另一个人工智能代理如何找到该网站、了解其提供的内容、读取批准的信息、调用网站指南以及检查服务运行状况。
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.json发布 AWP 1.0 版和站点的规范端点。
/awp/manifest描述输入、输出、信任、限制、证据和副作用。
/en/framework将 HTML 返回到浏览器并将 JSON-LD 返回到显式代理请求。
/awp/catalog公开人类网站使用的已审查目录。
POST/awp/a2a执行经过验证的框架、文档和目录查询。完整的远程智能体任务使用独立的 A2A 接口。
/awp/health报告协议版本、组件运行状况和降级行为。
已发布边界
该站点公开匿名和已知的信任级别、只读目录功能、严格的版本和消息验证、速率限制、运行状况和编辑审核。其发现文档明确将事件、支付和外部渠道标记为禁用。这些功能存在于更广泛的 AWP 模型中并支持 ADK-Rust 板条箱,但此公开演示并不假装启用它们。
按设计开放
AWP 不需要替换代理已经使用的协议。它为网站提供了稳定的发现、体验、信任和生命周期边界,然后与该边界后面或跨越该边界的专用协议组合。
MCP
MCP 将代理连接到外部工具、数据、提示和资源。 AWP 将网站描述为面向代理的系统并进行操作;它的代理可以在该边界后面使用 MCP。
A2A
A2A 将任务从一个代理转移到另一个代理。 AWP 使用 A2A 端点作为外部代理调用网站声明的功能的一种方式。
ACP / AP2 / UCP
商务协议侧重于产品、结账、授权和支付授权。 AWP 将这些功能置于更广泛的网站关系、信任模型和事件生命周期中。
HTML + Schema.org
HTML 仍然是人性化的表面,JSON-LD 描述公共资源。 AWP 添加了发现、可调用功能、信任、代理通信、事件和操作运行状况。
ADK-Rust参考实现
awp 类型的板条箱提供依赖轻线合约。 adk-awp 箱添加了业务上下文加载、发现和清单生成、Axum 路由、版本协商、请求者检测、信任分配、每个信任速率限制、同意服务、签名事件订阅和运行状况监控。
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);在添加操作之前发布众所周知的文档和功能清单。
将功能连接到真实的代理、工作流程、工具、状态和授权。
根据需要添加同意、事件、运行状况、遥测、所有者批准和渠道。
为网络用户构建
从一份真实的发现文档和一项有用的阅读能力开始。将其连接到与人员页面相同的业务上下文,然后随着网站发展成为主动代理系统,添加操作、工作流程、同意、事件、渠道和所有者控制。