跳转到正文
OmniChannels.ai

AI 助手与智能体

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

通过 MCP 连接通过 API 和 Webhook 连接更新于

简而言之

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

您可以做什么

  • 只带读取工具的送达支持 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 消息。”

连接方式

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

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. 1

    申请 API 访问权限

    申请测试权限并获取 API 令牌。测试消息只会发送到你已验证的本人号码。

  2. 2

    获取临时密钥

    在管理后台依次打开 Integrations、MCP Integration,选择 Get temporary key,并设置为 BROADNET_TOKEN。

    指南: MCP server for AI agents
  3. 3

    安装 llama-index-tools-mcp

    安装该软件包,并查阅其文档,了解你的版本如何向远程服务器传递自定义请求头。

  4. 4

    载入工具

    为我们的 URL 创建带 Authorization 请求头的 BasicMCPClient,用 McpToolSpec 封装并获取工具列表。

    指南: MCP server for AI agents
  5. 5

    限制并加设关卡

    只把 Agent 需要的工具传给它,并在任何发送类工具之前要求确认。

  6. 6

    用自己的号码测试

    先让 Agent 针对你已验证的号码运行并检查送达报告,再扩大访问范围。

厂商文档

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

示例工作流程

一个典型请求如何从 LlamaIndex 传到您的客户,再返回。

  1. 01

    你的 LlamaIndex Agent

    使用 McpToolSpec 工具的 Agent 或工作流

  2. 02

    OmniChannels.ai MCP 服务器

    发送、模板和送达报告工具

  3. 03

    客户手机

    短信、WhatsApp 或 RCS 消息已送达

  4. 04

    送达报告

    由 Agent 回读,或推送到你的 webhook

1. 你的 LlamaIndex Agent: 使用 McpToolSpec 工具的 Agent 或工作流 2. OmniChannels.ai MCP 服务器: 发送、模板和送达报告工具 3. 客户手机: 短信、WhatsApp 或 RCS 消息已送达 4. 送达报告: 由 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 去掉发送类工具,并让人确认每一次发送。测试时使用临时密钥和你自己的号码。

获取 API 与 MCP 访问权限

请告诉我们您的渠道、国家和使用场景。工程师会签发测试凭证并验证您的测试号码。