• 查看 1,101 次, 回复 0 次
  • 如何安装使用tradebee插件
    2个月前 (2026/09/11 13:33)
  • LYH
  • 注册:1年前
  • 举报
    加载中…
  • 小蜜蜂开放平台 + AI Agent 使用教程(26.11.7更新)

    更新内容:支持同时配置多个 MCP 连接,并通过不同连接名称管理多个站点账号。

    小蜜蜂开放平台现已提供 Agent 接口。通过在 AI Agent 中接入官方 tradebee MCP,用户可以用自然语言完成网站内容管理与维护操作,减少重复性后台操作,提高日常运营效率。

    说在前面

    你可以访问 小蜜蜂开放平台,查看当前接口支持的操作类型与功能说明。

    开放平台接口示意,如下:

    开放平台接口支持

    目前接口覆盖页面、产品、博客、新闻、导航、FAQ、数据分析及自定义页面等常见管理场景。接下来将按「选择 Agent → 准备模型 → 申请平台密钥 → 配置 MCP → 测试使用」的顺序完成接入。

    AI 工具选择

    目前可选择的 AI Agent 工具较多,适用场景也各不相同。若你还没有常用工具,本文建议从 WorkBuddy 开始:它支持多种模型,安装和配置流程相对直观,适合初次接触 Agent 的用户。若你已经在使用 Claude Code、Cursor 等工具,可跳过 WorkBuddy 的安装与登录步骤,直接参考后续的密钥申请和 MCP 接入说明。

    工具类型最适合谁一句话评价
    WorkBuddy通用桌面Agent新手小白、办公自动化适合作为入门工具,覆盖文档、表格、调研及部分编程任务
    Claude Code终端/桌面Agent复杂重构、排bug适合复杂代码分析、重构与问题排查
    Codex通用/终端Agent项目开发、内容创作适合项目开发与内容创作,可按实际额度策略选择
    豆包桌面版通用桌面Agent纯小白、日常办公用户支持屏幕协作,适合日常电脑操作与办公辅助
    Hermes通用桌面Agent日常办公用户支持经验积累与多渠道交互,适合希望自主部署的用户
    QoderWork通用桌面Agent调研、文档和轻度编程用户阿里办公Agent,纯编码的是Qoder
    GitHub Copilot企业代码助手微软生态团队适合微软生态与团队协作场景
    CursorAI原生IDE日常写代码编辑体验顺,适合当主力工作台
    OpenCode开源终端Agent极客、折腾党模型选择灵活,适合重视可配置性的用户
    TraeAI原生IDE编程新手做原型很快,中文上手简单
    Pi极简开源终端Agent有经验的终端用户框架精简,更适合熟悉终端工作流的用户
    Kimi Code国产终端Agent中文用户长需求、长文档场景值得试
    Zcode国产Agent小白和原型开发适合希望使用国产服务与本地化支持的用户

    手机端表格可左右滑动查看。下文以 WorkBuddy 为例演示;其他 Agent 思路相同,菜单名称可能略有差异。

    1 下载并安装 WorkBuddy

    前往 WorkBuddy 官网下载: https://www.workbuddy.cn/

    官网下载入口示意,如下:

    WorkBuddy官网下载

    进入官网后点击「立即下载」,根据页面提示获取适合当前设备的安装包。下载完成后,按照 Windows 或 macOS 的安装提示完成安装。

    2 注册并登录

    安装完成后启动 WorkBuddy,点击登录。系统会自动打开浏览器,按页面提示使用微信扫码或手机号完成登录。登录成功后,根据浏览器提示返回 WorkBuddy,等待软件完成账号加载。

    登录界面示意,如下:

    注册并登录

    3 领取积分并配置模型

    领取积分与选择模型界面,如下:

    领取积分 配置模型

    新用户通常可获得一定的初始使用额度,具体以 WorkBuddy 当前活动和账号页面显示为准。额度不足时,可以按需在软件内充值,也可以选择接入 DeepSeek 官方 API,按实际调用量管理模型使用成本。

    可选:使用 DeepSeek 官方 API(推荐有长期使用需求的用户)

    Agent 负责承载任务流程,具体回答与执行能力仍取决于所配置的模型。WorkBuddy 新用户可能获得初始额度;如果希望自行管理模型调用费用,也可以接入 DeepSeek 官方 API。操作步骤如下:

    1. 登录 DeepSeek API 平台: https://platform.deepseek.com/
    2. 进行充值(按量计费,成本相对可控)

      充值界面示意,如下:

      DeepSeek充值
    3. 点击左侧「API keys」并创建新的 Key

      创建 Key 示意,如下:

      创建API Key 填写名称
    4. 复制创建好的 API Key

      复制 Key 示意,如下:

      复制API Key
      安全提醒: API Key 只在创建时完整显示一次,之后无法再次查看。请立即复制并保存在本地安全位置(如密码管理器、加密笔记),不要发到群聊、工单或截图外传。
    5. 在 WorkBuddy 中配置自定义模型:点击模型切换 → 选择「配置自定义模型」→ 填入刚复制的 API Key → 保存并切换到该自定义模型。

      配置与切换自定义模型,如下:

      配置自定义模型1 配置自定义模型2 配置自定义模型3 切换到自定义模型

    保存后切换到自己的自定义模型即可开始使用。

    4 申请 tradebee 密钥并妥善保存

    接入小蜜蜂前,需要先在开放平台创建 API Key。创建后请立即复制并保存在安全位置,下一步配置 MCP 时会用到。

    安全与权限: 仅主账号可以创建 API Key。该密钥可用于调用账号授权范围内的管理接口,请按敏感凭据保管,不要分享或写入公开文档。创建后立即复制到密码管理器或本机加密存储中;不要仅保存在聊天记录里。
    1. 登录你的小蜜蜂平台账号,进入「开放平台」→「管理密钥」。

      管理密钥入口,如下:

      管理密钥
    2. 点击蓝色的「创建」按钮,生成新的 API 密钥。 (注意:只有主账号可以创建 API-key)

      创建与生成密钥,如下:

      创建密钥 生成密钥
    3. 复制创建好的平台 API Key,先保存到本地安全位置,再进入第 5 步。

      复制平台 API Key,如下:

      复制平台API Key

    若公司有多个站点账号,建议在本地备注好「企业名称 / 站点」,与密钥一一对应,避免用错后台。

    5 在 Agent 中接入 tradebee(MCP连接)

    官方推荐使用 MCP 连接( 说明见开放平台 )。请先完成第 4 步并准备好 API 密钥。

    使用 MCP 方式安装

    以下以 WorkBuddy 为例。确认已完成登录和模型配置后,按照下面的步骤添加 MCP 连接:

    1. 进入连接器页面。

      进入连接器,如下:

      进入连接器
    2. 点击右上角「自定义连接器」。

      自定义连接器入口,如下:

      自定义连接器
    3. 点击「添加 MCP」。

      添加 MCP,如下:

      添加MCP
    4. 将以下代码完整覆盖到配置框中(请将 ${BEE_API_KEY} 替换为第 4 步保存的真实密钥):
      {  "mcpServers": {    "tradebee": {      "type": "streamableHttp",      "url": "https://mcp.tradew.com/mcp",      "headers": {        "Authorization": "Bearer ${BEE_API_KEY}"      },      "timeout": 30000    }  }}

      粘贴 MCP 配置示意,如下:

      粘贴MCP配置代码
    5. 添加完成后界面如下: 添加后效果
    6. 点击「保存」。保存成功后应显示 tradebee 已启用: tradebee已启用

    多账号 MCP 配置

    如果需要管理多个小蜜蜂站点账号,可以在同一个 mcpServers 配置中添加多个连接。每个连接使用独立名称,并填写该站点对应的 API Key。下面以 tradebee 和 tradebee-new 两个连接为例:

    {
      "mcpServers": {
        "tradebee": {
          "type": "streamableHttp",
          "url": "https://mcp.tradew.com/mcp",
          "headers": {
            "Authorization": "Bearer ${TRADEBEE_API_KEY}"
          },
          "timeout": 30000
        },
        "tradebee-new": {
          "type": "streamableHttp",
          "url": "https://mcp.tradew.com/mcp",
          "headers": {
            "Authorization": "Bearer ${TRADEBEE_NEW_API_KEY}"
          },
          "timeout": 30000
        }
      }
    }
    配置提醒:请将示例中的 ${TRADEBEE_API_KEY} 和 ${TRADEBEE_NEW_API_KEY} 分别替换为对应站点新生成的真实 API Key。两个账号必须使用各自的密钥,不要共用或混填。密钥不要发布在网页、公开文档或聊天记录中。

    多账号 MCP 配置界面示意,如图所示:

    多账号 MCP 配置界面示意

    添加完成后的连接显示效果,如图所示:

    多个 MCP 连接添加完成后的显示效果
    连接名称使用说明:建议使用公司简称或站点域名作为连接名称,例如 tradebee-abc.com、tradebee-cdf.com或者是直接就是域名abc.com以及网站的logo名如apple等写法。后续下达任务时,明确指定连接别名,例如:「使用 tradebee-new 查询该账号的产品分组」。连接名称必须与配置文件中的键名完全一致。

    说明: MCP 配置里已写入密钥,一般无需再在对话里「添加 bee-api-key」。保存后可直接测试(例如查询账号内分组);不报错且能返回数据即表示成功。

    6 测试与使用 tradebee

    完成配置后,Agent 即可通过 tradebee MCP 调用已授权的站点管理接口。建议先从查询类任务开始,确认连接和账号无误后,再执行内容修改或发布操作。

    使用习惯: 每次 新开一个对话,建议在第一条消息中明确指定要使用的 MCP 连接名称和任务,例如:「使用 tradebee,先查询当前站点的导航结构」。如果配置了多个账号,请写明对应的连接别名,避免误操作其他站点。

    建议先执行只读查询进行验证,例如查看当前账号的导航结构。若 Agent 能正常调用接口并返回当前站点的数据,说明 MCP 连接基本正常。

    测试查看导航,如下:

    测试查看导航

    发布产品示例(仅为演示,实际请按真实产品文档操作):

    发布产品示意,如下:

    发布产品示例
    使用建议:
    1. 涉及页面或内容变更时,先要求 AI 输出预览或变更清单,人工确认后再正式提交。
    2. 执行修改前先确认是否存在可用备份;发生异常时,依据平台提供的版本或备份能力进行恢复。
    3. 将复杂任务拆分为查询、整理、预览、确认和执行等阶段,并在关键步骤检查结果。

    常用提示词模板(可直接复制修改)

    发布 / 批量发布产品

    使用 tradebee,在【目标英语站点】发布产品。
    素材位于【素材文件夹路径】;产品信息参考【产品编号 / 页面链接 / 参考详情页】。
    详情页的整体结构、模块顺序、间距、配色和图片比例尽量参照指定页面;新增信息放入最合适的模块,并保持全站视觉风格一致。
    产品标题应包含符合采购搜索习惯的 B2B 关键词,不要把型号写入标题。若系统已有 model 属性,其他属性中不要重复创建 model。
    产品名称、简要描述和详情描述中,应自然覆盖至少一个完整目标关键词,避免机械堆砌。
    同时完善每个产品的 Title、Description 和 Keywords;英语站内容统一使用英文,不要混入中文。
    不要使用 Unsplash 或外部占位图,只使用指定素材文件夹中的图片。按素材对应关系选择 1、2、3 作为主图,其余图片按内容放入详情页(如有)。

    (按实际账号、文件夹、参考页修改【】内容;批量时说明「按文件夹内每个产品各发一条」。建议先预览一条,确认后再批量。)

    制作页面

    使用 tradebee,素材位于【素材文件夹路径】。
    请根据这些资料制作一个页面。颜色优先沿用网站现有主题色,不要擅自更换主色。
    页面结构可参考【参考网址】;可加入必要的轻量交互,但整体保持简洁克制,不要堆叠装饰性图标或无关动效。
    先生成本地 HTML 预览,待我确认内容、布局和链接无误后,再发布到目标账号。

    (预览后可逐模块改:复制该块说明,告诉 AI「这个模块需要做 xxx」;满意再正式发布。)

    同步模块布局(如 CTA)

    使用 tradebee 。
    将【源页面】【源位置/模块名】的布局结构与排版方式,迁移到【目标页面】【目标位置/模块名】。
    仅同步结构、间距、对齐方式和按钮层级;目标页面原有文案与链接默认保留,只有我明确提供替换内容时才修改。
    颜色自动调取网站主题色,不要另起一套色,不要额外加装饰图标。

    (例:把 A 页底部 CTA 的布局,同步到 B 页同位置。)

    产品详情多方案排版

    使用 tradebee 。
    请重新规划【产品名/编号】详情页的内容结构与视觉层级,并为每个区块提供 3 种可选排版方案。
    将所有方案整合到同一个本地 HTML 文件中,支持按区块查看和比较;文件保存到【指定输出文件夹】。
    只调整内容组织、排版和视觉层级,不得编造产品参数;沿用网站主题色,不新增主色,也不要添加无关装饰图标。
    先极短说明各个方案,再生成文件。

    发布新闻 / FAQ / 博客

    使用 tradebee,素材位于【素材文件夹路径】。
    读取【FAQ 表格 / 新闻文档 / 博客文档】,整理并上传至【目标分组】。
    如果目标分组不存在,请先分析内容并提出分组命名建议,待我确认后再创建和上传。
    若目标站点为英语站,正文及 TDK 均使用自然、准确的英文;不要使用 Unsplash 或无关图片作为占位图。

    最后提醒

    不同 Agent 的操作界面、模型能力和调用额度各有差异,实际效果也取决于任务描述、素材质量及账号权限。建议先用小范围任务验证流程,再逐步扩大使用范围;软件界面和菜单名称如有变化,请以当前版本为准。

    希望大家借助 AI 真正提高工作效率,享受科技带来的便利。