---
title: "LlamaIndex + OmniChannels.ai：为你的 Agent 提供消息工具"
description: "用 llama-index-tools-mcp 把 LlamaIndex Agent 接入 OmniChannels.ai MCP 服务器，或自建 REST 工具，发送 WhatsApp、短信并读取报告。"
canonical: "https://omnichannels.ai/zh/integrations/llamaindex/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# LlamaIndex + OmniChannels.ai：为你的 Agent 提供消息工具

Canonical: https://omnichannels.ai/zh/integrations/llamaindex/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

**简而言之:** LlamaIndex Agent 借助 llama-index-tools-mcp，由 McpToolSpec 封装 BasicMCPClient 指向我们的 MCP 地址，即可把发送、模板和送达报告变成 Agent 工具；需要 Bearer 请求头。

通过 MCP 连接 · 通过 API 和 Webhook 连接

## 您可以做什么

### 只带读取工具的送达支持 Agent

只保留读取类工具，Agent 可回答送达问题，但无法发送。

> 试着这样提问: "构建一个只使用读取类工具回答送达问题、并拒绝一切发送消息请求的 Agent。"

### 依据文档作答，通过工具执行

把基于你自有政策的查询引擎与我们的消息工具结合，让回复在发送前遵循你的规则。

> 试着这样提问: "构建一个 Agent，查询我们的退款政策索引，起草阿拉伯语和英语的 WhatsApp 回复，并在发送到 971500000000 之前先征求我的同意。"

### 感知模板的工作流

Agent 列出已审核的 WhatsApp 模板，并为 24 小时窗口之外由企业主动发起的消息填写变量。

> 试着这样提问: "编写一个工作流，找到已审核的 appointment_reminder 模板，并在我批准后带上明天的时间段发送到 966500000000。"

### 精简的 REST 工具

想完全掌控字段、校验和日志时，把单个 REST 操作封装进 FunctionTool。

> 试着这样提问: "编写一个 LlamaIndex FunctionTool，通过 POST /sms/sendSms 发送一条短信，并从环境变量读取 BROADNET_TOKEN。"

### 失败分析

Agent 读取送达报告，并为运维团队按原因对失败分组。

> 试着这样提问: "创建一个 Agent，读取昨天的送达报告，按原因和渠道汇总 FAILED 与 REJECTED 消息。"

## 连接方式

llama-index-tools-mcp 提供 BasicMCPClient 和 McpToolSpec：前者按 URL 连接远程 MCP 服务器，后者把该服务器的工具转换为 LlamaIndex Agent 的工具列表。请将客户端指向 Streamable HTTP 接入点 https://mcp.broadnet.me/mcp。发往我们服务器的每个请求都必须携带 Authorization: Bearer 请求头；具体如何设置（例如通过自定义 HTTP 客户端）取决于包的版本，请查阅其文档。

请过滤工具列表，让每个 Agent 只拥有所需工具，并在任何发送之前加入确认步骤。如果你的版本中的请求头选项不适用，可以自行编写 FunctionTool 封装，携带 Bearer 令牌调用我们的 REST API，并依据 OpenAPI 3.1 规范确定准确字段；单条短信为 JSON，批量及大多数其他渠道发送使用 multipart/form-data。

- MCP：位于 https://mcp.broadnet.me/mcp 的 BasicMCPClient，由 McpToolSpec 封装
- 每个请求都必须带 Authorization: Bearer 请求头
- 按名称过滤工具，并在任何发送前确认
- REST 方案：依据 OpenAPI 3.1 规范构建 FunctionTool 封装

## 设置步骤

1. **申请 API 访问权限:** 申请测试权限并获取 API 令牌。测试消息只会发送到你已验证的本人号码。
2. **获取临时密钥:** 在管理后台依次打开 Integrations、MCP Integration，选择 Get temporary key，并设置为 BROADNET_TOKEN。 (指南: https://omnichannels.ai/developers/mcp/)
3. **安装 llama-index-tools-mcp:** 安装该软件包，并查阅其文档，了解你的版本如何向远程服务器传递自定义请求头。
4. **载入工具:** 为我们的 URL 创建带 Authorization 请求头的 BasicMCPClient，用 McpToolSpec 封装并获取工具列表。 (指南: https://omnichannels.ai/developers/mcp/)
5. **限制并加设关卡:** 只把 Agent 需要的工具传给它，并在任何发送类工具之前要求确认。
6. **用自己的号码测试:** 先让 Agent 针对你已验证的号码运行并检查送达报告，再扩大访问范围。

## 示例工作流程

你的 LlamaIndex Agent (使用 McpToolSpec 工具的 Agent 或工作流) → OmniChannels.ai MCP 服务器 (发送、模板和送达报告工具) → 客户手机 (短信、WhatsApp 或 RCS 消息已送达) → 送达报告 (由 Agent 回读，或推送到你的 webhook)

## 常见问题

### LlamaIndex 有 OmniChannels.ai 官方集成吗？

没有。LlamaIndex 通过其通用的 MCP 工具包接入，使用我们的公开接入点和你的 API 令牌，也可以使用你基于我们 REST API 自行编写的工具。

### 如何传递 API 令牌？

我们的服务器要求每个请求都带 Authorization: Bearer 请求头。llama-index-tools-mcp 设置自定义请求头的方式取决于版本，请遵循其最新文档。如果不适合你的环境，可改为在自己的工具中调用 REST API。

### Agent 能通过这个服务器读取我的文档或 CRM 吗？

不能。我们的服务器只涵盖消息发送、模板和送达报告。你的文档来自自己的 LlamaIndex 索引，其他系统则通过各自的工具或 MCP 服务器接入。

### 如何避免 Agent 误发消息？

只给它需要的工具，对只回答问题的 Agent 去掉发送类工具，并让人确认每一次发送。测试时使用临时密钥和你自己的号码。

## 开发者指南

- 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/zh/integrations/langchain/
- https://omnichannels.ai/zh/integrations/claude-code/
- https://omnichannels.ai/zh/integrations/vs-code/
- https://omnichannels.ai/zh/integrations/n8n/

LlamaIndex 是其所有者的商标。OmniChannels.ai 与 LlamaIndex 无关联，也未获得 LlamaIndex 的认可；本页介绍的是利用 LlamaIndex 自身的 MCP、HTTP 或 Webhook 功能建立的连接。

更新于: 2026-10-10