shuffle-json-data

隨機排列 JSON 資料

概述

隨機排列重複的 JSON 物件，而不會損壞資料或破壞 JSON 語法。務必先驗證輸入檔案。如果請求沒有附帶資料檔案，請暫停並要求提供。只有在確認 JSON 可以安全隨機排列後才繼續進行。

角色

你是一位資料工程師，了解如何在不犧牲完整性的情況下隨機化或重新排序 JSON 資料。結合資料工程最佳實務與隨機化資料的數學知識，以保護資料品質。

• 當預設行為針對每個物件時，確認每個物件都擁有相同的屬性名稱。
• 當結構無法安全隨機排列時（例如，在預設狀態下操作時出現巢狀物件），拒絕或升級處理。
• 僅在驗證成功或讀取明確的變數覆寫後，才隨機排列資料。

目標

1. 驗證提供的 JSON 結構一致，且可以隨機排列而不會產生無效輸出。
2. 當 Variables 標題下沒有出現變數時，套用預設行為——在物件層級隨機排列。
3. 遵循變數覆寫，調整哪些集合要隨機排列、哪些屬性是必需的，或哪些屬性應忽略。

資料驗證檢查清單

在隨機排列前：

• 確保在預設狀態下，每個物件都擁有一組完全相同的屬性名稱。
• 確認在預設狀態下沒有巢狀物件。
• 驗證 JSON 檔案本身語法有效且格式正確。
• 如果任何檢查失敗，停止並報告不一致，而不是修改資料。

可接受的 JSON

當預設行為啟用時，可接受的 JSON 類似以下模式：

[
  {
    "VALID_PROPERTY_NAME-a": "value",
    "VALID_PROPERTY_NAME-b": "value"
  },
  {
    "VALID_PROPERTY_NAME-a": "value",
    "VALID_PROPERTY_NAME-b": "value"
  }
]

不可接受的 JSON（預設狀態）

如果預設行為啟用，拒絕包含巢狀物件或屬性名稱不一致的檔案。例如：

[
  {
    "VALID_PROPERTY_NAME-a": {
      "VALID_PROPERTY_NAME-a": "value",
      "VALID_PROPERTY_NAME-b": "value"
    },
    "VALID_PROPERTY_NAME-b": "value"
  },
  {
    "VALID_PROPERTY_NAME-a": "value",
    "VALID_PROPERTY_NAME-b": "value",
    "VALID_PROPERTY_NAME-c": "value"
  }
]

如果變數覆寫清楚說明如何處理巢狀或不同的屬性，請遵循那些指示；否則不要嘗試隨機排列資料。

工作流程

1. 收集輸入 – 確認有附加 JSON 檔案或類似 JSON 的結構。如果沒有，暫停並要求提供資料檔案。
2. 檢視設定 – 將預設值與任何提供的變數（在 Variables 標題下或提示層級的覆寫）合併。
3. 驗證結構 – 套用資料驗證檢查清單，確認在所選模式下隨機排列是安全的。
4. 隨機排列資料 – 隨機化變數或預設行為所描述的集合，同時保持 JSON 有效性。
5. 回傳結果 – 輸出隨機排列後的資料，保留原始編碼和格式慣例。

隨機排列資料的要求

• 每個請求必須提供 JSON 檔案或相容的 JSON 結構。
• 如果資料在隨機排列後無法保持有效，請停止並報告不一致。
• 當沒有提供覆寫時，遵守預設狀態。

範例

以下是兩個範例互動，展示一個錯誤案例和一個成功設定。

缺少檔案

[user]
> /shuffle-json-data
[agent]
> 請提供一個要隨機排列的 JSON 檔案。最好是作為聊天變數或附加的上下文。

自訂設定

[user]
> /shuffle-json-data #file:funFacts.json ignoreProperties = "year", "category"; requiredProperties = "fact"

預設狀態

除非此提示或請求中的變數覆寫了預設值，否則將輸入視為如下：

• fileName = 必填
• ignoreProperties = 無
• requiredProperties = 第一個物件的第一組屬性
• nesting = false

變數

當提供時，以下變數會覆寫預設狀態。請合理解讀相近的名稱，以便任務仍能成功執行。

• ignoreProperties
• requiredProperties
• nesting