Коротко
Агенты LangChain работают с OmniChannels.ai через наш удалённый MCP-сервер. С langchain-mcp-adapters запись MultiServerMCPClient с транспортом streamable_http, URL https://mcp.broadnet.me/mcp и заголовком Authorization загружает в агента наши инструменты отправки, шаблонов и отчётов о доставке. Также можно обернуть нужные вызовы REST API в собственные инструменты, а точные поля взять из нашей спецификации OpenAPI 3.1.
Что вы можете делать
Агент поддержки по доставке только с инструментами чтения
Загрузите только инструменты чтения: агент сможет отвечать на вопросы о доставке, но ничего не отправит.
Попробуйте спросить
“Создай агента, который отвечает на вопросы о доставке, используя только инструменты чтения, и отказывается выполнять любые запросы на отправку сообщений.”
Агент уведомлений с подтверждением человеком
Используйте прерывание (interrupt) LangGraph перед вызовами инструментов отправки, чтобы сотрудник подтверждал каждое сообщение или пакет.
Попробуйте спросить
“Создай агента на LangGraph, который готовит черновики обновлений по заказам в WhatsApp и перед вызовом любого инструмента отправки ждёт подтверждения человека.”
Отправка с учётом шаблонов
Агент получает список одобренных шаблонов WhatsApp и заполняет переменные, поэтому сообщения по инициативе компании вне 24-часового окна уходят по одобренному шаблону.
Попробуйте спросить
“Напиши агента, который выбирает подходящий одобренный арабский шаблон WhatsApp для уведомления о задержке доставки и отправляет его на 966500000000 с новой датой.”
Узкие REST-инструменты вместо MCP
Оберните одну-две операции REST в функции @tool, если хотите полностью контролировать поля, валидацию и логирование.
Попробуйте спросить
“Напиши инструмент LangChain, который отправляет одно SMS через POST /sms/sendSms, проверяет формат номера и читает BROADNET_TOKEN из переменной окружения.”
Разбор ошибок доставки
Агент читает отчёты о доставке, группирует сбои по причинам и предлагает решения из нашего руководства по ошибкам.
Попробуйте спросить
“Создай агента, который читает вчерашние отчёты о доставке, группирует сообщения со статусами FAILED и REJECTED по причинам и пишет краткую сводку для канала операционной команды.”
Как устроено подключение
langchain-mcp-adapters преобразует инструменты MCP в инструменты LangChain. Настройте MultiServerMCPClient с записью сервера, где transport равен streamable_http, указан URL https://mcp.broadnet.me/mcp и заголовок Authorization: Bearer с токеном, прочитанным из переменной окружения. Затем вызовите get_tools и передайте результат агенту. В новых версиях LangChain поддержка MCP также входит в основной пакет, поэтому актуальный импорт уточняйте в документации LangChain.
Вы сами выбираете, какие инструменты получит модель: отфильтруйте список по имени, чтобы агент поддержки получил только инструменты чтения, и добавьте шаг подтверждения перед любой отправкой. Если вы не хотите использовать MCP, напишите собственные инструменты, которые вызывают наш REST API с токеном Bearer. Одиночное SMS отправляется в JSON, а массовые отправки и отправки в большинстве других каналов — в multipart/form-data.
- MCP: MultiServerMCPClient, transport streamable_http, заголовок Authorization
- Фильтруйте инструменты по имени, чтобы у каждого агента были минимально необходимые права
- Добавляйте подтверждение человеком перед инструментами отправки, например с помощью interrupt в LangGraph
- Альтернатива через REST: собственные инструменты на основе спецификации OpenAPI 3.1
Настройка
- 1
Запросите доступ к API
Запросите тестовый доступ и получите токен API. Тестовые отправки идут только на ваши собственные подтверждённые номера.
- 2
Получите временный ключ
В админ-портале откройте «Integrations», затем «MCP Integration», выберите «Get temporary key» и задайте его как BROADNET_TOKEN.
Руководство: MCP server for AI agents - 3
Установите адаптеры
Установите langchain-mcp-adapters или MCP-расширение LangChain, если оно есть в вашей версии, следуя актуальной документации LangChain.
- 4
Загрузите инструменты
Создайте запись MultiServerMCPClient с transport streamable_http, нашим URL и заголовком Authorization, затем вызовите get_tools.
Руководство: MCP server for AI agents - 5
Ограничьте и защитите
Передавайте агенту только нужные ему инструменты и добавьте шаг подтверждения человеком перед любым инструментом, который отправляет сообщения.
- 6
Проверьте на своём номере
Запустите агента на своём подтверждённом номере и проверьте отчёт о доставке, прежде чем расширять доступ.
Документация вендора
LangChain является товарным знаком своего владельца. OmniChannels.ai не связана с LangChain и не одобрена компанией LangChain; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков LangChain.
