--- title: "Google Gemini + OmniChannels.ai：为 Gemini Agent 提供消息工具" description: "把基于 Agent Development Kit 的 Gemini Agent 或 Gemini CLI 接入我们的 MCP 服务器，发送 WhatsApp、短信和 RCS 消息并读取送达报告。" canonical: "https://omnichannels.ai/zh/integrations/google-gemini/" language: "zh" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Google Gemini + OmniChannels.ai：为 Gemini Agent 提供消息工具 Canonical: https://omnichannels.ai/zh/integrations/google-gemini/ Language: zh Publisher: OmniChannels.ai by BroadNet Technologies **简而言之:** Gemini Agent 通过远程 MCP 服务器接入：ADK 的 MCPToolset 使用 Streamable HTTP，令牌放在 Authorization 请求头，Gemini CLI 同理。可发送 WhatsApp、短信和 RCS。 通过 MCP 连接 · 通过 API 和 Webhook 连接 ## 您可以做什么 ### 由 ADK Agent 发送客户通知 基于 Agent Development Kit 构建的 Agent，在你的应用发出请求时发送发货或预约通知。 > 试着这样提问: "给 971500000000 发一条 WhatsApp 消息，告知其订单已发货，明天送达。" ### 面向沙特和阿联酋客户的模板 Agent 列出已审核的 WhatsApp 模板，并填写合适的阿拉伯语或英语版本。 > 试着这样提问: "列出我已审核的阿拉伯语 WhatsApp 模板，并向 966500000000 发送 order_update，订单号为 INV-400。" ### 用 Gemini CLI 发送测试消息 开发者在开发过程中，可直接在终端发送测试消息或查看送达报告。 > 试着这样提问: "向我已验证的号码发送一条测试短信，并告诉我送达状态。" ### 送达分析 只配备送达报告工具的只读 Agent，可为团队汇总失败情况。 > 试着这样提问: "昨天的对账单活动里有多少条消息失败？最常见的原因是什么？" ### 与你的业务数据结合 当 Agent 同时拥有连接 BigQuery、CRM 或店铺的工具时，可以从中获取收件人，再通过 OmniChannels.ai 发送。 > 试着这样提问: "给今天订单已发货的客户发送 WhatsApp 订单通知。" ## 连接方式 OmniChannels.ai 运行一个基于 Streamable HTTP 的远程 MCP 服务器。每个请求都在 Authorization: Bearer 请求头中携带你的 API 令牌，每个工具都按该令牌的权限、Sender ID 和余额执行，与你自己的代码完全一致。 在 Agent Development Kit 中，添加一个 MCPToolset，其 Streamable HTTP 连接参数包含我们的 URL 和 Authorization 请求头，并筛选出 Agent 所需的工具。ADK Agent 可部署到 Vertex AI Agent Engine；请把令牌存放在 Secret Manager 中，而不是写进代码。Gemini CLI 从其设置文件读取 MCP 服务器，用 httpUrl 指定接入点，用 headers 传递令牌。 - 接入点：https://mcp.broadnet.me/mcp（Streamable HTTP） - 认证：Authorization: Bearer ；测试时使用临时密钥 - ADK：带 Streamable HTTP 连接参数和 headers 的 MCPToolset - Gemini CLI：包含 httpUrl 和 headers 的 mcpServers 条目 - 不使用 MCP 时，Agent 也可依据 OpenAPI 规范调用我们的 REST API ## 设置步骤 1. **申请 API 访问权限:** 申请测试权限并获取 API 令牌。测试消息只会发送到你已验证的本人号码。 2. **获取 MCP 密钥:** 在管理后台依次打开 Integrations、MCP Integration，复制一个临时密钥。 (指南: https://omnichannels.ai/developers/mcp/) 3. **把工具集添加到 Agent:** 在 ADK 中创建 MCPToolset，使用指向 https://mcp.broadnet.me/mcp 的 Streamable HTTP 参数和 Authorization 请求头，令牌从环境变量或密钥库读取。 4. **或者添加到 Gemini CLI:** 添加 mcpServers 条目，httpUrl 设为我们的接入点，并在 headers 中填入 Authorization 请求头，然后重启 CLI。 5. **限制工具并确认发送:** 只开放 Agent 需要的工具，并在任何发送之前加入确认步骤，因为每次发送都是真实计费的消息。 6. **先测试，再部署:** 向你已验证的号码发送一条测试消息并检查送达报告，然后再把 Agent 部署到 Vertex AI Agent Engine。 ## 示例工作流程 Gemini Agent (基于 ADK 构建，或在本机使用 Gemini CLI) → OmniChannels.ai MCP 服务器 (工具集调用携带你的 Bearer 令牌) → 客户手机 (WhatsApp、短信或 RCS 消息已送达) → 送达报告 (Agent 通过读取工具回读状态) ## 常见问题 ### Gemini 有 OmniChannels.ai 官方应用吗？ 没有。Gemini Agent 通过 Google 在 Agent Development Kit 和 Gemini CLI 中自带的 MCP 支持接入，使用我们的公开 MCP 接入点和你的 API 令牌。 ### 能在 Gemini 应用中使用吗？ 本页面介绍的是开发者路径：用 Agent Development Kit 构建的 Agent、Vertex AI Agent Engine 和 Gemini CLI。其他 Gemini 产品对 MCP 的支持情况，请查阅 Google 的最新文档。 ### 生产环境中令牌应该放在哪里？ 不要放在会提交的代码和配置里。在 Google Cloud 上，请存放在 Secret Manager 中，并在运行时传给 Agent。 ### Google 能访问我的客户数据吗？ 模型只能看到工具返回的内容（如模板和送达报告）以及你的应用放入对话的内容。令牌会把 Agent 限制在你账户的权限范围内。 ## 开发者指南 - https://omnichannels.ai/developers/mcp/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/authentication/ - https://omnichannels.ai/developers/quickstart/ ## 厂商文档 - [MCP tools — Agent Development Kit documentation](https://google.github.io/adk-docs/tools/mcp-tools/) - [MCP servers with Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) - [Vertex AI Agent Engine overview — Google Cloud](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview) ## 相关集成 - https://omnichannels.ai/zh/integrations/chatgpt/ - https://omnichannels.ai/zh/integrations/claude/ - https://omnichannels.ai/zh/integrations/langchain/ - https://omnichannels.ai/zh/integrations/llamaindex/ Google Gemini and Vertex AI 是其所有者的商标。OmniChannels.ai 与 Google Gemini and Vertex AI 无关联，也未获得 Google Gemini and Vertex AI 的认可；本页介绍的是利用 Google Gemini and Vertex AI 自身的 MCP、HTTP 或 Webhook 功能建立的连接。 更新于: 2026-10-10