吉客云 AI Skill - 智能体集成工具

🔌

支持龙虾、Hermes、悟空等主流 AI Agent，一条命令安装，即装即用，无需编写代码。

🛡️

内置吉客云开放平台签名算法，AI 无需关心认证细节，专注理解用户意图。

📋

涵盖订单履约、库存调拨、采购质检、售后处理、经营分析等全部业务域。

🌐

CLI 工具支持 Windows / macOS / Linux，二进制单文件下载，无外部依赖。

⚡ 快速开始

三步让 AI 替你操作 ERP

安装 Skill 把 Skill 地址告诉你的 AI Agent，或执行安装命令。Agent 会自动下载并配置 CLI 工具。

配置凭证 AI 会引导你运行 jky-cli configure，输入 AppKey 和 AppSecret，凭证安全存入系统密钥环。

开始对话 用自然语言告诉 AI 你要做什么，AI 自动调接口，返回结果。

选择适合你的方式安装吉客云 AI Skill

将以下地址告诉你的 AI Agent（龙虾、Hermes、悟空等），它会自动完成安装和初始化：

https://gitee.com/jackyun_liuyi/jky-cli-skill.git

在终端中执行以下命令：

npx skills install https://gitee.com/jackyun_liuyi/jky-cli-skill.git

Skill 会自动处理以下事项，你无需手动干预

CLI 检查 检测系统是否已安装 jky-cli

自动下载 未安装则从吉客云官网下载对应平台版本

凭证配置 引导运行 configure 交互式输入凭证

接口发现 通过 docs list 获取所有可用接口

执行请求 调用 api call 发起带签名请求

Skill 内置完整接口文档查询能力，AI 无需访问外部网站：

# 获取所有可用接口方法索引
jky-cli docs list

# 获取指定接口的详细定义（参数、必填项、示例）
jky-cli docs get --method erp-goods.goods.getforqimen

用户意图	AI 执行命令
查商品编码为 100 的商品	`jky-cli goods search --goodsno 100`
查销售部的部门信息	`jky-cli depart search --name 销售部`
通用接口调用	`jky-cli api call --method 接口名 --json '{...}'`
复杂参数（文件方式）	`jky-cli api call --method 接口名 --file params.json`

Q1: Skill 安装后需要做什么？

AI Agent 会自动检查 CLI 工具是否已安装，未安装会引导下载。之后运行 jky-cli configure 配置 AppKey/AppSecret 即可开始使用。

Q2: 调用接口返回签名错误？

请检查系统时间是否准确，以及 AppKey/Secret 是否与开放平台控制台保持一致。CLI 工具完全兼容吉客云官方 MD5 签名规则。

Q3: 支持哪些 AI Agent？

支持所有兼容 Skill 标准的 AI Agent，包括龙虾、Hermes、悟空等主流产品。

Q4: 支持哪些操作系统？

CLI 工具支持 Windows 7+ (amd64)、macOS 11+ (Intel / Apple Silicon)、Linux 主流发行版 (amd64)。

Q5: 接口文档如何获取？

CLI 内置 jky-cli docs list 和 jky-cli docs get 命令，Agent 离线即可查询所有接口信息。也可访问吉客云开放平台 API 文档。