Webagent

Agent-net 团队发布了 Webagent，这是一个开源的 Go 框架，旨在让企业无需编写复杂的编排代码，就能快速构建面向公众的业务 AI 代理。通过填写一个声明式的 JSON 规范，用户可以从 9 个可插拔的“槽位”中选择提供商，然后运行 webagent serve 即可部署一个能够与其他代理对话、处理任务的智能体。

核心架构：槽位化设计 (Slot-Based Architecture)

Webagent 的核心是一个位于 core/ 中的 Brain（LLM + 指令），它构建在一组标准化的接口之上。每个接口被称为一个“槽位”，拥有自己的提供商注册表和默认值。这种设计确保了核心代码的稳定性和可扩展性。

设计理念：没有人需要分叉核心代码。企业可以通过菜单选择配置，开发者可以注册自定义提供商，合作伙伴可以发布适配器。所有提供商必须通过一致性套件认证。

安全由代码强制执行，而非提示词

Webagent 最重要的架构决策是 action.Guard。

• 强制拦截：代理持有的每一个工具（无论是来自操作提供商还是宿主注入），在执行前都会被包装并经过选定的护栏检查。
• 模型无法绕过：这确保了即使命令行或提示词被注入攻击，模型也无法直接执行未经安全检查的操作。
• 理论依据：引用 arXiv 2511.19477 的研究，架构而非单纯的模型能力决定了代理的成功率。在相同模型下，良好的架构可将任务成功率从 50% 提升至 85%。

当前可用功能 (v0 版本)

尽管标记为 v0，Webagent 已经具备生产级原型的能力：

1. 开箱即用：默认的 echo brain 无需凭据，可通过 webagent validate 和 webagent serve 在示例规范（如 zomato.json, bakery.json）上立即运行。
2. 真实模型支持：
   • 支持 OpenRouter 和 Gateway（OpenAI 兼容客户端）。
   • 密钥通过 webagent keys set 存储在操作系统配置目录中（权限 0600），绝不写入规范文件。
3. MCP 集成：
   • 企业只需在规范中添加一个块，即可将现有的 MCP (Model Context Protocol) 服务器转化为代理的行动能力。
   • 支持 Streamable HTTP (JSON/SSE)，使用 Bearer 或 API Key 认证。
4. 多渠道适配：
   • Slack：验证 Webhook 签名，自动去重，回复平台 API。
   • WhatsApp：处理 Meta 回调，确保消息投递可靠性。
   • HTTP/A2A：支持代理到代理的标准通信。
5. 安全的秘密管理：
   • 以 Secret 结尾的配置键会在构建时解析。如果解析失败，构建将直接报错，防止无凭据启动。

尚未实现的功能 (Roadmap)

在使用前需注意以下功能仍在开发中：

• 浏览器操作提供商：目前不支持自动化浏览器交互。
• OAuth 门控的 MCP：尚不支持需要 OAuth 流程的复杂 MCP 服务。
• OTel 导出：OpenTelemetry 的标准导出功能尚未完全建成。
• AgentNet 身份与计费层：代理间的发现、信任和支付基础设施尚未集成。

快速开始

1. 克隆仓库：

   git clone https://github.com/agent-net/webagent.git
   cd webagent
   

2. 验证示例：

   webagent validate zomato.json
   webagent serve zomato.json
   

3. 配置真实模型：

   webagent keys set openrouter <your-api-key>
   # 修改 json 规范中的 model 槽位为 openrouter
   webagent serve your-config.json