Что такое ИИ-агент в SAM от Google: развёртываем защищённую mesh-сеть за вечер

Однако источник — это описание конкретного проекта SAM (Sovereign Agent Mesh) от Google. Это не общая статья "что такое ИИ-агент". Мне нужно написать how-to по заданному плану, опираясь строго на факты из источника, с пользой для российской аудитории.

Ключевая польза: «Русская адаптация SAM даст аудитории практический путь для организаций на российском рынке (банки, госсектор, оборонка), которые не могут выкладывать внутренние инструменты в публичный интернет — локальное self-hosted решение».

Формат: how-to. Нужно объяснить, что такое ИИ-агент в контексте SAM, и дать пошаговую инструкцию по развёртыванию.

Теперь напишу.

---

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

Чтобы понять, что такое ИИ-агент в контексте SAM, нужно отделить его от чат-бота. Чат-бот отвечает на вопросы. ИИ-агент сам решает, какой инструмент вызвать, передаёт задачу другому агенту и получает результат. SAM не создаёт агентов, он создаёт защищённую сеть, по которой они общаются.

Проект не является официальным продуктом Google: репозиторий содержит явную оговорку об этом. Публичная сеть (testnet) помечена как бета. Для реальных задач авторы рекомендуют размещать управляющий сервер у себя. Именно этот путь (в документации назван DIY Mode) и даёт полный контроль над данными и политиками доступа.

Что понадобится?

• Сервер или виртуальная машина с Linux (подойдёт и облачный VPS). Для пробы хватит 2 ядер и 4 ГБ памяти
• Docker или Kubernetes (есть готовый Helm-чарт charts/sam-mesh)
• Домен или статический IP для управляющего сервера
• OIDC-провайдер (OpenID Connect, протокол единого входа, например Keycloak, который можно развернуть бесплатно), чтобы агенты и люди проходили аутентификацию
• Открытые порты: 5001/udp, 5002/tcp для P2P-транспорта libp2p и 8080 для локального MCP-интерфейса
• Время: от 2 до 4 часов на первый запуск с одним-двумя узлами

Пошаговая инструкция

1. Разверните управляющий сервер (control plane). Это первый из трёх бинарных файлов SAM: sam-control-plane. Он отвечает за регистрацию узлов, выдачу токенов и распространение политик. Используйте Docker-образ из ghcr.io или Helm-чарт для Kubernetes.

docker pull ghcr.io/google/sam-control-plane:latest
docker run -d -p 8443:8443 sam-control-plane --oidc-issuer https://your-keycloak.example.com

1. Запустите маршрутизатор. Второй бинарник, sam-router, создаёт точки входа для P2P-сети и маршрутизирует сообщения через протокол GossipSub (способ передачи сообщений, при котором каждый узел пересылает новость соседям, как сплетню).

2. Подключите первый узел. Третий бинарник, sam-node, устанавливается на каждую машину, где работает агент: сервер, ноутбук, Raspberry Pi или Android-устройство.

sam-node join --control-plane https://your-cp.example.com
sam-node run

После join узел получает Biscuit-токен (криптографический пропуск с набором разрешений, записанных на языке логических правил Datalog). Дальше узел авторизует входящие запросы сам, без обращения к центральному серверу.

1. Настройте политику доступа. По умолчанию действует запрет всего. Каждому агенту нужно явно выдать разрешение, например granted_service_exact(...). Даже каталог обнаружения сервисов system://sam.catalog требует отдельного гранта. Сервисы именуются по схеме type://name с поддержкой шаблонов: mcp://* откроет доступ ко всем MCP-инструментам, mcp://build-runner.* только к конкретной группе.

2. Проверьте обнаружение. Агенты используют три стандартных MCP-инструмента: discover_remote_services (найти сервисы), find_remote_tools (найти инструменты) и call_remote_tool (вызвать инструмент). Если узлы видят друг друга и вызов проходит, сеть работает.

3. Установите песочницу для исходящего трафика (sam-box). Модуль sam-box перехватывает весь сетевой трафик агента. Внутри песочницы запускается nano-init (мини-процесс, работающий с правами PID 1). Он подставляет прокси-переменные, а для программ, которые их игнорируют, перехватывает системный вызов connect() через механизм LD_PRELOAD. Реальные ключи и пароли из файла secrets.yaml подставляет шлюз, а не агент. Агент никогда не видит секретов.

Как SAM вписывается в бизнес-задачи?

По документации проекта, SAM лучше всего подходит инженерным командам среднего и крупного бизнеса, где агенты работают через несколько сетевых границ: облако, дата-центр, рабочие станции. Стартапу внутри одного облачного VPC (виртуальная частная сеть в облаке) выигрыш минимален.

Целевые отрасли, названные в документации: финансовые сервисы, здравоохранение, госсектор и оборонка, промышленные и робототехнические парки устройств.

Что делать с этим прямо сейчас, по ролям?

Инженеру или DevOps-специалисту. Скачайте репозиторий, разверните control plane в Docker и подключите два узла на разных машинах. Проверьте, проходит ли call_remote_tool между ними. Это займёт вечер и покажет, годится ли архитектура под ваши задачи.

Руководителю ИТ в банке, госструктуре или оборонном предприятии. SAM решает конкретную проблему: ИИ-агенты не смогут общаться друг с другом, если вы не готовы пускать их трафик через публичный интернет. Self-hosted режим (DIY Mode) оставляет все данные и политики внутри периметра. Лицензия Apache-2.0 позволяет использовать и модифицировать код без ограничений.

Автору Дзена или маркетологу. Если вы объясняете аудитории, что такое ИИ-агент, SAM хороший наглядный пример: это не чат-бот, который отвечает на вопросы, а программа, которая сама выбирает инструмент, вызывает его и передаёт результат другому агенту. Используйте паттерн пула ревьюеров как понятную иллюстрацию: «50 задач раздаются по свободным агентам, как заказы по курьерам».

Для российского рынка. SAM развёртывается локально, не зависит от облаков Google и не требует передачи данных за рубеж. Из российских инструментов для создания самих агентов можно рассматривать YandexGPT и GigaChat как языковую основу; SAM отвечает не за «мозг» агента, а за защищённую сеть между агентами.

Развернуть SAM на своём сервере можно за вечер, а вот решить, каким агентам какие инструменты открыть, это уже архитектурная задача, которая потребует ясного понимания ваших процессов. Начните с двух узлов и одного вызова call_remote_tool. Если он прошёл, вы уже понимаете, как устроена агентная mesh-сеть изнутри, и можете решать, нужна ли она вашей организации в полном масштабе.