huawei-cloud-agentorchard-find-skills

概述

此技能可帮助 Agent 高效地从 AI Gallery 搜索、发现和安装技能。只需输入自然语言，Agent 就会自动理解意图并执行搜索，以自然语言返回结果。

使用场景

此技能可帮助 Agent：

• 搜索技能 — 按关键词查找技能
• 查看技能详情 — 跳转至 AI Gallery 详情页，查看完整文档
• 订阅技能 — 通过 AI Gallery 订阅页面完成技能安装

使用示例

• "帮我找一个图像分类的 skill"
• "AI Gallery 有哪些 NLP 相关的skill？"
• "有没有数据预处理的 skill？"
• "浏览所有可用的 AI Gallery skill"
• "找一个文本生成的 skill"

前提条件

• Agent 运行环境需要 Python 3.6+（脚本执行环境）
• 可访问网络，以访问 AI Gallery API（devdata.huaweicloud.com）
• 无需身份验证 — API 是公开且只读的

工作流

步骤 1：执行搜索脚本

根据用户输入运行搜索脚本（仅执行一次）：

PYTHONIOENCODING=utf-8 python scripts/search_skills.py -k "<user input>"

重要

Agent 必须遵守以下规则：

1. 仅执行一次 — 不得重复运行或重试
2. 直接输出脚本结果 — 不得添加额外说明、中间消息或摘要
3. 不得执行额外操作 — 原样显示脚本输出
4. 使用 UTF-8 编码 — 运行脚本时必须设置 PYTHONIOENCODING=utf-8
5. 不得直接调用 API — 必须使用脚本；不得绕过脚本直接调用 API

脚本会自动处理所有场景：

用户输入类型	脚本输出
浏览意图（例如，“有什么skill”）	热门技能 + 指引
搜索意图（例如，“银行”）	匹配的技能列表
无搜索结果（例如，乱码）	指引

Agent 只需将脚本输出直接展示给用户，不得添加任何额外操作。

步骤 2：查看详情并订阅（可选）

用户选择技能后，引导其访问详情页并订阅。

规则：

• 仅当搜索结果中包含特定的 show_id 时，才显示详情页 URL
• 格式：详情页：https://pangu.huaweicloud.com/gallery/asset-detail.html?id={show_id}
• 不要向用户显示 URL 模板或类似 ?id={show_id} 的占位符格式

用户点击详情页上的“Subscribe”按钮即可完成安装。

核心命令

命令	用途
PYTHONIOENCODING=utf-8 python scripts/search_skills.py -k "<keyword>"	按关键词搜索技能

参数说明

参数	必填	描述	示例
-k, --keyword	否	搜索关键词，支持用空格、逗号或分号分隔	-k "银行"
--api-base	否	AI Gallery API 基础 URL（有默认值）	--api-base "https://..."

参考文档

• references/cli-installation-guide.md — 环境设置和前提条件
• references/iam-policies.md — IAM 策略说明（公开 API，无需凭据）
• references/verification-method.md — 功能验证方法
• references/acceptance-criteria.md — 验收标准和检查清单
• references/dataflow-diagram.md — 数据流图