一次 setup,完成组件、AI 训练与帮助中心

创建工作区 API 密钥,在您的编码智能体中连接 HelpBlend MCP 服务器并提交 manifest,即可获得嵌入代码与公开帮助中心 URL。

兼容
CursorClaude CodeCodexOpenCodeHermesGrok任意 MCP 客户端
1

创建智能体 API 密钥

在 HelpBlend → 设置 → 智能体集成 中生成密钥(仅显示一次)。

2

添加 MCP 服务器

在 Cursor、Claude Code、Codex、OpenCode 或任意 MCP 客户端中配置 agent_mcp.py,并设置 HELPBLEND_API_KEY 与 HELPBLEND_BASE_URL。

3

让智能体完成集成

智能体提交机器人配置、规则、知识源、组件样式与帮助文章,并将返回的嵌入代码安装到您的网站。

自动配置的内容

与在控制台手动设置的对象相同,通过 external_id 幂等更新。

AI 机器人与训练

系统提示词、欢迎语、知识源(FAQ 文本或 URL 抓取)与行为规则。

聊天组件

品牌色、位置、问候语、留资开关及允许的嵌入来源(CORS)。

帮助中心

Slug、分类、已发布文章及与机器人一致的帮助中心 URL。

MCP 配置

添加到智能体的 MCP 设置(stdio):

{
  "mcpServers": {
    "helpblend": {
      "command": "python",
      "args": ["/path/to/helpblend/agent_mcp.py"],
      "env": {
        "HELPBLEND_API_KEY": "hb_...",
        "HELPBLEND_BASE_URL": "https://www.helpblend.com"
      }
    }
  }
}

Manifest 示例

每个资源需有稳定的 external_id,以便安全重复执行。

{
  "bot": {
    "external_id": "primary",
    "name": "Acme 客服",
    "system_prompt": "你是 Acme 的客服助手,请专业、简洁地回答用户问题。",
    "welcome_message": "您好!有什么可以帮您?"
  },
  "guidelines": [
    {
      "external_id": "tone",
      "instruction": "回答简洁友好。"
    }
  ],
  "sources": [
    {
      "external_id": "faq-returns",
      "type": "faq",
      "title": "退换货",
      "content_text": "未使用商品 30 天内可退货。"
    }
  ],
  "widget": {
    "title": "Acme 客服",
    "brand_color": "#7c3aed",
    "allowed_origins": [
      "https://www.acme.com"
    ]
  },
  "help_center": {
    "slug": "acme",
    "enabled": true,
    "categories": [
      {
        "external_id": "getting-started",
        "name": "入门指南"
      }
    ],
    "articles": [
      {
        "external_id": "shipping",
        "category_external_id": "getting-started",
        "title": "配送时效",
        "content": "我们会在 2 个工作日内发货。",
        "status": "published"
      }
    ]
  }
}

用编码智能体快速上线客服自动化

14 天试用 · 每个工作区均可创建智能体密钥

免费开始