カスタム スクリプトとストア エージェント

ストアフロント JavaScriptを追加し、1つのストア プロジェクトで利用可能なスキルを選択します。

カスタム スクリプトはストアフロント動作を変更し、ストア エージェントは現在のプロジェクトでRunnerが使用できるスキルを変更します。どちらもストア固有の設定であり、特に注意深く確認する必要があります。

このガイドの内容

スクリプトを追加して保存する方法、削除せずに一時停止する方法、現在のプロジェクトのみのスキルを追加または無効にする方法を理解します。

利用可能性と前提条件

• 目的のプロジェクト内から設定を開きます。
• カスタム JavaScriptはストアフロント動作を変更できます。理解して信頼できるコードのみを追加してください。
• スキル アクションは、利用可能なワークスペース スキルと、システム スキルが構成可能かどうかに依存します。
• 完全なエージェント ページとプラン ゲートは、より広いスキル利用可能性を制御します。

エントリパス

• スクリプト: アバター → 設定 → ストア → カスタム スクリプト
• プロジェクト スキル: アバター → 設定 → ストア → エージェント

カスタム スクリプト コントロール

Runnerは最大10個のスクリプト エントリを許可します。何も変更されていない場合、変更を保存ボタンは無効のままです。

スクリプトを追加または変更

1. ストア → カスタム スクリプト を開きます。
2. スクリプトを追加 を選択します。
3. 明確な スクリプト名 と信頼できる JavaScriptコード を入力します。
4. スクリプトがストアフロントで実行される場合のみ、有効なままにします。
5. 変更を保存 が全リストを適用するため、他のすべての行を確認します。
6. 変更を保存 を選択し、保存されました を待ちます。
7. 保存後、ストアフロントを安全に確認します。

Runnerは1つのスクリプト エラーがページをクラッシュさせるのを防止しようとしますが、それは未知のコードを安全にしません。スクリプトはプライバシー、パフォーマンス、トラッキング、カスタマー エクスペリエンスに影響を与える可能性があります。

ストア エージェント コントロール

プロジェクト スキルを構成

1. ストア → エージェント を開きます。
2. 現在アクティブなスキルを確認します。
3. スキルを追加 を選択してから、利用可能なスキルを選択するか、カスタム スキルを作成… を選択します。
4. 成功メッセージを待ち、スキルが表示されることを確認します。
5. 構成可能なスキルがこのプロジェクトに適用されなくなった場合は、無効にする を使用します。
6. コントロール センター → エージェント を開いて、完全なスキル詳細、一時停止、編集、インポート、または削除アクションを実行します。

状態と制限

• スクリプト変更は 変更を保存 が成功するまでローカルのままです。
• スクリプト行を削除する場合、変更を保存する前に個別の確認はありません。
• 10個のスクリプトに達すると、スクリプトを追加 が無効になります。
• ストア エージェントは読み込み、エラー、スキルが有効になっていません、またはアクティブ リストを表示できます。
• 固定システム スキルは 無効にする を表示しません。
• ストア エージェントで無効にすると、このプロジェクトのスコープが変更されます。スキルは削除またはグローバルに一時停止されません。

トラブルシューティング

• スクリプトがまだ実行されている場合は、その無効な状態の後に 変更を保存 が続いたことを確認します。
• 保存が失敗した場合、以前に保存されたリストは変更されません。コードを修正するか、エラー後に再試行してください。
• スキルを追加 に予期されたエントリがない場合は、完全なエージェント ページと現在のプランを確認してください。
• 無効にする がない場合、システム スキルはこのプロジェクトで構成可能ではありません。
• 新しいスキルがグローバルに表示されるがここに表示されない場合は、ストア エージェントからプロジェクトに追加してください。

関連ガイド

• ストア一般
• エージェント スキル
• スキルを作成、インポート、管理
• APIキー安全性