Agent-net开源Webagent：用Go打造网站即AI智能体的托管框架

开源目标：让网站成为可互信、可交易的AI智能体

Agent-net团队（致力于构建AI智能体间可发现、可信任、可支付的代理市场）正式开源Webagent。这是一个面向生产环境的开源托管框架，旨在将任何公开网站转化为具备基础能力与安全边界的AI智能体。其核心理念是：企业无需编写复杂编排逻辑，只需提供网站描述、填写一份声明式JSON配置文件，在9个可插拔功能槽位中各选一个实现提供商，运行`webagent serve`命令即可启动智能体服务。

架构设计：模块化插槽+强制安全护栏

Webagent采用Go语言开发，整体架构围绕‘1个Brain（LLM+指令）+ N个Slot（功能槽位）’展开。每个Slot定义为服务提供接口（SPI），在`spi/`目录下注册可用提供商，并预设默认实现。当前共定义9类Slot，涵盖检索、记忆、防护、通信、密钥管理、呈现、模型、动作与可观测性，每类均列出内置选项及默认值（如Action Slot默认为‘none’，Channel Slot默认为‘a2a’）。

最关键的架构决策是`action.Guard`机制：无论工具来自内置Action Provider还是由宿主注入，所有工具调用在执行前必须经由选定的Guardrail（如basic防护）校验。该防护逻辑由代码强制执行，而非依赖提示词工程——模型本身无法绕过。

项目设计文档援引研究论文arXiv:2511.19477指出：智能体任务成功率差异（85% vs. 50%）主要源于系统架构设计，而非底层模型能力差异。

当前可用能力与限制

开箱即用支持：

• 使用`echo` Brain（无需凭证）可立即验证`zomato.json`和`bakery.json`两个示例配置；
• 集成OpenRouter或gateway（兼容OpenAI API）作为真实模型后端，密钥通过`webagent keys set openrouter`安全存储于OS配置目录（权限0600），绝不写入配置文件；
• MCP工具调用已实现，通过Streamable HTTP（JSON/SSE）连接，支持Bearer Token或API Key认证，构建时完成握手并自动向智能体注入经`action.Guard`包装的工具；
• Slack与WhatsApp通道适配器已上线，严格校验入站Webhook签名、即时响应、通过平台API回复、过滤自消息、去重重试请求（Slack路由为`/slack/events`，WhatsApp为`/whatsapp/webhook`）；
• 密钥管理遵循命名规范：任一配置项若以`Secret`结尾，即视为需在构建时由所选密钥库解析的引用，解析失败则构建中止，杜绝无凭证启动；
• 可观测性输出符合OpenTelemetry GenAI规范的`TurnTrace`，配套`eval/`测试套件支持场景化验证。

尚未实现功能（明确标注为‘not yet built’）：浏览器操作Provider、OAuth认证的MCP接入、OpenTelemetry导出、AgentNet身份与计费层。

工程状态与使用前提

项目采用Apache 2.0许可证，代码可构建通过，当前版本为v0。官方提醒：生产部署前务必查阅文档中‘deferred-hardening list’（延迟加固清单），理解当前安全边界与待完善项。所有提供商须通过对应Slot的合规性测试套件方可认证，核心代码不鼓励Fork，扩展应通过注册自定义Provider实现。

编者观点：Webagent体现了AI智能体工程化从‘模型为中心’向‘架构为中心’的范式迁移，其插槽化、护栏前置、声明式配置的设计思路，为中国企业构建可控、可审计、可集成的业务智能体提供了轻量可行的技术路径参考。