AWAS (Tam Tunnel)

AWAS-人工智能网络行动标准


](https://github.com/TamTunnel/awas)

人工智能网络行动标准（AWAS） 是一个开源规范，使Atlas、Comet和其他AI代理等AI浏览器能够通过机器可读的动作定义与网站交互，而不会干扰传统的人类浏览。

• 简单类比： 把它想象成人工智能代理的路标。路标告诉司机该去哪里，而不需要试错导航。AWAS告诉人工智能代理存在什么动作，以及如何在不抓取DOM的情况下使用它们。如果道路有转弯（搜索功能），标志告诉你。AWAS也是如此；如果一个站点有一个操作，清单会明确地描述它。

🎯 问题陈述

当前的人工智能浏览器采用缓慢、脆弱的浏览器自动化，模仿人类点击。这种方法：

• 计算成本高
• UI更改中断
• 不提供语义理解
• 产生高服务器负载
• 用户体验不佳

💡 解决方案

AWAS提供 双界面web架构 哪里：

• 人类用户 通过可视化UI正常浏览
• AI代理 通过结构化、机器可读的操作进行交互

这是通过以下方式实现的：

1. AI行动清单 -可用操作的JSON规范
2. HTML数据属性 -AI代理的内联语义提示
3. 扩展机器人.txt -AI特定的政策和发现
4. 发现端点 -能力协商和元数据
5. 服务器中间件 -请求处理和速率限制

✨ 主要特点

• ✅ 零突破性变化 -与现有的HTML/CSS/JS协同工作
• ✅ 渐进增强 -逐页递增添加
• ✅ 向后兼容的 -传统浏览器不受影响
• ✅ 安全第一 -内置的速率限制、身份验证和权限
• ✅ 开放标准 -免版税，社区驱动
• ✅ 框架无关 -适用于任何后端/前端堆栈
• ✅ OpenAPI互操作性 -链接到现有的OpenAPI/Swagger规范

🔗 互操作性

AWAS的设计目的是 MCP（模型上下文协议）、A2A（代理到代理）、ADK（代理开发工具包）和OpenAPI/Swagger就绪，实现与现代人工智能代理生态系统和现有API基础设施的无缝集成。

协议支持

MCP（模型上下文协议）

AWAS通过以下方式支持MCP .well-known/mcp-manifest.json 对于标准化的AI代理通信：

{
  "name": "awas-site",
  "version": "1.0.0",
  "description": "AWAS-enabled site with MCP support",
  "actions": {
    "discover": "/.well-known/ai-actions.json",
    "execute": "/api/ai-actions/{action_id}"
  },
  "capabilities": ["action-discovery", "action-execution", "state-management"]
}

对于AI代理：

// Discover MCP capabilities
const manifest = await fetch('https://example.com/.well-known/mcp-manifest.json');
const actions = await fetch(manifest.actions.discover);

A2A和ADK集成

AWAS可以用作代理间通信的提供者：

# ADK Integration Example
from agent_dev_kit import Provider

class AWASProvider(Provider):
    def discover_actions(self):
        return fetch_awas_manifest(self.base_url)
    
    def execute_action(self, action_id, params):
        return call_awas_action(action_id, params)

OpenAPI/Swagger集成

AWAS操作可以参考现有的OpenAPI规范，以减少重复并利用熟悉的工具：

{
  "id": "search_products",
  "name": "Search Products",
  "method": "GET",
  "endpoint": "/api/search",
  "openapi": {
    "documentUrl": "/openapi.json",
    "operationId": "searchProducts"
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "q": {"type": "string"}
    }
  }
}

优点：

• 链接到现有的OpenAPI/Swagger规范
• 减少架构重复
• 使用熟悉的API文档工具
• 保持AWAS作为人工智能行为的权威来源

🚀 快速开始

对于网站所有者

1. 创建AI行动清单 (/.well-known/ai-actions.json):

{
  "specVersion": "1.1",
  "lastUpdated": "2025-12-01T00:00:00Z",
  "actions": [
    {
      "id": "search_products",
      "name": "Search Products",
      "description": "Search for products in the catalog",
      "method": "GET",
      "endpoint": "/api/search",
      "intent": "read",
      "sideEffect": "safe",
      "conformanceLevel": "L1",
          "openapi": {
            "documentUrl": "/openapi.json",
            "operationId": "searchProducts"
          },
      "parameters": [
        {
          "name": "query",
          "type": "string",
          "required": true,
          "description": "Search query"
        },
        {
          "name": "category",
          "type": "string",
          "enum": ["electronics", "clothing", "books"],
          "description": "Filter by category"
        }
      ],
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string" },
          "category": { "type": "string", "enum": ["electronics", "clothing", "books"] }
        },
        "required": ["query"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "name": { "type": "string" },
                "price": { "type": "number" }
              }
            }
          }
        }
      }
    }
  ]
}

1. 添加HTML数据属性 （可选增强功能）：

  
  
    Electronics
    Clothing
  
  Search

1. 更新robots.txt:

User-agent: *
Allow: /

# AI Agent Directives
AI-Action-Manifest: /.well-known/ai-actions.json
AI-Rate-Limit: 60/minute
AI-Auth-Required: Bearer

面向AI浏览器开发人员

const AWAS = require('@awas/client');

const client = new AWAS.Client('https://example.com');

// Discover available actions
const manifest = await client.discover();

// Execute an action
const results = await client.executeAction('search_products', {
  query: 'laptop',
  category: 'electronics'
});

console.log(results);

📖 文档

• 完整规格
• 实施指南
• 例子
• api参考
• 安全最佳实践

💪 好处

对于网站所有者

• 更好的AI排名 -结构化数据有助于人工智能理解您的网站
• 减少服务器负载 -高效的API调用与页面抓取
• 控制和可见性 -定义AI能做什么和不能做什么
• 未来考验 -无需重新设计即可适应人工智能驱动的网络
• 竞争优势 -早期采用者在AI结果中排名更高

面向AI开发人员

• 执行速度更快 -直接操作调用与DOM自动化
• 可靠运行 -对UI更改具有弹性
• 丰富的语义 -理解意图，而不仅仅是像素
• 标准协议 -一个集成在任何地方都有效

对于用户

• 更快的结果 -AI在几秒钟内完成任务
• 可靠的 -更少的失败和重试
• 更好的隐私 -明确的权限和审计跟踪
• 改善体验 -无缝的人工智能辅助

🔐 安全

AWAS包括安全功能：

• 速率限制规范
• 身份验证要求
• 行动许可系统
• 审计跟踪功能
• 尊重隐私的指令
• CSRF保护指南

看 安全.md 了解详情。

🤝 贡献

我们欢迎捐款！请看 贡献.md 作为指导方针。

• 通过以下方式报告错误
• 通过以下方式建议功能 讨论
• 提交改进请求

📄 许可证

AWAS根据 Apache许可证，版本2.0.\ 在重新分发或创建衍生作品时，您必须包含通知和本许可证。

看 许可证 和 通知 了解详情。

该项目以前是麻省理工学院授权的；截至2025年10月29日，AWAS采用Apache 2.0。

🙏 致谢

• 受到Schema.org、OpenAPI和WAI-ARIA标准的启发
• 为兼容MCP（模型上下文协议）和A2A（Agent2Agent）而构建
• 来自AI浏览器开发人员和web开发人员的社区反馈

📞 联系

• 问题:
• 讨论:
• 网站：即将推出

🗺️ 路线图

• \[x\] v1.0-核心规范和基本示例
• \[x\] v1.1-增强的发现、类型和安全合同（规范版本、一致性级别L1/L2/L3、类型化I/O）-\[\]v1.2-实时更新功能
• \[x\] v1.1-MCP、A2A/ADK和OpenAPI/Swagger互操作性
• \[\]v1.3-高级身份验证机制
• \[\]v2.0-扩展协议集成

______________________________________________________________________

由以下材料制成❤️ 适用于人工智能驱动的网络