SkillNet

环境要求

• 已安装 Python 环境并可用 pip
• 可访问 GitHub（用于下载公开技能）
• 如需 create/evaluate/analyze/orchestrate，需准备 OpenAI 兼容端点的 API Key
• 如需私有仓库下载或提高 GitHub 速率限制，可准备 GITHUB_TOKEN

安装与启动步骤

1. 1安装 SDK 与 CLI

   通过 pip 从 PyPI 安装 skillnet-ai，安装后同时获得 Python SDK 和命令行工具 skillnet。

   pip install skillnet-ai

   复制

2. 2安装可选扩展

   按需安装图分析或编排能力：graph 用于场景级图谱分析，orchestrate 用于场景编排；不需要可跳过。

   pip install "skillnet-ai[graph]"
   pip install "skillnet-ai[orchestrate]"

   复制

3. 3配置环境变量(Linux/macOS)

   仅在需要 create、evaluate、analyze、orchestrate 时配置；search 与公开 GitHub 下载无需任何凭据。变量只对当前终端会话生效。

   export API_KEY="sk-xxxxxxxx"
   export BASE_URL="https://api.openai.com/v1"
   export SKILLNET_MODEL="gpt-4o"

   复制

4. 4配置环境变量(Windows)

   Windows PowerShell 下的等价写法，同样只对当前会话生效；BASE_URL 需为兼容端点地址。

   $env:API_KEY = "sk-xxxxxxxx"
   $env:BASE_URL = "https://api.openai.com/v1"
   $env:SKILLNET_MODEL = "gpt-4o"

   复制

5. 5搜索技能

   用关键词检索公开技能库，limit 控制返回条数；也可用 Python SDK 的 SkillNetClient().search 调用。无需 API Key。

   skillnet search "pdf understanding" --limit 5

   复制

6. 6下载技能到本地

   把搜索结果中的 skill_url 下载到指定目录，技能会以文件夹形式进入本地工作区，便于被智能体直接调用。

   skillnet download <skill_url> -d ./my_skills

   复制

7. 7在代码中调用 SDK

   如需在 Python 程序中集成，可导入 SkillNetClient 完成搜索与下载，打印技能名与地址确认结果。

   from skillnet_ai import SkillNetClient
   
   client = SkillNetClient()
   
   results = client.search("pdf understanding", limit=5)
   print(results[0].skill_name)
   print(results[0].skill_url)
   
   client.download(results[0].skill_url, target_dir="./my_skills")

   复制

关键配置

如何确认成功

执行 skillnet search "pdf understanding" --limit 5 能返回技能列表，或 Python 中打印出 results[0].skill_name 即成功。

常见问题

注意事项

• export 与 $env: 设置的环境变量只在当前终端会话有效，重开终端需重新配置。
• README 未给出 Python 最低版本要求，建议使用较新的 Python 3 环境。
• 命令行中的 <skill_url> 是占位符，需替换为搜索结果里实际返回的 skill_url。
• 项目官网为 http://skillnet.openkg.cn，可在线浏览公开技能库。