跳转到内容

HiMarket Worker 管理指南

本文档面向 HiMarket AI 开放平台的管理员和开发者，提供 Agent Worker 的完整管理和使用指南。

如果你是管理员，本文将指导你完成 Worker 产品的创建、上传、版本管理和发布全流程；如果你是开发者，本文将帮助你了解如何浏览、订阅、下载和安装 Worker。

目录

Section titled “目录”

Worker 概述

Section titled “Worker 概述”

在 HiMarket 中，Worker 是可配置的 Agent Worker 执行单元。你可以将 Worker 理解为一个可装载 Skills（技能）的 AI Agent——它是企业打包、版本化和分发 AI 能力的基本载体。

核心特性：

  • 可配置：Worker 通过配置定义自身的行为、参数和依赖的 Skills
  • 可装载 Skills：Worker 可以装载一个或多个 Skills，组合出丰富的 AI 能力
  • 可版本化：支持多版本管理，每个版本独立上线/下线
  • 可分发：通过 HiMarket 门户发布，开发者可浏览、订阅和下载

Worker 在 HiMarket 中的角色：

Worker 是 HiMarket API Product 的一种产品类型。管理员创建 Worker 类型的 API Product 后，可以上传 Worker 包、管理版本，并发布到门户供开发者使用。开发者可以通过门户浏览 Worker 市场、查看详情、订阅并下载 Worker 包到本地使用。

管理员操作流程

Section titled “管理员操作流程”

创建 Worker 产品

Section titled “创建 Worker 产品”

创建 Worker 的第一步是在管理后台创建一个 Worker 类型的 API Product。

操作步骤：

  1. 登录管理后台
  2. 进入【API Products】菜单
  3. 点击【创建 API Product】按钮
  4. 填写产品信息：
    • 产品名称：例如 my-agent-worker
    • 产品类型：选择 Worker
    • 产品描述：简要描述 Worker 的功能和用途
    • 产品类别：选择或自定义类别，用于分类和筛选
    • 产品图标：选择图标，可使用 URL 链接或上传本地文件
  5. 点击【确定】

创建成功后，进入 Worker 产品详情页，初始状态为 “待配置”。

上传 Worker 包

Section titled “上传 Worker 包”

创建 Worker 产品后，需要上传一个 Worker 包（ZIP 格式），其中包含 Worker 运行所需的配置和相关文件。

操作步骤：

  1. 进入 Worker 产品详情页
  2. 点击【上传 Worker 包】按钮
  3. 选择本地的 Worker ZIP 包文件
  4. 系统自动完成上传和解析

说明：

  • Worker 包必须为 ZIP 格式
  • 上传成功后，系统会自动解析包内容，生成文件树供预览
  • 关于 Worker 包的内容要求，请参见 Worker 包格式说明

从 Nacos 批量导入 Workers

Section titled “从 Nacos 批量导入 Workers”

如果你的 Workers 已注册在 Nacos 配置中心，可以通过批量导入功能快速将它们导入 HiMarket。

前置条件：

  • 已在 HiMarket 中配置 Nacos 实例连接信息

操作步骤：

  1. 登录管理后台
  2. 进入【API Products】菜单或 Worker 管理页面
  3. 点击【从 Nacos 导入】按钮
  4. 选择目标 Nacos 实例
  5. 选择 Namespace（可选，默认为 public）
  6. 系统自动扫描并列出可导入的 Workers
  7. 确认导入

导入结果：

  • 系统会返回导入结果，包括成功数量和失败详情
  • 导入成功的 Workers 会自动创建为 Worker 类型的 API Product
  • 已存在的同名 Worker 不会重复导入

查看 Worker 文件树和文件内容

Section titled “查看 Worker 文件树和文件内容”

上传 Worker 包后，可以在管理后台查看 Worker 的文件结构和具体文件内容。

操作步骤：

  1. 进入 Worker 产品详情页
  2. 点击【文件】标签页
  3. 左侧展示 Worker 包的文件树结构
  4. 点击文件树中的文件，右侧显示文件内容
  5. 支持按版本切换，查看不同版本的文件

说明：

  • 文件树以树形结构展示 Worker 包内的所有文件和目录
  • 支持查看配置文件和文本内容
  • 可切换版本查看不同版本的文件差异

版本管理

Section titled “版本管理”

Worker 支持完整的版本生命周期管理，包括发布版本、设置最新版本、上线/下线版本和删除草稿。

操作步骤：

  1. 进入 Worker 产品详情页
  2. 点击【版本】标签页
  3. 查看当前所有版本列表

发布版本

Section titled “发布版本”
  1. 上传 Worker 包后，系统会生成一个草稿版本
  2. 在版本列表中找到草稿版本
  3. 点击【发布】按钮
  4. 填写版本号（例如 1.0.0）
  5. 确认发布

设置最新版本

Section titled “设置最新版本”
  1. 在版本列表中选择一个已上线的版本
  2. 点击【设为最新】按钮
  3. 该版本将被标记为最新版本，开发者默认下载此版本

上线/下线版本

Section titled “上线/下线版本”
  • 上线：将已发布的版本设为可用状态，开发者可以下载和使用
  • 下线：将版本设为不可用状态，开发者无法下载该版本（已下载的不受影响）

操作方式：在版本列表中点击对应版本的【上线】或【下线】按钮。

删除草稿

Section titled “删除草稿”

如果当前有未发布的草稿版本，可以删除草稿重新上传：

  1. 在版本列表中找到草稿版本
  2. 点击【删除草稿】按钮
  3. 确认删除

注意事项：

  • 已发布的版本不能删除，只能下线
  • 同一时间只能有一个草稿版本
  • 建议使用语义化版本号（如 1.0.0、1.1.0、2.0.0）

发布到门户

Section titled “发布到门户”

当 Worker 产品配置完成并有可用版本后，即可发布到门户供开发者使用。

操作步骤：

  1. 进入 Worker 产品详情页
  2. 确认产品已有至少一个上线版本
  3. 点击【发布到门户】按钮
  4. 选择目标门户：
    • 从门户列表中选择一个或多个门户
    • 可以同时发布到多个门户
  5. 点击【发布】

发布后：

  • Worker 会立即在门户的 Worker 市场中展示
  • 开发者可以浏览 Worker 详情、查看文件和版本
  • 开发者可以订阅并下载 Worker 包

开发者操作流程

Section titled “开发者操作流程”

浏览 Worker 市场

Section titled “浏览 Worker 市场”

开发者可以在门户中浏览所有已发布的 Worker 产品。

操作步骤：

  1. 登录开发者门户
  2. 进入【Worker】产品页面
  3. 浏览 Worker 列表：
    • 查看 Worker 名称、描述和版本信息
    • 使用分类筛选或搜索功能查找感兴趣的 Worker
  4. 点击 Worker 卡片查看详情

查看 Worker 详情

Section titled “查看 Worker 详情”

点击 Worker 卡片后，可以查看 Worker 的详细信息。

详情页包含：

  • 概览：Worker 的功能介绍和使用说明
  • 文件树：Worker 包的完整文件结构，可点击查看文件内容
  • 版本列表：所有可用版本，包括版本号、发布时间和状态

操作步骤：

  1. 在 Worker 详情页浏览文件树
  2. 点击文件查看具体内容
  3. 切换版本查看不同版本的文件
  4. 查看版本列表了解版本历史

订阅 Worker

Section titled “订阅 Worker”

使用 Worker 前需要先订阅。

操作步骤：

  1. 在 Worker 详情页点击【订阅】按钮
  2. 选择要使用的 Consumer（消费者）
  3. 点击【确定订阅】

说明：

  • 订阅审批策略取决于门户配置（自动审批或手动审批）
  • 订阅成功后才能下载 Worker 包
  • 可在 Consumer 详情的订阅列表中查看订阅状态

下载 Worker 包

Section titled “下载 Worker 包”

订阅成功后，可以下载 Worker 的 ZIP 包到本地。

操作步骤：

  1. 在 Worker 详情页点击【下载】按钮
  2. 选择要下载的版本（默认为最新版本）
  3. 浏览器自动下载 ZIP 包

说明：

  • 默认下载最新版本，也可以在版本列表中选择特定版本下载
  • 下载的 ZIP 包可直接解压使用

CLI 安装方式

Section titled “CLI 安装方式”

除了通过门户下载，开发者还可以使用 CLI 命令行工具安装 Worker。

操作步骤：

  1. 在 Worker 详情页点击【CLI 安装】标签
  2. 复制 CLI 安装命令
  3. 在终端中执行命令

示例命令：

Terminal window
# 安装最新版本
himarket install worker <worker-name>


# 安装指定版本
himarket install worker <worker-name> --version 1.0.0

说明：

  • CLI 工具需要预先配置 HiMarket 服务地址和认证信息
  • 安装命令会自动下载并解压 Worker 包到指定目录

Worker 包格式说明

Section titled “Worker 包格式说明”

Worker 包是一个标准的 ZIP 压缩文件，包含 Worker 运行所需的配置和相关文件。

包内容要求：

  • 必须包含一个主配置文件，用于定义 Worker 的名称、版本和依赖的 Skills
  • 建议包含一份说明文档，帮助使用者快速了解 Worker 的功能和用法
  • 可以包含内置的 Skills 目录和额外的配置文件
  • ZIP 包大小建议不超过 50MB

注意事项：

  • 上传后系统会自动解析文件树，确保目录结构清晰
  • 建议在包内附带说明文档，方便其他用户理解和使用

至此，你已了解 HiMarket Worker 的完整管理和使用流程！无论是管理员发布 Worker 还是开发者使用 Worker，HiMarket 都提供了便捷的操作体验。