Agent-net представила Webagent: открытый Go-фреймворк для превращения сайтов в защищенных ИИ-агентов

Материал посвящён теме «Agent-net представила Webagent: открытый Go-фреймворк для превращения сайтов в защищенных ИИ-агентов». Ниже последовательно разберём главные вопросы, важные детали и практический контекст, чтобы легче ориентироваться в теме и понять логику дальнейшего изложения.

Шлейф для бизнес-агентов: концепция Webagent от команды Agent-net

Команда разработчиков Agent-net, известная своей работой над маркетплейсом автономных агентов для их взаимного поиска и расчетов, выложила в открытый доступ проект Webagent. Это специализированный Go-фреймворк (harness), созданный для быстрого развертывания публичных ИИ-агентов, представляющих интересы конкретного бизнеса. Идея заключается в том, чтобы дать системе готовый сайт или спецификацию, получить автономного агента и предоставить ему возможность взаимодействовать с пользователями или другими агентами.

Вместо написания сложного оркестрационного кода разработчикам предлагается заполнить декларативный конфигурационный файл в формате JSON. В нем достаточно определить настройки для 9 подключаемых слотов и запустить команду запуска webagent serve. Проект распространяется по свободной лицензии Apache 2.0, написан на языке Go и уже способен работать в реальном окружении, хотя и находится на ранней стадии разработки v0.

Я внимательно изучил текущий статус репозитория: код успешно собирается и позволяет разворачивать агентов для Slack, WhatsApp и HTTP-каналов с поддержкой инструментов Protocol Model Context (MCP). При этом разработчики честно отмечают, что функционал вроде браузерных действий, OAuth-авторизации для MCP, экспорта метрик через OpenTelemetry, а также системы идентификации и биллинга AgentNet пока находятся в списке планируемых фич.

Архитектура из 9 слотов: гибкость без изменения ядра

В основе Webagent лежит строгая компонентная структура. Каждая сущность агента состоит из базового «мозга» (Brain) — комбинации языковой модели (LLM) и системной инструкции — и набора из 9 слотов, определенных в директории core/. Слоты реализованы через интерфейс сервисных провайдеров (Service Provider Interface, SPI) с реестром доступных реализаций в папке spi/ и установленными по умолчанию значениями.

В текущей версии фреймворка предусмотрена следующая система слотов и встроенных провайдеров:

• Retrieval (Поиск): варианты live, keyword, hybrid (по умолчанию: live);
• Memory (Память): провайдер session (по умолчанию: session);
• Guardrail (Защитный экран): варианты basic, off (по умолчанию: basic);
• Channel (Канал связи): a2a, web, slack, whatsapp, а также заготовка под telegram (по умолчанию: a2a);
• Secrets (Управление секретами): варианты env, file, static (по умолчанию: env);
• Presenter (Форматирование вывода): text, terminal (QR), web (по умолчанию: text);
• Model (Языковая модель): echo, openrouter, gateway (по умолчанию: echo);
• Action (Действия и инструменты): none, demo, mcp (по умолчанию: none);
• Observability (Мониторинг): none, log, memory (по умолчанию: none).

Такой подход решает задачи сразу трех категорий пользователей: компании выбирают нужные компоненты из готового меню, продвинутые инженеры расширяют функционал путем создания собственных провайдеров, а партнеры поставляют адаптеры. При этом никто не форкает основное ядро фреймворка. Каждая реализация в обязательном порядке проходит тесты на соответствие спецификации своего слота.

Безопасность на уровне кода: почему action.Guard надежнее промптов

Главным архитектурным решением проекта стал оберточный модуль action.Guard. Любой инструмент, которым оперирует ИИ-агент (будь то внешняя функция из провайдера действий или внедренная хостом операция), принудительно оборачивается в защитный экран перед выполнением. Избранное правило безопасности срабатывает строго до вызова инструмента, поэтому языковая модель не способна обойти ограничение за счет манипуляций в промпте.

В технической документации DESIGN.md авторы подчеркивают: именно жесткая архитектура, а не только мощность языковой модели, определяет итоговый успех работы агента. Разработчики ссылаются на исследовательскую работу (arXiv 2511.19477), где показано, что одна и та же LLM показывает разницу в успехе выполнения задач от 50% до 85% исключительно в зависимости от архитектурных ограничений и качества обвязки кода.

Текущие возможности и поддержка интеграций: MCP, Slack и WhatsApp

Для первого знакомства с Webagent не требуются API-ключи: встроенный провайдер echo позволяет сразу выполнять команды webagent validate и webagent serve на тестовых JSON-конфигурациях, таких как zomato.json или bakery.json. Чтобы подключить реальные нейросети, используется команда webagent keys set openrouter, которая сохраняет ключ в системной директории с безопасными правами доступа 0600. Секреты никогда не прописываются открытым текстом в спецификациях, а переменные окружения имеют высший приоритет над файлами конфигурации.

Интеграции openrouter и gateway представляют собой OpenAI-совместимые клиенты, поддерживающие полноценный цикл вызова функций (tool-calling). Если у бизнеса уже есть работающий MCP-сервер, превратить его в действующего агента можно буквально в один блок спецификации. Провайдер действий mcp подключается через Streamable HTTP (с поддержкой JSON и SSE) и авторизацией по Bearer-токену или API-ключу. Рукопожатие происходит на этапе сборки, и все найденные инструменты передаются агенту под защитой action.Guard.

Адаптеры для мессенджеров Slack и WhatsApp спроектированы с учетом требований надежности: они проверяют цифровые подписи входящих вебхуков, моментально подтверждают прием сообщений, отправляют ответы через официальные API, игнорируют собственные сообщения и исключают дублирование при повторной доставке пакетов. Канал Slack ожидает запросы на маршруте /slack/events, а callback от инфраструктуры Meta направляется на /whatsapp/webhook.

Работа с секретами подчиняется строгому правилу: любой ключ конфигурации, заканчивающийся на Secret, рассматривается как ссылка, резолвинг которой происходит во время сборки через выбранное хранилище. Если ссылку не удается разрешить, сборка аварийно завершается, что исключает случайный запуск агента без необходимых учетных данных. Для отслеживания работы генерируется пошаговый трейс TurnTrace в соответствии со стандартами OpenTelemetry GenAI, а встроенный фреймворк тестирования позволяет прогонять сценарии с проверкой результатов.

Ключевые выводы и перспективы Webagent

Проект Webagent предлагает продуманный подход к созданию бизнес-агентов. Декларативная конфигурация через один JSON-файл и разделение ответственности по 9 слотам позволяют быстро собирать работающие решения без изобретения собственной оркестрации.

Безопасность выполнения команд, гарантированная на уровне кода через action.Guard, решает ключевую проблему ненадежности систем, полагающихся только на инструктаж в промптах. Фреймворк уже сегодня готов к работе с OpenRouter, MCP-серверами, Slack и WhatsApp, предоставляя надежную основу для создания защищенных ИИ-ассистентов.

Источник: www.marktechpost.com