huawei-cloud-agentorchard-find-skills

概要

このスキルを使うと、AI Gallery からスキルを効率的に検索、発見、インストールできます。自然言語で入力するだけで、エージェントが意図を自動的に理解して検索を実行し、結果を自然言語で返します。

シナリオ

このスキルを使うと、エージェントは次の操作を行えます。

• スキルを検索 — キーワードでスキルを見つけます
• スキルの詳細を表示 — AI Gallery の詳細ページに移動して、ドキュメント全体を確認します
• スキルをサブスクライブ — AI Gallery のサブスクリプションページからスキルのインストールを完了します

使用例

• 「画像分類のスキルを探してください」
• 「AI Gallery には NLP 関連のスキルがどれくらいありますか？」
• 「データ前処理のスキルはありますか？」
• 「AI Gallery で利用可能なすべてのスキルを表示してください」
• 「テキスト生成のスキルを探してください」

前提条件

• エージェントのランタイムに Python 3.6 以降が必要です（スクリプト実行環境）
• AI Gallery API（devdata.huaweicloud.com）へのネットワークアクセス
• 認証は不要です — API は公開されており、読み取り専用です

ワークフロー

ステップ 1：検索スクリプトを実行する

ユーザーの入力に基づいて、検索スクリプトを実行します（実行は 1 回のみ）。

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

重要

エージェントは次のルールに従う必要があります。

1. 実行は 1 回のみ — 繰り返し実行や再試行はしないでください
2. スクリプトの結果をそのまま出力する — 説明、中間メッセージ、要約を追加しないでください
3. 余分な操作をしない — スクリプトが出力した内容をそのまま表示してください
4. UTF-8 エンコーディングを使用する — スクリプトの実行時に PYTHONIOENCODING=utf-8 を設定する必要があります
5. API を直接呼び出さない — スクリプトを使用し、API を直接呼び出して回避しないでください

スクリプトは、すべてのシナリオを自動的に処理します。

ユーザー入力の種類	スクリプトの出力
閲覧の意図（例：「どんなスキルがありますか」）	人気のスキルとガイダンス
検索の意図（例：「銀行」）	該当するスキルの一覧
結果なし（例：意味のない文字列）	ガイダンス

エージェントは、追加の操作をせずにスクリプトの出力をそのままユーザーに表示するだけです。

ステップ 2：詳細の表示とサブスクライブ（任意）

ユーザーがスキルを選択したら、詳細ページにアクセスしてサブスクライブするよう案内します。

ルール：

• 検索結果から特定の show_id が取得できる場合に限り、詳細ページの URL を表示します
• 形式：详情页：https://pangu.huaweicloud.com/gallery/asset-detail.html?id={show_id}
• ?id={show_id} のような URL テンプレートやプレースホルダー形式をユーザーに表示しないでください

ユーザーは詳細ページの「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 — データフロー図