--- title: "LlamaIndex + OmniChannels.ai: инструменты обмена сообщениями для ваших агентов" description: "Подключите агентов LlamaIndex к MCP-серверу OmniChannels.ai через llama-index-tools-mcp или REST-инструменты: отправка WhatsApp и SMS, отчёты о доставке." canonical: "https://omnichannels.ai/ru/integrations/llamaindex/" language: "ru" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # LlamaIndex + OmniChannels.ai: инструменты обмена сообщениями для ваших агентов Canonical: https://omnichannels.ai/ru/integrations/llamaindex/ Language: ru Publisher: OmniChannels.ai by BroadNet Technologies **Коротко:** Агенты LlamaIndex работают с OmniChannels.ai через наш удалённый MCP-сервер. С пакетом llama-index-tools-mcp клиент BasicMCPClient, указывающий на https://mcp.broadnet.me/mcp и обёрнутый в McpToolSpec, превращает наши инструменты отправки, шаблонов и отчётов о доставке (DLR) в инструменты агента. Наш сервер требует заголовок Authorization: Bearer, поэтому уточните в документации пакета, как его задаёт ваша версия, или вызывайте наш REST API из собственных инструментов. Подключение через MCP · Подключение через 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. (Руководство: https://omnichannels.ai/developers/mcp/) 3. **Установите llama-index-tools-mcp:** Установите пакет и уточните в его документации, как ваша версия передаёт пользовательские заголовки удалённому серверу. 4. **Загрузите инструменты:** Создайте BasicMCPClient для нашего URL с заголовком Authorization, оберните его в McpToolSpec и получите список инструментов. (Руководство: https://omnichannels.ai/developers/mcp/) 5. **Ограничьте набор и добавьте подтверждение:** Передайте агенту только те инструменты, которые ему нужны, и требуйте подтверждения перед любым инструментом, который отправляет сообщения. 6. **Проверьте на своём номере:** Запустите агента на вашем подтверждённом номере и проверьте отчёт о доставке, прежде чем расширять доступ. ## Пример сценария Ваш агент LlamaIndex (Агент или рабочий процесс с инструментами из McpToolSpec) → MCP-сервер OmniChannels.ai (Инструменты отправки, шаблонов и отчётов о доставке) → Телефон клиента (Доставлено сообщение в SMS, WhatsApp или RCS) → Отчёт о доставке (Агент читает его сам, или он приходит на ваш webhook) ## Вопросы и ответы ### Есть ли официальная интеграция OmniChannels.ai для LlamaIndex? Нет. LlamaIndex подключается через универсальный пакет MCP-инструментов с использованием нашего публичного endpoint и вашего API-токена либо через инструменты, которые вы пишете поверх нашего REST API. ### Как передать API-токен? Нашему серверу нужен заголовок Authorization: Bearer в каждом запросе. То, как llama-index-tools-mcp задаёт пользовательские заголовки, зависит от версии, поэтому следуйте актуальной документации пакета. Если это не подходит для вашей конфигурации, вызывайте REST API из собственных инструментов. ### Может ли агент читать мои документы или CRM через этот сервер? Нет. Наш сервер охватывает только сообщения, шаблоны и отчёты о доставке. Ваши документы агент берёт из ваших собственных индексов LlamaIndex, а другие системы — через их собственные инструменты или MCP-серверы. ### Как не допустить случайной отправки сообщения агентом? Давайте агенту только нужные инструменты, не добавляйте инструменты отправки агентам, которые лишь отвечают на вопросы, и подтверждайте каждую отправку у человека. Во время тестирования используйте временный ключ и свои собственные номера. ## Руководства для разработчиков - https://omnichannels.ai/developers/mcp/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/authentication/ - https://omnichannels.ai/developers/webhooks/ ## Документация вендора - [llama-index-tools-mcp on GitHub](https://github.com/run-llama/llama_index/tree/main/llama-index-integrations/tools/llama-index-tools-mcp) - [Model Context Protocol — introduction](https://modelcontextprotocol.io/introduction) ## Похожие интеграции - https://omnichannels.ai/ru/integrations/langchain/ - https://omnichannels.ai/ru/integrations/claude-code/ - https://omnichannels.ai/ru/integrations/vs-code/ - https://omnichannels.ai/ru/integrations/n8n/ LlamaIndex является товарным знаком своего владельца. OmniChannels.ai не связана с LlamaIndex и не одобрена компанией LlamaIndex; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков LlamaIndex. Обновлено: 2026-10-10