Коротко
Агенты LlamaIndex работают с OmniChannels.ai через наш удалённый MCP-сервер. С пакетом llama-index-tools-mcp клиент BasicMCPClient, указывающий на https://mcp.broadnet.me/mcp и обёрнутый в McpToolSpec, превращает наши инструменты отправки, шаблонов и отчётов о доставке (DLR) в инструменты агента. Наш сервер требует заголовок Authorization: Bearer, поэтому уточните в документации пакета, как его задаёт ваша версия, или вызывайте наш REST API из собственных инструментов.
Что вы можете делать
Агент поддержки по доставке только с инструментами чтения
Оставьте только инструменты чтения, чтобы агент отвечал на вопросы о доставке, но не мог отправлять сообщения.
Попробуйте спросить
“Создай агента, который отвечает на вопросы о доставке только с помощью инструментов чтения и отклоняет любой запрос на отправку сообщения.”
Ответы по вашим документам, действия через инструменты
Объедините поисковый движок (query engine) по вашим правилам с нашими инструментами обмена сообщениями, чтобы ответы соответствовали вашим политикам до отправки.
Попробуйте спросить
“Создай агента, который проверяет индекс нашей политики возвратов, готовит ответ в WhatsApp на арабском и английском и спрашивает меня, прежде чем отправить его на 971500000000.”
Рабочий процесс с учётом шаблонов
Агент получает список одобренных шаблонов WhatsApp и подставляет переменные для сообщений по инициативе бизнеса за пределами 24-часового окна.
Попробуйте спросить
“Напиши рабочий процесс, который находит одобренный шаблон appointment_reminder и после моего подтверждения отправляет его на 966500000000 с завтрашним временем записи.”
Узкие REST-инструменты
Оберните одну REST-операцию в FunctionTool, если вам нужен полный контроль над полями, валидацией и логированием.
Попробуйте спросить
“Напиши LlamaIndex FunctionTool, который отправляет одно SMS через POST /sms/sendSms и читает BROADNET_TOKEN из переменных окружения.”
Анализ сбоев
Агент читает отчёты о доставке и группирует сбои по причинам для вашей операционной команды.
Попробуйте спросить
“Создай агента, который читает вчерашние отчёты о доставке и сводит сообщения со статусами FAILED и REJECTED по причинам и каналам.”
Как устроено подключение
Пакет llama-index-tools-mcp содержит BasicMCPClient, который подключается к удалённому MCP-серверу по URL, и McpToolSpec, который превращает инструменты этого сервера в список инструментов для агента LlamaIndex. Укажите клиенту адрес https://mcp.broadnet.me/mcp — это endpoint Streamable HTTP. Каждый запрос к нашему серверу должен содержать заголовок Authorization: Bearer. Как его задать, например через собственный HTTP-клиент, зависит от версии пакета, поэтому смотрите его документацию.
Отфильтруйте список инструментов, чтобы у каждого агента были только нужные ему, и добавьте шаг подтверждения перед любой отправкой. Если возможность задать заголовок в вашей версии не подходит, напишите собственные обёртки FunctionTool вокруг нашего REST API с Bearer-токеном и используйте спецификацию OpenAPI 3.1 для точных полей. Одиночное SMS отправляется в JSON, а массовые отправки и отправки в большинстве других каналов — в multipart/form-data.
- MCP: BasicMCPClient с адресом https://mcp.broadnet.me/mcp, обёрнутый в McpToolSpec
- Заголовок Authorization: Bearer обязателен в каждом запросе
- Фильтруйте инструменты по имени и подтверждайте любую отправку
- REST-вариант: обёртки FunctionTool на основе спецификации OpenAPI 3.1
Настройка
- 1
Запросите доступ к API
Запросите тестовый доступ и получите API-токен. Тестовые сообщения уходят только на ваши собственные подтверждённые номера.
- 2
Получите временный ключ
В админ-портале откройте «Integrations», затем «MCP Integration», выберите «Get temporary key» и задайте ключ как BROADNET_TOKEN.
Руководство: MCP server for AI agents - 3
Установите llama-index-tools-mcp
Установите пакет и уточните в его документации, как ваша версия передаёт пользовательские заголовки удалённому серверу.
- 4
Загрузите инструменты
Создайте BasicMCPClient для нашего URL с заголовком Authorization, оберните его в McpToolSpec и получите список инструментов.
Руководство: MCP server for AI agents - 5
Ограничьте набор и добавьте подтверждение
Передайте агенту только те инструменты, которые ему нужны, и требуйте подтверждения перед любым инструментом, который отправляет сообщения.
- 6
Проверьте на своём номере
Запустите агента на вашем подтверждённом номере и проверьте отчёт о доставке, прежде чем расширять доступ.
Документация вендора
LlamaIndex является товарным знаком своего владельца. OmniChannels.ai не связана с LlamaIndex и не одобрена компанией LlamaIndex; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков LlamaIndex.
