HTTP — внешние запросы 🌐

PRO

Доступна только в облачной версии; в открытой (open) версии этой ноды нет.

HTTP — руки агента в интернете: нода разрешает агенту делать запросы к конкретным внешним сервисам — CRM, Битрикс24, ваш собственный API. Вы задаёте белый список адресов, агент пользуется им как инструментом.

Когда использовать

• Агент должен не просто отвечать, а делать: создать лид в CRM, отправить заявку в ваш сервис, получить статус заказа из внешней системы.
• Внешний API доступен по HTTP и не подключается через готовый протокол MCP.
• Секреты (токены, вебхуки) должны оставаться на платформе и не попадать в переписку.

Как это работает

• Вы перечисляете разрешённые хосты — агент не сможет обратиться ни к чему другому.
• Агент получает инструмент HTTP-запроса: метод, адрес, заголовки, параметры, тело.
• Секреты нода берёт из Хранилища аккаунтов и подставляет сама; в ответах и логах они маскируются.

Настройки

Поле	Что это
Название	Имя ноды на канвасе
Разрешённые хосты	Список доменов, куда можно ходить, например api.moy-servis.ru
Аккаунт Хранилища	Откуда брать секреты: адрес, токены, заголовки
Таймаут, мс	Сколько ждать ответа (по умолчанию 10 секунд)
Макс. ответ, КБ	Большие ответы обрезаются до этого размера
Разрешить редиректы	Следовать ли перенаправлениям (по умолчанию нет)
Открытые сайты без списка	Читать страницы любых публичных сайтов без белого списка (по умолчанию выключено); внутренние адреса остаются заблокированными
Доп. заголовки	Несекретные заголовки для всех запросов

Пример: заявка в CRM

1. В Хранилище аккаунтов добавьте запись с адресом вебхука и токеном CRM.
2. Поставьте ноду HTTP, в разрешённых хостах — домен вашей CRM, в аккаунте — имя записи из Хранилища.
3. Соедините HTTP с нодой Tools. Теперь «запиши клиента в CRM» для агента — обычный вызов инструмента, а токен в переписке не появится.

Важно знать

• Хосты — точные, без масок. Список api.example.com не даёт доступа к api.example.com и к поддоменам: впишите каждый адрес отдельно.
• Authorization в полях запрещён. Токены и ключи — только через Хранилище аккаунтов: они не попадут ни в ответы, ни в логи.
• Редиректы выключены по умолчанию. Каждый переход проверяется по тому же белому списку — включайте только если сервису это действительно нужно.
• Внутренние и локальные адреса заблокированы. Нода не сможет достучаться до самой платформы или до приватных сетей — это защита от ошибок и злоупотреблений.
• «Открытые сайты без списка» — опция для чтения. Полезно, когда нужно «прочитать эту страницу»: открытые сайты разрешаются, приватные остаются под замком.
• Нода должна прогнаться один раз, чтобы конфигурация загрузилась — после правки настроек отправьте тестовое сообщение агенту.

Связанные ноды

• Tools — куда нода отдаёт инструмент запросов
• MCP — готовые наборы инструментов внешних протоколов
• Cloud — работа с файлами во внешних хранилищах