カスタム スクリプトとストア エージェント
ストアフロント JavaScriptを追加し、1つのストア プロジェクトで利用可能なスキルを選択します。
カスタム スクリプトはストアフロント動作を変更し、ストア エージェントは現在のプロジェクトでRunnerが使用できるスキルを変更します。どちらもストア固有の設定であり、特に注意深く確認する必要があります。
このガイドの内容
スクリプトを追加して保存する方法、削除せずに一時停止する方法、現在のプロジェクトのみのスキルを追加または無効にする方法を理解します。
利用可能性と前提条件
- 目的のプロジェクト内から設定を開きます。
- カスタム JavaScriptはストアフロント動作を変更できます。理解して信頼できるコードのみを追加してください。
- スキル アクションは、利用可能なワークスペース スキルと、システム スキルが構成可能かどうかに依存します。
- 完全なエージェント ページとプラン ゲートは、より広いスキル利用可能性を制御します。
エントリパス
- スクリプト: 設定 → ストア: ストア名 → カスタムスクリプト
- プロジェクトのスキル: 設定 → ストア: ストア名 → エージェント
カスタム スクリプト コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
|---|---|---|
| スクリプトを追加 | ストアフロント スクリプト エントリを作成します。 | 新しい有効なスクリプト行が空のJavaScript コードで開きます。 |
| スクリプト行 | エディターを展開または折りたたみます。 | スクリプト名 と JavaScriptコード が表示されます。 |
| 目のアイコン / 非表示目のアイコン | 1つのスクリプトを有効または無効にします。 | ローカル行が状態を変更します。変更を保存を選択して適用します。 |
| 削除アイコン | スクリプトを保留中リストから削除します。 | 行は2番目のダイアログなしで消えます。変更を保存が削除を適用します。 |
| 変更を保存 | すべての保留中のスクリプト編集を適用します。 | Runnerはスクリプト リスト全体を保存し、成功またはエラー メッセージを表示します。 |
Runnerは最大10個のスクリプト エントリを許可します。何も変更されていない場合、変更を保存ボタンは無効のままです。
空のエディターで、導入前に入力欄を確認できます。この例では追跡スクリプトを保存していません。画像は英語の画面です。
スクリプトを追加または変更
- ストア → カスタム スクリプト を開きます。
- スクリプトを追加 を選択します。
- 明確な スクリプト名 と信頼できる JavaScriptコード を入力します。
- スクリプトがストアフロントで実行される場合のみ、有効なままにします。
- 変更を保存 が全リストを適用するため、他のすべての行を確認します。
- 変更を保存 を選択し、保存されました を待ちます。
- 保存後、ストアフロントを安全に確認します。
Runnerは1つのスクリプト エラーがページをクラッシュさせるのを防止しようとしますが、それは未知のコードを安全にしません。スクリプトはプライバシー、パフォーマンス、トラッキング、カスタマー エクスペリエンスに影響を与える可能性があります。
まずスクリプトの下書きを確認する
スクリプトを追加を選択し、名前を Store analytics にして、目のアイコンをオフにします。コードは空のままにし、変更を保存は選択しません。信頼できる提供元のコードを追加する前に、エディターと無効状態を確認できます。実際に保存した後は、一覧を開き直してコードと有効状態の両方を確認してください。
英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。
プロジェクトのスキルには、ストア見出し下のエージェントを選択します。画像は英語の入口画面であり、スキルの追加や無効化を示していません。
ストア エージェント コントロール
| エントリまたはボタン | 有用な理由 | 次に何が起こるか |
|---|---|---|
| アクティブ スキル行 | このプロジェクトで利用可能なスキルを確認します。 | 行は名前、説明、システムまたはカスタム タイプを表示します。 |
| 無効にする | 構成可能なスキルをこのプロジェクトのみから削除します。 | スキルはこのプロジェクトのアクティブ リストから削除されます。グローバルに削除されません。 |
| スキルを追加 | 利用可能なワークスペース スキルをこのプロジェクトに追加します。 | リストされたスキルを選択するか、カスタム スキルを作成… を選択して、現在のプロジェクトで有効にします。 |
| カスタム スキルを作成… | 新しいカスタム機能を作成します。 | スキル エディターが開き、成功後にプロジェクト リストが更新されます。 |
プロジェクト スキルを構成
- ストア → エージェント を開きます。
- 現在アクティブなスキルを確認します。
- スキルを追加 を選択してから、利用可能なスキルを選択するか、カスタム スキルを作成… を選択します。
- 成功メッセージを待ち、スキルが表示されることを確認します。
- 構成可能なスキルがこのプロジェクトに適用されなくなった場合は、無効にする を使用します。
- プロジェクトのナビゲーションでエージェントを開くと、スキルの詳細、一時停止、編集、インポート、削除を操作できます。
状態と制限
- スクリプト変更は 変更を保存 が成功するまでローカルのままです。
- スクリプト行を削除する場合、変更を保存する前に個別の確認はありません。
- 10個のスクリプトに達すると、スクリプトを追加 が無効になります。
- ストア エージェントは読み込み、エラー、スキルが有効になっていません、またはアクティブ リストを表示できます。
- 固定システム スキルは 無効にする を表示しません。
- ストア エージェントで無効にすると、このプロジェクトのスコープが変更されます。スキルは削除またはグローバルに一時停止されません。
トラブルシューティング
- スクリプトがまだ実行されている場合は、その無効な状態の後に 変更を保存 が続いたことを確認します。
- 保存が失敗した場合、以前に保存されたリストは変更されません。コードを修正するか、エラー後に再試行してください。
- スキルを追加 に予期されたエントリがない場合は、完全なエージェント ページと現在のプランを確認してください。
- 無効にする がない場合、システム スキルはこのプロジェクトで構成可能ではありません。
- 新しいスキルがグローバルに表示されるがここに表示されない場合は、ストア エージェントからプロジェクトに追加してください。