代理网络协议·AWP 1.0

将网站变成 代理系统。

AWP 为一个网站提供了两个一流的界面:用于人员的人机界面和用于 AI 智能体的结构化代理界面。在这两者的背后,网站可以理解意图、协调专家代理、使用工具、记住上下文、在政策范围内采取行动,并在原始访问之外继续批准的工作。

发现双接口类型化功能信任与同意A2A活动健康

一分钟内的想法

您的网站可以为个人和代理商提供服务。

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.

一个网站·两个界面·一套代理系统

人类访客

人性化界面

专为个人设计的清晰网站、对话、表单、自适应内容和审批。

接受:文本/html

AWP边界

网站成为一个代理系统

协调者了解意图并安排工作路线
专业代理支持、销售、内容、运营
工具和记忆业务数据、会话、RAG、工件
政策边界信任、同意、批准、审核

AI 智能体

代理界面

结构化发现、类型化功能、机器可读资源、A2A 调用和异步事件。

接受:application/ld+json

共享上下文

两个界面读取相同的已发布业务事实、策略、产品和会话状态。

有限的自主权

信任、同意、所有者策略和批准决定每个请求者可以做什么。

超出要求

事件、时间表和批准的频道让工作在浏览器选项卡关闭后继续进行。

有什么变化

代理网站可以理解、采取行动、继续并承担责任。

发布机器可读的内容只是一个开始。当网站可以将请求转化为受管理的工作、保留该工作的上下文并通过正确的界面或渠道传达结果时,AWP 就会变得强大。

了解

了解谁在提出请求以及他们需要什么。

AWP 将人员与代理区分开来,携带会话和业务上下文,并为运行时提供足够的结构来很好地路由请求。

例如: 买家看到送货指南;他们的采购代理会读取价格、供货情况和购买能力。

法案

将已发布的功能转化为有用的工作。

声明的输入、输出、信任要求和副作用让代理可以使用网站,而无需进行逆向工程表单或猜测哪个端点是安全的。

例如: 查找订单、请求报价、预留库存或通过打印合同致电专业代理。

继续

请求结束后保持作业处于活动状态。

会话、持久工作流程、日程安排和事件订阅让网站可以继续执行任务并将后续进度报告给批准的目的地。

例如: 当付款结算、交付更改或请求的报告准备就绪时通知代理。

保持责任感

给自主权一个可见的操作边界。

信任级别、同意、速率限制、所有者政策、批准、健康状况和审计证据决定了可能发生的情况以及谁负责。

例如: 匿名代理可以阅读;已知的合作伙伴可能会采取行动;后续步骤可以等待明确批准。

从访问到正在进行的工作

在您许可的情况下运行的主动网站。

传统网站等待另一个页面加载。 AWP 系统可以继续持久任务、对业务事件做出反应或稍后到达批准的通道。同意、目的、时间安排、所有者政策和审计跟踪随该操作一起进行。

01

发现

代理找到/.wellknown/awp.json。

02

了解

它读取清单、模式、信任规则和限制。

03

请求

它调用声明的功能或发送类型化的 A2A 消息。

04

授权

AWP 检查身份、信任、同意、策略和速率限制。

05

法案

ADK-Rust 代理使用工具和工作流程来完成工作。

06

继续

签名活动或批准的频道会进行后续更新。

反应性

某人或代理人提出请求并立即收到响应。

自治

运行时在声明的权限和完成规则内协调代理、工具和工作流。

积极主动

计划或事件恢复工作并通过同意的渠道发送更新。

AWP系统架构

人和人工智能代理获得正确的体验。您的网站负责处理这项工作。

完整的架构将入站通道连接到 AWP 网关,将人员和座席界面分开,然后将两者引入相同的 ADK-Rust 编排器、专家座席、工具、内存、业务环境、支付和事件。控制平面在整个系统中应用信任、同意、批准、速率限制、运行状况和审计。

AWP参考架构

入站请求 → 受监管的工作 → 响应或批准的后续行动

01

渠道

人员、代理、日程安排或业务事件进入系统的位置。

用户浏览器
外部人工智能代理
WhatsApp & SMS
电子邮件 & Slack
预定活动
规范化请求 · 恢复会话 · 识别请求者
02

AWP网关

用于入站和出站通信的一种独立于通道的边界。

通道适配器
请求者检测
会话连续性
外向交货
选择与请求者匹配的接口
03A

人机界面

专为个人设计的网站体验。

HTML 和自适应 UI
对话
表格和批准
嵌入式商务
03B

代理接口

为另一个代理设计的稳定的类型化界面。

发现文件
JSON-LD 清单
A2A 能力调用
资源和活动
两个接口调用相同的受控运行时
04

ADK-Rust 代理运行时

理解意图、路由工作、流式传输进度并保留状态的执行系统。

协调者

分类意图·选择工作流程·路线专家·组合结果

访客代理
支持代理
销售代理
内容代理
运营代理
05

共享能力

每个代理都可以通过明确的合同使用这些服务。

业务背景
会话和内存
工具&MCP
RAG & 文物
付款方式
活动交付
06

车主界面

操作系统的人类控制界面。

早间文摘
提案队列
同意仪表板
业务背景

控制平面

应用于每一层

身份与信任同意业主政策批准速率限制审计与健康

立即回复

返回 HTML、JSON-LD、A2A 结果、进度事件或批准请求。

继续任务

持久的工作流程等待结算、交付、审核或其他系统事件。

稍后再联系

在同意并遵守政策的情况下,通过批准的渠道发送签名的事件或消息。

协议架构

五层将网页转变为操作系统代理系统。

AWP正在逐步采用。站点可以从发现和机器可读界面开始,然后根据产品需要添加代理调用、事件、渠道、支付、内存和编排。

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.

事件跨越每一层

AWP事件订阅携带任务完成、支付结算、交付状态、审核活动、健康状态转变等变化。 ADK-Rust 使用 HMAC-SHA256 签署 Webhook 有效负载,并期望订阅者能够幂等地处理至少一次传递。

先信任后行动

每项能力都有受众、边界和证据。

AWP 将信任视为请求的一部分,而不是隐藏在应用程序代码中的假设。在工作跨越有意义的边界之前,运行时可以结合请求者身份、同意记录、功能策略、速率限制、所有者批准和签名事件。

01

匿名

公开发现和明确发布的读取功能。

No credential
02

已知

经过身份验证的功能范围仅限于已识别的调用者或会话。

Bearer token or API key
03

合伙人

通过许可名单和更严格的政策批准企业对企业的行动。

Verified partner identity
04

内部

代理网状通信和所有者授权的操作工作。

Inside the trusted runtime

业主仍保持控制权。

业务策略定义什么可以自动发生、什么需要同意以及什么必须等待批准。操作摘要、提案队列、运行状况信号和经过编辑的审计记录为所有者提供了一个用于监督系统的实用界面。

可以根据目的获取、检查和撤销同意。

速率限制随着信任关系的增加而增加。

后续操作可以停止在批准状态。

降级服务会保留有用的非 LLM 路径可用。

现场证明

这个网站是一个人工智能代理,你现在可以与之交谈。

向真正的 ADK-Rust 语言模型代理询问 AWP、它如何帮助您的网站,或者当前的实现可以做什么。答案是根据您的问题生成的,并进行现场直播——对话不是有脚本的。

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.

检查对话背后的界面

了解 AI 智能体如何发现并调用该网站。

语言模型指南以对话方式解释 AWP。这些实时请求显示了底层网站界面:另一个人工智能代理如何找到该网站、了解其提供的内容、读取批准的信息、调用网站指南以及检查服务运行状况。

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"]
}

已发布边界

该站点公开匿名和已知的信任级别、只读目录功能、严格的版本和消息验证、速率限制、运行状况和编辑审核。其发现文档明确将事件、支付和外部渠道标记为禁用。这些功能存在于更广泛的 AWP 模型中并支持 ADK-Rust 板条箱,但此公开演示并不假装启用它们。

按设计开放

AWP 为网站提供了与其他代理协议并列的角色。

AWP 不需要替换代理已经使用的协议。它为网站提供了稳定的发现、体验、信任和生命周期边界,然后与该边界后面或跨越该边界的专用协议组合。

MCP

为网站代理提供工具和资源。

MCP 将代理连接到外部工具、数据、提示和资源。 AWP 将网站描述为面向代理的系统并进行操作;它的代理可以在该边界后面使用 MCP。

A2A

在部署的代理之间委派工作。

A2A 将任务从一个代理转移到另一个代理。 AWP 使用 A2A 端点作为外部代理调用网站声明的功能的一种方式。

ACP / AP2 / UCP

通过专门的协议完成商业。

商务协议侧重于产品、结账、授权和支付授权。 AWP 将这些功能置于更广泛的网站关系、信任模型和事件生命周期中。

HTML + Schema.org

保持公共网络对人和机器有用。

HTML 仍然是人性化的表面,JSON-LD 描述公共资源。 AWP 添加了发现、可调用功能、信任、代理通信、事件和操作运行状况。

ADK-Rust参考实现

将类型化的 AWP 曲面添加到 Axum 应用程序。

awp 类型的板条箱提供依赖轻线合约。 adk-awp 箱添加了业务上下文加载、发现和清单生成、Axum 路由、版本协商、请求者检测、信任分配、每个信任速率限制、同意服务、签名事件订阅和运行状况监控。

Business.toml · 声明网站
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 · 挂载协议
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);

从发现开始

在添加操作之前发布众所周知的文档和功能清单。

添加产品边界

将功能连接到真实的代理、工作流程、工具、状态和授权。

经营关系

根据需要添加同意、事件、运行状况、遥测、所有者批准和渠道。

为网络用户构建

使用人工智能代理增强人们所了解的网站。为人工智能代理提供他们可以信任的界面。

从一份真实的发现文档和一项有用的阅读能力开始。将其连接到与人员页面相同的业务上下文,然后随着网站发展成为主动代理系统,添加操作、工作流程、同意、事件、渠道和所有者控制。