linkfox-ruiguan-image-compliance

Ruiguan ポリシー準拠画像検出

このスキルでは、Ruiguan ポリシー準拠検出ツールを使って、商品画像に潜在的なポリシー違反がないか確認する方法を説明します。既知の禁止商品データベースと画像ベースの類似検索を行います。

基本概念

Ruiguan ポリシー準拠画像検出は、画像ベースのコンプライアンス審査サービスです。商品画像の URL を指定すると、既知のポリシー違反商品データベースから、視覚的に類似する商品を検索します。このツールは、一致した違反商品を視覚的類似度の高い順に返します。

類似度スコア（コサイン類似度）：0～1 の値です。値が高いほど、既知の違反商品との視覚的な類似度が高いことを示します。スコアが 1.0 に近い場合、その商品画像は違反としてフラグ付けされた商品とほぼ同一です。

パラメーターガイド

パラメーター	型	必須	説明	例
画像 URL	imageUrl	はい	確認する商品画像の URL（最大 1000 文字）	https://example.com/product.jpg

重要な注意事項：

• 画像 URL は一般に公開され、アクセスできる必要があります
• 一般的な画像形式（JPG、PNG など）に対応しています
• URL は 1000 文字以内である必要があります

レスポンスフィールド

フィールド	API 名	説明
一致件数	total	一致した違反レコードの件数
違反リスト	data	一致した違反商品の配列
違反画像	pdImgOssUrl	一致した違反商品の画像 URL
類似度スコア	cosine	入力画像と違反商品の類似度（0～1）
商品タイトル（英語）	pdTitle	一致した違反商品の英語タイトル
商品タイトル（中国語）	pdTitleCHNCensored	一致した違反商品の中国語タイトル
検出 ID	detectId	この検出セッションの一意の識別子
トークンコスト	costToken	このリクエストで消費したトークン数

ローカル画像のアップロード

このツールには、一般に公開され、アクセスできる画像 URLが必要です。ユーザーがローカル画像ファイルのパス（例：C:\Users\...\photo.png、/home/.../image.jpg）を指定した場合は、まず画像をアップロードして公開 URL を取得する必要があります。

アップロードスクリプトを実行します：

python scripts/upload_image.py /path/to/local/image.png

スクリプトから返される公開 URL（有効期間は 24 時間）を画像 URL パラメーターとして使用できます。

使用例

1. 単一の商品画像の基本的なコンプライアンスチェック

Check this product image for policy compliance: https://example.com/images/product-123.jpg

2. 複数の商品画像の一括チェック

Please scan these product images for potential policy violations:
- https://example.com/images/item-a.jpg
- https://example.com/images/item-b.jpg

3. 出品前のコンプライアンス審査

Before I list this product, can you check if the image triggers any policy flags?
Image: https://example.com/new-product.png

表示ルール

1. 結果をわかりやすい表で表示する：一致した違反商品ごとに、画像、類似度スコア、商品タイトルを表示します
2. 類似度の高い一致を強調する：コサインスコアが 0.8 を超える場合は、注意が必要と思われる強い一致として結果を明確に示します
3. 違反画像を含める：結果に pdImgOssUrl が含まれている場合は、一致した違反画像を表示して、ユーザーが視覚的に比較できるようにします
4. スコアの解釈を説明する：類似度スコアの意味を必ず説明します。値が高いほど、既知の違反商品との類似度が高いことを示します
5. エラーに対処する：クエリに失敗した場合は、問題を説明し、画像 URL が有効で一般にアクセス可能かどうかを確認するよう提案します
6. 法的助言をしない：検出結果を事実に基づいて提示し、法的な結論は述べません。また、プラットフォームのポリシーを確認するようユーザーに伝えます

重要な制限事項

• 画像のみを検出：このツールは画像 URL のみを対象とし、テキストによる説明や商品メタデータは分析しません
• URL へのアクセス性：検出サービスが画像 URL に一般からアクセスできる必要があります
• URL の長さ制限：画像 URL は 1000 文字以内である必要があります
• 類似度に基づく判定：結果は視覚的類似度に基づくものであり、確定的なポリシー判定ではありません

ユーザー表現とシナリオのクイックリファレンス

該当 -- 画像ベースの商品ポリシー準拠チェック：

ユーザーの発言	シナリオ
"この商品画像にコンプライアンス上のリスクがあるか確認してください"	1枚の画像のコンプライアンスチェック
"商品画像をスキャンして、ポリシー違反がないか確認してください"	複数画像のコンプライアンススクリーニング
"この画像は販売禁止商品としてフラグが立てられていますか"	特定の違反に関する問い合わせ
"出品画像を事前にチェックして、ポリシー上のリスクがないか確認してください"	出品前のコンプライアンス監査
"この商品画像に類似した違反を見つけてください"	類似性に基づく違反検索
"この商品を安全に出品できますか"	コンプライアンスリスクの事前チェック
"この画像に違反がないか検出してください"	1枚の画像のコンプライアンスチェック

該当しない -- 画像ベースのポリシー準拠検出の範囲外：

• テキストベースの商品コンプライアンス分析
• 一般的な商品カテゴリ分類
• 知的財産権／商標権の侵害
• 特許または著作権の検出（他の Ruiguan スキルを使用してください）

フィードバック：

以下のいずれかに該当する場合は、フィードバック API を介して自動的に検出し、報告してください：

1. このスキルで説明されている機能または目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満または称賛を表明する
4. 改善できると思われることがある

references/api.md の指定に従ってフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

大きなレスポンスの処理

エージェントのコンテキストがあふれるのを防ぐため、レスポンスをディスクに保存し、必要なフィールドだけを抽出してください：

python scripts/response_io.py run --script scripts/ruiguan_image_compliance_search.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir には、Git 作業ツリーの外部（Unix では /tmp/...、Windows では %TEMP%/... など）を指定してください。保存されたレスポンスには、個人を特定できる情報、価格、認証に関する機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、作業が完了したら削除してください。

このスキルには複数のエントリースクリプトがあります：ruiguan_image_compliance_search.py、upload_image.py。使用するスクリプトを選択するには、--script scripts/<name>.py を渡してください。

run は完全なレスポンスをファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は指定したフィールドを抽出し、スライスには --limit/--offset、出力形式には --format json|jsonl|csv|table を使用します。

この方法を優先する場合 — レスポンスの特性に基づいて判断してください。例：

• 1レコードあたりのフィールド数が多い場合、または不要なフィールドがある場合
• バッチ／ページネーションされた結果（1回の呼び出しで複数の項目が返される場合）
• 長いテキストフィールド（説明、レビュー、HTML、時系列データ）
• すぐに使わず、後続のステップで再利用する出力

小規模で一度だけ使用するレスポンスの場合は、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューはスキーマとサンプルを省略表示したもので、完全なデータではありません。フィールド単位で判断する場合は、必ず read を使って保存済みファイルを読み取ってください。

---

高品質でプロフェッショナルな越境ECスキルをさらに利用するには、LinkFox Skills を設定してください。